Getting started

Requirements

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).

Installation

To install poliastro just use pip:

$ pip install numpy astropy matplotlib poliastro

To install poliastro from source, just clone the source:

$ clone https://github.com/Pybonacci/poliastro.git
$ cd poliastro/
$ python setup.py install

Warning

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
$

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