Installation

For Users

Parts of orbitize are written in C, so you’ll need gcc (a C compiler) to install properly. Most Linux and Windows computers come with gcc built in, but Mac computers don’t. If you haven’t before, you’ll need to download Xcode command line tools. There are several helpful guides online that teach you how to do this. Let us know if you have trouble!

orbitize is registered on pip, and works in Python 2.7 or 3.6. To install orbitize, first make sure you have the latest versions of numpy and cython installed. With pip, you can do this with the command:

$ pip install numpy cython --upgrade

Next, install orbitize:

$ pip install orbitize

We recommend installing and running orbitize in a conda virtual environment. Install anaconda or miniconda here, then see instructions here to learn more about conda virtual environments.

For Developers

orbitize is actively being developed. The following method for installing orbitize will allow you to use it and make changes to it. After cloning the Git repository, run the setup file in the top level of the repo:

$ python setup.py develop

Issues?

If you run into any issues installing orbitize, please create an issue on GitHub.

If you are specifically having difficulties using cython to install orbitize, we suggest first trying to install all of the orbitize dependencies (listed in requirements.txt), then disabling compilation of the C-based Kepler module with the following alternative installation command:

$ pip install orbitize --install-option="--disable-cython"