Installation

SORTS

System requirements

  • Unix (tested on Ubuntu-16.04 LTS, Ubuntu-server-16.04 LTS)

  • Python > 3.6

Install SORTS

To install SORTS

git clone https://github.com/danielk333/SORTS
cd sorts
pip install .

The installation can be automatically tested if pytest is also installed

pytest

From scratch

To install Python 3.7 (from the deadsnakes ppa) on Ubuntu 16 (WARNING: This method differs on Ubuntu 18/20)

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.7
sudo apt install python3.7-venv

It is recommended to use virtual environments when installing sorts

python3.7 -m venv /path/to/new/sorts/environment
source /path/to/new/sorts/environment/bin/activate

Now you should be inside the new virtual environment. Check this by

pip --version

And you should see the path to “/path/to/new/sorts/environment”.

Alternatively if you want to use pip with Python 3.7 without using venv, the get-pip.py method can be used. WARNING: Using the bootstrap solution will break your current Python 2.7/3.5 pip, It is not recommended.

sudp apt install curl
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3.7 get-pip.py --user

Now, regardless of the method, you should make sure you have an up to date pip:

pip install --upgrade pip

If you do not have git, install it first:

sudo apt install git

To install SORTS

git clone https://github.com/danielk333/SORTS
cd sorts
pip install .

In case “pyant” or “pyorb” requirements fail on auto-install, run the following commands manually and try again:

pip install git+https://github.com/danielk333/pyant
pip install git+https://github.com/danielk333/pyorb

If you have trouble getting plotts from the examples, you might need to install a GUI-backed to matplotlib like TkAgg

sudo apt install python3.7-tk

and force matplotlib to use that backend by creating a matplotlibrc file ( https://matplotlib.org/tutorials/introductory/customizing.html ) and adding “backend : TkAgg” to it.

Install MPI

Open MPI on Ubuntu

sudo apt update
sudo apt install openmpi-bin libopenmpi-dev
pip install mpi4py

MPICH on Ubuntu

sudo apt-get update
sudo apt install mpich
pip install mpi4py

Install Orekit

Using install script while a virtual environment is active on Ubuntu (from inside the SORTS repository)

sudo apt-get update
sudo apt-get install openjdk-8-jdk
./install_orekit.sh

Install Pyglow

Taken from “https://github.com/timduly4/pyglow/

git clone git://github.com/timduly4/pyglow.git pyglow

cd pyglow/
pip install -r requirements.txt
make -C src/pyglow/models source
python setup.py install

For developers

To install developer dependencies

#NOT YET AVALIBLE

To test

pytest

To make doc

git checkout gh-pages
git cd docsrc
make github