Installation

Install the package

Use a conda environment

To avoid dependency conflicts with other packages, it is best practice to install Python packages within a virtual environment. We recommend using conda or mamba to create and manage this environment, as they simplify the installation process. The following instructions assume that you have conda installed, but the same commands will also work with mamba/micromamba.

Users

To install movement in a new environment, follow one of the options below. We will use movement-env as the environment name, but you can choose any name you prefer.

Conda

Create and activate an environment with movement installed:

conda create -n movement-env -c conda-forge movement
conda activate movement-env

Pip

Create and activate an environment with some prerequisites:

conda create -n movement-env -c conda-forge python=3.11 pytables
conda activate movement-env

Install the latest movement release from PyPI:

pip install movement

Developers

If you are a developer looking to contribute to movement, please refer to our contributing guide for detailed setup instructions and guidelines.

Check the installation

To verify that the installation was successful, run (with movement-env activated):

movement info

You should see a printout including the version numbers of movement and some of its dependencies.

Update the package

To update movement to the latest version, we recommend installing it in a new environment, as this prevents potential compatibility issues caused by changes in dependency versions.

To uninstall an existing environment named movement-env:

conda env remove -n movement-env

Tip

If you are unsure about the environment name, you can get a list of the environments on your system with:

conda env list

Once the environment has been removed, you can create a new one following the installation instructions above.