Installation

Requirements

sbpy has the following requirements that will be automatically taken care of with installation using pip:

  • Python 3.7 or later

  • numpy 1.17.0 or later

  • astropy 4.0 or later

  • astroquery 0.4.5 or later: For retrieval of online data, e.g., ephemerides and orbits.

  • scipy: For numerical integrations in sbpy.activity.gas and sbpy.photometry, among others.

  • synphot 1.0.0 or later: For calibration with respect to the Sun and Vega, filtering spectra through bandpasses.

Optional dependencies

  • Python extensions for oorb: For orbit transformations (oo_transform) and propagations (oo_propagate), as well as ephemerides calculations (from_oo).

  • pyradex: For non-LTE production rate calculation related to cometary activity (NonLTE).

  • ginga and photutils: To interactively enhance images of comets with the CometaryEnhancement Ginga plugin.

Using pip

The latest stable version of sbpy can be installed with:

$ pip install sbpy

Most optional dependencies may be installed via:

$ pip install sbpy[all]

oorb and pyradex are left for the user to install manually.

The latest development version of sbpy can be easily installed using:

$ pip install git+https://github.com/NASA-Planetary-Science/sbpy.git

Using GitHub

This way of installing sbpy is recommended if you plan to contribute to the module. The current development version of sbpy can be obtained from GitHub using

$ git clone https://github.com/NASA-Planetary-Science/sbpy.git

This will create a new directory (sbpy/). In this directory, run

$ python setup.py install --user

in order to use sbpy in your default Python environment. If you plan to work on the code and always want to use the latest version of your code, you can install it with

$ python setup.py develop --user