Installation#

Install OrbitalPV from PyPI#

OrbitalPV targets Python 3.13 or newer. For normal use, install the public distribution from PyPI:

python -m pip install orbital-pv

Then import the package as:

import orbitalpv as opv

Optional extras#

For plotting the documentation examples:

python -m pip install "orbital-pv[examples]"

For advanced orbit/ephemeris adapters:

python -m pip install "orbital-pv[orbit]"

For the broader optional stack:

python -m pip install "orbital-pv[full]"

The research expansion in the source tree adds netcdf for CERES and POES/MetOp files and ground-research for optional vector-inventory readers and the official EUMETSAT SDK. Install them from a checkout containing that expansion:

python -m pip install ".[netcdf,ground-research,orbit,examples]"

The numerical flight and spacecraft physics APIs use the base NumPy/pandas stack. Provider credentials and externally supplied neural-model weights are runtime inputs, not installation dependencies.

Development installation#

Contributors should clone the repository and use the uv workspace:

git clone https://github.com/julianascencio/orbital-pv.git
cd orbital-pv
uv sync --all-packages --group dev --group lab --group ground

Documentation development:

uv sync --all-packages --group docs --group ground
make docs

Verify the development environment#

uv run ruff format --check .
uv run ruff check .
uv run ty check
uv run pytest