INSTALL

Ulmo depends on a lot of libraries from the scientific python stack (namely:
numpy, pytables and pandas) and lxml. There are a couple of ways to get these
dependencies installed but it can be tricky if doing it by hand. The simplest
way to get things up and running is to use a scientific python distribution that
will install everything together. A full list is available on the `scipy`_
website but `Anaconda`_ / `Miniconda`_ is recommended as it is the easiest to set up.

If you are using Anaconda/Miniconda then you can install ulmo from the `conda-forge`_
channel with the following command:

    conda install -c conda-forge ulmo

Otherwise, follow the instructions below:

Once the requisite scientific python libraries are installed are installed, the
most recent release of ulmo can be installed from pypi. Pip is a good way to do
that:

    pip install ulmo

To install the bleeding edge development version, grab a copy of the `source
code`_ and run setup.py from the root directory:

    python setup.py install

To setup a development environment using conda:

    conda env create -n myenv --file py2_conda_environment.yml #(or py3_conda_environment.yml if you want to work with python 3)

    source activate myenv #(use 'activate test_environment' on windows)

    python setup.py develop


optionally run tests:
   python setup.py test


.. _Anaconda: http://continuum.io/downloads.html
.. _Miniconda: http://conda.pydata.org/miniconda.html
.. _conda-forge: https://conda-forge.github.io
.. _scipy: http://scipy.org/install.html
.. _source code: https://github.com/ulmo-dev/ulmo