poliastro - Python package for Orbital Mechanics
Project description
- Name:
poliastro
- Website:
- Author:
Juan Luis Cano Rodríguez <juanlu001@gmail.com>
- Version:
0.4.2
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. It is released under the MIT license.
from poliastro.examples import molniya
from poliastro.plotting import plot
plot(molniya)
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
SciPy, for root finding and numerical propagation
poliastro is usually tested on Linux, Windows and OS X on Python 2.7, 3.3, 3.4 and 3.5, using NumPy 1.9 and 1.10 (single codebase).
Platform |
Site |
Status |
|---|---|---|
Linux-x64 |
Anaconda |
|
OS X-x64 |
Travis CI |
|
Windows-x64 |
Appveyor |
Installation
The easiest and fastest way to get the package up and running is to install poliastro using conda:
$ conda install poliastro --channel poliastro
You can also install poliastro from PyPI using pip, given that you already have all the requirements:
$ pip install poliastro
You can also download poliastro source from GitHub and type:
$ python setup.py install
Development installations are also supported thanks to setuptools:
$ python setup.py develop
It is recommended that you never ever use sudo with distutils, pip, setuptools and friends in Linux because you might seriously break your system [1][2][3][4]. Options are per user directories, virtualenv or local installations.
Testing
If installed correctly, the tests can be run using py.test:
$ python -c "import poliastro; poliastro.test()" Running unit tests for poliastro [...] OK $
Contributing
Code writing
Code contributions are welcome! Just send a pull request and we’ll discuss it. In the wiki you can find some documents explaining the overall design of poliastro, and in the issue tracker you may find pending tasks waiting for someone to complete them.
Bug reporting
I am one of those that writes bug-free code every single time, but if you think you’ve found one please refer to the issue tracker on GitHub.
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:
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
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!
What’s the future of the project?
Development efforts are shifting soon towards the new Python Astrodynamics Project, a joint effort between several developers. In the meanwhile, poliastro will see bug fixes and probably new releases in 2015 and 2016.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file poliastro-0.4.2.tar.gz.
File metadata
- Download URL: poliastro-0.4.2.tar.gz
- Upload date:
- Size: 664.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d6392f60b47f3d8483c4217a5808690f55fa25bb2f2efee1b4c16d3417de53a0 |
|
| MD5 | c9dc679a22cb0cf47d21930eae1bfc35 |
|
| BLAKE2b-256 | fa0bc7d242c97ad243fab505169309fe7cdbfe9052811b8fe6b4ff783cd2f8f1 |
