SSAPy Toolkit (Python package: ssapy_toolkit) is a collection of extensions for the SSAPy ecosystem, providing tools for orbital mechanics, plotting, and data IO to support research and engineering workflows.

SSAPy itself is a fast, flexible, high-fidelity orbital modeling and analysis tool for orbits spanning from low-Earth orbit into the cislunar regime. It supports rich satellite definitions, multiple element types and coordinate frames, configurable force models (Earth and lunar gravity, radiation pressure, drag, planetary perturbations, maneuvers), a variety of integrators, Monte Carlo and UQ workflows, and extensive ground/space observer and plotting capabilities. See the SSAPy repository for full details:

https://github.com/llnl/SSAPy/tree/main

• Utility functions for orbital mechanics and astrodynamics
• Coordinate transforms and time conversions
• Data IO helpers for HDF5, CSV, JSON, and more
• Plotting helpers for orbits, ground tracks, and dashboards

SSAPy Toolkit is a standard Python package.

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install --upgrade pip
pip install -e .[dev]

This installs the package in editable mode along with development dependencies (testing, linting, docs tools, etc.).

Once installed, you can import the package in Python:

import ssapy_toolkit as st

from ssapy_toolkit.orbital_mechanics import keplerian
from ssapy_toolkit.plots import orbit_plot

More detailed examples can be found in the demos/ directory.

To run the test suite:

pytest demos

or to build a visualization document of the full test suite:

ssapy-demo-gallery

Code formatting and linting are handled via ruff (see pyproject.toml for configuration).

Project documentation is built with Sphinx and hosted on Read the Docs. Once configured, you will be able to find the latest documentation at:

https://ssapy-toolkit.readthedocs.io

To build the docs locally (after installing dev dependencies):

cd docs
make html

The built HTML files will be in docs/_build/html/.

This project is licensed under the BSD 3-Clause License. See the LICENSE file for details.