Installing with conda#

Using conda for installing VaMPy allows you to easily manage dependencies and keep them isolated from your system’s existing libraries. We recommend this option for developers who want to contribute to the software, but requires installation of all the dependencies.

Prerequisites#

  • The conda package manager must be installed on your computer. It can be installed through Anaconda or Miniconda.

Installation on Linux or macOS#

Step 1: Clone the VaMPy repository#

Start by downloading and navigating to the root directory of VaMPy with the following command in your terminal:

$ git clone https://github.com/KVSLab/VaMPy.git
$ cd VaMPy

Step 2: Create a conda environment#

Once you have installed conda, create a new environment for VaMPy with all its dependencies using the following command in your terminal:

$ conda env update --file environment.yml --name your_environment

Step 3: Activate the conda environment#

After the configuration of the conda environment is finished, activate the newly created environment by running the following command:

$ conda activate your_environment

Step 4: Install VaMPy inside the conda environment using pip#

Finally, you can install the VaMPy package inside your environment using pip:

$ python3 -m pip install .

Step 5: Verify the installation#

You can verify that VaMPy is installed correctly by downloading the test dependencies, and running the tests using the following commands:

$ python3 -m pip install .[test]
$ python3 -m pytest tests 

Installation on Windows#

We recommend Windows users to use Windows Subsystem for Linux and follow the Linux instructions, or use Docker.

Alternatively, Windows users may install the FEniCS dependency from source, by following the FEniCS Reference Manual. Then, download the remaining dependencies through conda by removing the fenics dependency inside environment.yml and follow the steps of the Linux/macOS installation instructions.

Editable installation of VaMPy#

If you want to make changes to any of the scripts included in VaMPy, you can install an editable version on your machine by supplying the --editable flag:

$ python3 -m pip install --editable .

The --editable flag installs the project in editable mode meaning that any changes to the original package will be reflected directly in your environment.