https://github.com/aaronjs99/macro
[ICC '21] MACRO: Megastructure Assembly via Collaborative Robots in Orbits
https://github.com/aaronjs99/macro
aerospace autonomous-systems control-systems distributed-algorithms multi-agent-systems optimal-control orbital-mechanics python spacecraft-formation telescope-assembly
Last synced: about 1 month ago
JSON representation
[ICC '21] MACRO: Megastructure Assembly via Collaborative Robots in Orbits
- Host: GitHub
- URL: https://github.com/aaronjs99/macro
- Owner: aaronjs99
- License: gpl-2.0
- Created: 2021-06-09T15:33:50.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-07-03T23:41:07.000Z (11 months ago)
- Last Synced: 2025-09-04T17:17:56.811Z (9 months ago)
- Topics: aerospace, autonomous-systems, control-systems, distributed-algorithms, multi-agent-systems, optimal-control, orbital-mechanics, python, spacecraft-formation, telescope-assembly
- Language: Python
- Homepage: https://ieeexplore.ieee.org/document/9703189
- Size: 22 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
# Megastructure Assembly via Collaborative Robots in Orbits (MACRO)
This repository contains simulation code accompanying the paper *Scalable Techniques for Autonomous Construction of a Paraboloidal Space Telescope in an Elliptic Orbit* by Aaron John Sabu and Dwaipayan Mukherjee.
## Overview
MACRO provides tools to simulate autonomous formation flying of multiple spacecraft for the construction of a large parabolic mirror while in orbit. The code implements formation maneuvers, attitude consensus and auction based allocation strategies used in the publication. Generated plots and animations from sample runs are available under the `results/` directory.
## Repository Structure
```
.
├── config/ # YAML configuration files for simulations
│ └── default.yaml
├── results/ # Output directory for plots, logs, and animations
├── src/
│ └── macro/ # Core simulation and control modules
│ ├── __init__.py
│ ├── auction.py
│ ├── benchmark.py
│ ├── glideslope.py
│ ├── ifmea.py
│ ├── main.py # Contains the Macro class (main simulation)
│ ├── maneuvers.py
│ ├── mirror.py
│ ├── neighbors.py
│ ├── simulate.py
│ └── utils.py
├── tests/ # Unit tests
│ └── test_main.py
├── run.py # Top-level script to run a simulation
├── environment.yml # Conda environment definition (Python 3.11)
├── pyproject.toml # Project metadata and dependencies
├── requirements.txt # Optional pip-based install support
├── README.md # Project overview and setup instructions
├── LICENSE # License file
└── .gitignore
```
## Installation
This project requires Python 3.11. To set up the development environment using Conda:
```bash
# Create a new environment from the YAML file
conda env create -f environment.yml
# Activate the environment
conda activate macro
# (Optional) Install the project in editable mode with dev dependencies
pip install -e .[dev]
```
## Usage
Run the main simulation entry point:
```bash
python run.py
```
Simulation output will be written to HTML files in the working directory.
Adjust parameters in `src/main.py` to explore different scenarios.
## Testing
You can test the full simulation pipeline using:
```bash
pytest tests/test_main.py -v
```
## Contributing
Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and development instructions.
## Citation
If you use this code in your research, please cite our ICC 2021 paper:
```bibtex
@article{sabu2021scalable,
author = {John-Sabu, Aaron and Mukherjee, Dwaipayan},
title = {Scalable Techniques for Autonomous Construction of a Paraboloidal Space Telescope in an Elliptic Orbit},
booktitle = {2021 Seventh Indian Control Conference (ICC)},
year = {2021},
pages = {329-334},
doi = {10.1109/ICC54714.2021.9703189},
url = {https://ieeexplore.ieee.org/document/9703189}
}
```
A machine-readable citation file is provided in [CITATION.cff](CITATION.cff).
## License
This project is licensed under the terms of the GNU General Public License version 2. See [LICENSE](LICENSE) for details.
## Acknowledgements
This work was supported in part by an ISRO-funded project bearing code RD/0120-ISROC00-007. Aaron John Sabu was an undergraduate student at the time of writing and Dwaipayan Mukherjee was an Assistant Professor in the Department of Electrical Engineering, IIT Bombay.