There are two ways to install the library, depending on your Python packaging ecosystem of choice. If you're unsure, the Conda approach is the most plug-and-play, getting you up and running as easily as possible.
If you use Conda to manage Python packages, you may run
$ conda install -c angus-g -c conda-forge lagrangian-filtering
to install this package and all its required dependencies. The -c
angus-g
flag must come before the -c conda-forge
flag to ensure
the correct OceanParcels dependency is pulled in.
To keep things a bit cleaner, you can install lagrangian-filtering in its own Conda environment:
$ conda create -n filtering -c angus-g -c conda-forge lagrangian-filtering
The created environment can be activated by running
$ conda activate filtering
And deactivated by running
$ conda deactivate
On the other hand, you may not use Conda, or you wish to develop either lagrangian-filtering or its modified OceanParcels dependency. In these cases, it is easier to install a modifiable version of the package in a virtual environment.
$ git clone https://github.com/angus-g/lagrangian-filtering
$ cd lagrangian-filtering
$ virtualenv env
$ source env/bin/activate
$ pip install -r requirements.txt
$ pip install -e .
This will install both lagrangian-filtering and parcels as development packages, where changes to the files in the git repository will be reflected in your Python environment. To update lagrangian-filtering, run
$ git pull
In the directory into which you cloned the repository. If the parcels dependency has changes, running
$ pip install -r requirements.txt
will pull changes to its corresponding git repository.