🛰️ COnstellation Satellite siMulator for optIcal CommunicAtion (COSMICA)

COSMICA is a Python package for simulating optical communication satellite constellations. It is modular and extensible so that users can conduct various optical communication satellite constellation analyses. See COSMICA documentation for more details.

Usage

Examples

• See examples directory for how to use COSMICA in analyses.

• Run the basic simulation example:

  uv run examples/basic_simulation.py

  Add --plot to show a simple 2D equirectangular network snapshot:

  uv run examples/basic_simulation.py --plot

Getting started

Prerequisites

• Python 3.13 or higher

Installation

If you use pip, install COSMICA by running:

pip install cosmica

Structure

The diagram below shows the structure of the simulator. Each green box is a Python submodule.

License

This project is licensed under either of the MIT license or the Apache License 2.0 at your option.