Skip to main content

Python package for Orbital Mechanics

Project description

poliastro logo
Author:Juan Luis Cano Rodríguez orcid

circleci travisci appveyor codecov codeclimate

docs license doi astropy mailing Join the chat at

poliastro is an open source pure Python package dedicated to problems arising in Astrodynamics and Orbital Mechanics, such as orbit propagation, solution of the Lambert’s problem, conversion between position and velocity vectors and classical orbital elements and orbit plotting, focusing on interplanetary applications. It is released under the MIT license.

from poliastro.examples import molniya
from poliastro.plotting import plot




Complete documentation, including a user guide and an API reference, can be read on the wonderful Read the Docs.



In the examples directory you can find several Jupyter notebooks with specific applications of poliastro. You can launch a cloud Jupyter server using binder to edit the notebooks without installing anything. Try it out!


poliastro requires the following Python packages:

  • NumPy, for basic numerical routines
  • Astropy, for physical units and time handling
  • numba (optional), for accelerating the code
  • jplephem, for the planetary ephemerides using SPICE kernels
  • matplotlib, for orbit plotting
  • plotly, for 2D and 3D interactive orbit plotting
  • SciPy, for root finding and numerical propagation

poliastro is usually tested on Linux, Windows and OS X on Python 3.5, 3.6 and 3.7 against latest NumPy.

Platform Site Status
Linux CircleCI circleci
OS X Travis CI travisci
Windows x64 Appveyor appveyor


The easiest and fastest way to get the package up and running is to install poliastro using conda:

$ conda install poliastro --channel conda-forge

Please check out the documentation for alternative installation methods.



If installed correctly, the tests can be run using pytest:

$ python -c "import poliastro.testing; poliastro.testing.test()"
===================================== test session starts =====================================
platform linux -- Python 3.7.1, pytest-4.2.0, py-1.7.0, pluggy-0.8.1
rootdir: /home/juanlu/.miniconda36/envs/_test37/lib/python3.7/site-packages/poliastro, inifile:
collected 747 items
========= 738 passed, 3 skipped, 5 xfailed, 1 xpassed, 13 warnings in 392.12 seconds ==========


If the installation fails or you find something that doesn’t work as expected, please open an issue in the issue tracker.


'Stories in Ready'

poliastro is a community project, hence all contributions are more than welcome! For more information, head to CONTRIBUTING.rst.



Release announcements and general discussion take place on our mailing list. Feel free to join!


If you use poliastro on your project, please drop me a line.

You can also use the DOI to cite it in your publications. This is the latest one:


And this is an example citation format:

Juan Luis Cano Rodríguez et al.. (2015). poliastro: poliastro 0.4.0. Zenodo. 10.5281/zenodo.17462



poliastro is released under the MIT license, hence allowing commercial use of the library. Please refer to the COPYING file.


What’s up with the name?

poliastro comes from Polimi, which is the shortened name of the Politecnico di Milano, the Italian university where I was studying while writing this software. It’s my tiny tribute to a place I came to love. Grazie mille!

Can I do <insert awesome thing> with poliastro?

poliastro is focused on interplanetary applications. This has two consequences:

  • It tries to be more general than other Flight Dynamics core libraries more focused on Earth satellites (see Related software for a brief list), allowing the algorithms to work also for orbits around non-Earth bodies.
  • It leaves out certain features that would be too Earth-specific, such as TLE reading, SGP4 propagation, groundtrack plotting and others.

What’s the future of the project?

poliastro is actively maintained and receiving an influx of new contributors thanks to the generous sponsorship of Google and the European Space Agency. The best way to get an idea of the roadmap is to see the Milestones of the project.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
poliastro-0.12.0-py3-none-any.whl (118.4 kB) Copy SHA256 hash SHA256 Wheel py3
poliastro-0.12.0.tar.gz (93.4 kB) Copy SHA256 hash SHA256 Source None

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