ssapy-toolkit 1.0.3

SSAPy Toolkit: extensions for orbital mechanics, plotting, and data IO

SSAPy Toolkit

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

---

Features

• 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

---

Installation

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.).

---

Usage

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.

---

Development

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).

---

Documentation

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/.

---

License

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