Installation¶
Palladium requires Python 3.4 or better to run. If you are currently using
an older version of Python, you might want to check the FAQ
entry about virtual environments. Some of Palladium’s
dependencies such as numpy
, scipy
and scikit-learn
may
require a C compiler to install.
All of Palladium’s dependencies are listed in the requirements.txt
file.
You can use either pip
or conda
to install the dependencies
from this file.
For most installations, it is recommended to install Palladium and its dependencies inside a virtualenv or a conda environment. The following commands assume that you have your environment active.
Install from PyPI¶
It is a good practice to install dependencies with exactly the same
version numbers that the release was made with. You can find the
requirements.txt
that defines those version numbers in the top
level directory of Palladium’s source tree or can download it here:
requirements.txt
. You can
install the dependencies with the following command:
pip install -r requirements.txt
In order to install Palladium from PyPI, simply run:
pip install palladium
Install from binstar¶
For installing Palladium with conda install, you have to add the following binstar channel first:
conda config --add channels https://conda.binstar.org/ottogroup
conda install palladium
Note
Right now, there are only versions for linux-64 and osx-64 platforms available at our binstar channel.
Install from source¶
Download and navigate to your copy of the Palladium source, then run:
cd palladium
pip install -r requirements.txt
To install the Palladium package itself, run:
python setup.py install # or 'setup.py dev' if you intend to develop Palladium itself
If you prefer conda over using pip, run these commands instead to install:
cd palladium
conda create -n palladium python=3 --file requirements.txt #create conda environment
source activate palladium # activate conda environment
python setup.py install
Note
The virtualenv or conda create and source activate commands above generate and activate an environment where specific Python package versions can be installed for a project without interferring with other Python projects. This environment has to be activated in each context you want to call Palladium scripts (e.g., in a shell). So if you run into problems finding the Palladium scripts or get errors regarding missing packages, it might be worth checking if you have activated the corresponding environment. If you want to deactivate an environment, simply run deactivate (or source deactivate for conda environments).
Note
If you intend to develop Palladium itself or if you want to run the
tests, you additionally need to install the
requirements-dev.txt
with
pip install -r requirements-dev.txt
(or conda install --file
requirements-dev.txt
in the Anaconda setting).
Once you have Palladium installed, you should be able to use the
pld-version
command and find out which version of Palladium you’re
using:
pld-version
Now that you’ve successfully installed Palladium, it’s time to head over to the Tutorial to learn about what it can do for you.