{"id":18265126,"url":"https://github.com/nasa-ammos/aerie-multimission-models-bb","last_synced_at":"2025-07-06T11:34:22.694Z","repository":{"id":250062140,"uuid":"764464560","full_name":"NASA-AMMOS/aerie-multimission-models-bb","owner":"NASA-AMMOS","description":"Multi-mission models for different spacecraft subsystems to be run in Aerie derived from models built for the Blackbird planner","archived":false,"fork":false,"pushed_at":"2025-04-06T23:59:25.000Z","size":11000,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-04-07T00:25:56.308Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NASA-AMMOS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-28T05:51:40.000Z","updated_at":"2025-04-01T16:58:47.000Z","dependencies_parsed_at":"2024-08-22T20:27:18.596Z","dependency_job_id":"3472e325-d621-40f6-b22f-34aa12999c04","html_url":"https://github.com/NASA-AMMOS/aerie-multimission-models-bb","commit_stats":null,"previous_names":["nasa-ammos/aerie-multimission-models-bb"],"tags_count":0,"template":false,"template_full_name":"NASA-AMMOS/aerie-mission-model-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Faerie-multimission-models-bb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Faerie-multimission-models-bb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Faerie-multimission-models-bb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NASA-AMMOS%2Faerie-multimission-models-bb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NASA-AMMOS","download_url":"https://codeload.github.com/NASA-AMMOS/aerie-multimission-models-bb/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247958710,"owners_count":21024821,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T11:17:09.848Z","updated_at":"2025-04-09T01:42:40.663Z","avatar_url":"https://github.com/NASA-AMMOS.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aerie Multi-Mission Models - Blackbird\n\nThis repository houses a collection of spacecraft subsystem models that can be configured, customized, and then run\nwithin Aerie by a mission. By combining these models together with other models, such as the\n[Aerie Simple Power Model](https://github.com/NASA-AMMOS/aerie-simple-model-power) and [Aerie Simple Data Model](https://github.com/NASA-AMMOS/aerie-simple-model-data),\na mission can build up an integrated spacecraft model quickly to perform mission trades and analyses.\n\nThe models in this\nrepository were originally derived from models created for the Blackbird planner, a java-based planning system developed\nat NASA's Jet Propulsion Lab (JPL). There is also code included here for you to export and translate model data to the\nfree 3D visualization software [Cosmographia](https://cosmoguide.org/).\n\nThe following models are included in this repository:\n- Geometry\n- DSN (in work)\n- Guidance Navigation and Control (in work)\n\nBelow you'll find short descriptions of each model and brief instructions on how to configure and run them. For general\ninstructions on how to compile models, see the instructions in the README of [mission model template repo](https://github.com/NASA-AMMOS/aerie-mission-model-template?tab=readme-ov-file#aerie-mission-model-template).\nIf you'd like to learn how to write Aerie models, please see our [modeling tutorial](https://nasa-ammos.github.io/aerie-docs/tutorials/mission-modeling/introduction/).\n\n## Geometry Model\n\nThe geometry model provides an easy way for you to compute geometric quantities based on [SPICE kernel data](https://naif.jpl.nasa.gov/naif/data.html)\nbased on your spacecraft's trajectory. Example quantities that the model can compute include spacecraft to body distance and speed,\nsub-spacecraft illumination angles, Sun-body-spacecraft angle, orbit period and inclination, body half-angle size, and more!\nThere are also some \"spawner\" activities within the model that will schedule activities to represent spacecraft eclipses,\noccultations, and periapsis and apoapsis times.\n\nSince the geometry model requires SPICE data to work, you'll need to include kernels for your spacecraft trajectory and\nany other bodies to which you are computing relative geometry. There are some [example kernels](spice/kernels) included\nin this repository for the Mars Reconnaissance Orbiter (MRO) mission you can use to try out the model. When you are ready to use your own kernels,\nyou will want to update the [latest_meta_kernel.tm](spice/kernels/latest_meta_kernel.tm) file to point to your kernels.\n\nNote: In order for Aerie to read SPICE files, you must mount a folder on your filesystem so that it’s shared with the\nDocker containers in which Aerie runs. The [`docker-compose.yml`]() file in this repo already does this for you, so if you\nstart Aerie from that file and store your kernels in the [spice/kernels](spice/kernels) directory, you shouldn't have\nto do anything special.\n\nBodies and geometric quantities you want to calculate are all configured in the [`default_geometry_config.json`](src/main/resources/missionmodel/default_geometry_config.json),\nwhich gets bundled into the mission model jar when you compile the model.\n\nFinally, in order to point the model to the right spacecraft to compute geometry against, you need to tell the model the\nSPICE ID of that spacecraft. You can do that by changing the value of SPICE_SCID within the [Mission](src/main/java/missionmodel/Mission.java) class. \n\n## Acknowledgements\n\nA special thanks to Chris Lawler and Flora Ridenhour, the original developers of the Blackbird planner, who have graciously provided the Blackbird multi-mission models to the Aerie team as a starting point for the models in this repository.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasa-ammos%2Faerie-multimission-models-bb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnasa-ammos%2Faerie-multimission-models-bb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasa-ammos%2Faerie-multimission-models-bb/lists"}