Skip to main content

Utilities and Python wrappers for Orbital Mechanics

Project description


Name: poliastro
Author: Juan Luis Cano Rodríguez orcid
Version: 0.17.0

poliastro codecov status

docs license doi astropy mailing Join the chat at

OpenCollective OpenCollective

poliastro is an open source (MIT) pure Python library for interactive Astrodynamics and Orbital Mechanics, with a focus on ease of use, speed, and quick visualization. It provides a simple and intuitive API, and handles physical quantities with units.

Some features include orbit propagation, solution of the Lambert's problem, conversion between position and velocity vectors and classical orbital elements and orbit plotting, among others. It focuses on interplanetary applications, but can also be used to analyze artificial satellites in Low-Earth Orbit (LEO).

from poliastro.examples import molniya


Molniya orbit



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, 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 supported on Linux, macOS and Windows on Python 3.8 to 3.10.



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.

Problems and suggestions

If for any reason you get an unexpected error message or an incorrect result, or you want to let the developers know about your use case, please open a new issue in the issue tracker and we will try to answer promptly.


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


mailing Join the chat at

Release announcements and general discussion take place on our Mailing List .

For further clarifications and discussions, feel free to join Poliastro Chat Room.


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.



This project exists thanks to all the people who contribute!



Thank you to all our backers! Become a backer.



Support us by becoming a sponsor. Your logo will show up here with a link to your website. Become a sponsor.



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!

Is poliastro validated?

Yes! poliastro is a community project that strives to be easy to use, while at the same time producing correct results that are validated against other commonly used Astrodynamics software such as GMAT and Orekit.

Can I suggest new features for poliastro?

Sure, we encourage you to open an issue so we can discuss future feature additions!

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.

Source Distribution

poliastro-0.17.0.tar.gz (122.5 kB view hashes)

Uploaded source

Built Distribution

poliastro-0.17.0-py3-none-any.whl (162.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page