Installing with conda

Installing with conda#

Using conda for installing OasisMove 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 OasisMove repository#

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

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

Step 2: Create a conda environment#

Once you have installed conda, create a new environment for OasisMove 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 OasisMove inside the conda environment using pip#

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

$ python3 -m pip install .

Step 5: Verify the installation#

You can verify that OasisMove 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 OasisMove#

If you want to make changes to any of the scripts included in OasisMove, 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.

Contents