Skip to main content

=========

Project description

poliastro logo
Name:

poliastro

Website:

https://poliastro.github.io/

Author:

Juan Luis Cano Rodríguez orcid

Version:

0.14b1

azure_pipelines codecov codeclimate

docs license doi astropy mailing Join the chat at https://chat.openastronomy.org/#/room/#poliastro:matrix.org

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

molniya.plot()
https://github.com/poliastro/poliastro/raw/0.14.x/docs/source/examples/molniya.png

Documentation

docs

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

https://docs.poliastro.space/

Examples

mybinder

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!

https://beta.mybinder.org/v2/gh/poliastro/poliastro/0.14.x?filepath=index.ipynb

Requirements

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 tested on Linux, OS X and Windows on Python 3.6, 3.7 and 3.8 against latest NumPy.

azure_pipelines

Installation

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.

Contributing

'Stories in Ready'

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

Support

mailing Join the chat at https://chat.openastronomy.org/#/room/#poliastro:matrix.org

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

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

Citing

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:

doi

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

License

license

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

FAQ

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.

Source Distribution

poliastro-0.14b1.tar.gz (7.5 MB view details)

Uploaded Source

Built Distribution

poliastro-0.14b1-py3-none-any.whl (142.5 kB view details)

Uploaded Python 3

File details

Details for the file poliastro-0.14b1.tar.gz.

File metadata

  • Download URL: poliastro-0.14b1.tar.gz
  • Upload date:
  • Size: 7.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.1 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.8.0

File hashes

Hashes for poliastro-0.14b1.tar.gz
Algorithm Hash digest
SHA256 4d8aa945b72963924c482f5bcb8099598b1b375fe5c59d38aef1cc078e0e89db
MD5 7ae422078627fce375d29c8556514d07
BLAKE2b-256 b8e345c6f9d501164697c03527c8c38305b6eec2273bc88b9c26bdad24ffa62f

See more details on using hashes here.

File details

Details for the file poliastro-0.14b1-py3-none-any.whl.

File metadata

  • Download URL: poliastro-0.14b1-py3-none-any.whl
  • Upload date:
  • Size: 142.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.1 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.8.0

File hashes

Hashes for poliastro-0.14b1-py3-none-any.whl
Algorithm Hash digest
SHA256 2467cc9052f2c0838e5f6a7f7747ec4318b55d5f64197c87aba91aa2873a80e0
MD5 5b755402a32e1c2bbd1b1a1c4e5f7e5a
BLAKE2b-256 ff4f3292371a08055521fa965c689091d1d8b8ca7bc978047c89c8b07c271db5

See more details on using hashes here.

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