Getting started


poliastro requires the following Python packages:

  • NumPy
  • Astropy (for physical units handling and geometrical transforms)
  • matplotlib (for plotting)

It is usually tested on Linux on Python 2.7 and Python 3.3 (single codebase). A Fortran compiler is needed to build the extensions: poliastro is usually built with gfortran.

There is no reason it shouldn’t work under Windows or Mac OS X with properly configured tools (not tested).


To install poliastro just use pip:

$ pip install numpy astropy matplotlib poliastro

To install poliastro from source, just clone the source:

$ clone
$ cd poliastro/
$ python install


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.


If installed correctly, the tests can be run using py.test:

$ python -c "import poliastro; poliastro.test()"
Running unit tests for poliastro

If for some reason any test fails, please report it in the issue tracker.