Skip to main content

Orbit determination routines for Python

Project description


This is orbdetpy, a library of Python and Java routines for orbit determination. It is a thin Python wrapper for our estimation tools and Orekit, which are both written in Java.


The force model for orbit propagation currently includes:

  1. EGM96 gravity field up to degree and order 360.
  2. Earth solid tides due to the influence of the Sun and Moon.
  3. FES 2004 ocean tide model up to degree and order 100.
  4. The NRL MSISE-00 and simple exponential models for atmospheric drag.
  5. Solar radiation pressure.
  6. Third body perturbations from the Sun and Moon.

The measurement model supports range, range-rate, angles, and inertial Cartesian coordinates. Filtering is done using Orekit's Extended Kalman Filter or our custom Unscented Kalman Filter. Dynamic Model Compensation (DMC) can be used with either filter to estimate additional perturbing acclerations that result from unmodeled dynamics, maneuvers etc.

You can either use your own measurements or simulate observations using the simulateMeasurements() function.


  1. Install the Java Development Kit 8 (1.8) from Set the JAVA_HOME environment variable to point to your JDK installation. The java executable must also be in your system path.

  2. Install Python 3.6+ and run pip install orbdetpy to install orbdetpy and other package dependencies from the Python Package Index (PyPI). If you wish to use the develop or other experimental branches from GitHub, git clone them and run pip install -e . from the top level orbdetpy folder.

  3. Update the astrodynamics data in orbdetpy/data periodically by calling the update_data() function in the astrodata module. You might need to run this as the root user on Unix-like systems.

  4. Source code, example programs and data files can be downloaded from

  5. Apache Maven 3+ is needed if you hack the Java code and need to rebuild the JAR files. Switch to the orbdetpy/ folder and run the following depending on your CPU architecture and OS. Other combinations are possible; look them up online.

    Linux 64-bit: mvn -Dos.detected.classifier=linux-x86_64 package

    Linux 32-bit: mvn -Dos.detected.classifier=linux-x86_32 package

    Windows 64-bit: mvn -Dos.detected.classifier=windows-x86_64 package

    Windows 32-bit: mvn -Dos.detected.classifier=windows-x86_32 package

    MacOS 64-bit: mvn -Dos.detected.classifier=osx-x86_64 package

    MacOS 32-bit: mvn -Dos.detected.classifier=osx-x86_32 package


The following example programs can be found in the 'examples' folder. These examples use the Python wrapper interface but calling the underlying Java implementation directly is straightforward.

  1. : Demonstrates the measurement simulator. Note that maneuvers can be incorporated into the force model during simulation.

  2. : Plots the results of simulations created using

  3. : Demonstrates orbit determination in orbdetpy.

  4. : Plots the results of fitting orbits using

  5. : Run all the use cases under examples/data. Simulated measurements, orbit fits, differences between simulated truth versus estimates, and 3-sigma of estimated covariances will be written to output/ sub-folders.

orbdetpy uses JSON files to store settings, measurements and estimation results. The files in examples/data show how to configure measurement simulation and orbit determination using radar or telescope data. The file docs/ documents the structure of the JSON files.

The following are some typical use cases. It is assumed that the current working directory is examples/data.

  1. Simulate state vectors and radar measurements:

    python ../ radar_sim_cfg.json sim_data.json

    This will run the simulation configured in radar_sim_cfg.json and write simulated output to sim_data.json.

  2. Plot simulation results:

    python ../ radar_sim_cfg.json sim_data.json

    This will plot the simulated data generated in (1).

  3. Run OD on simulated radar data:

    python ../ radar_od_cfg.json sim_data.json od_output.json

    This will run OD on the simulated radar data generated in (1) using the OD configuration in radar_od_cfg.json and write OD output to od_output.json.

  4. Plot OD results:

    python ../ radar_od_cfg.json sim_data.json od_output.json

    This will plot the OD results from (3).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for orbdetpy, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size orbdetpy-0.3.0-py3-none-any.whl (30.1 MB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size orbdetpy-0.3.0.tar.gz (30.0 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page