Installation

Install from source

To keep track of the continuous development on the package beyond the major releases, git clone the repository somewhere and install the code from source.

Make sure to setup a new environment in either conda or venv (using tox):

Using conda

When using conda, you can setup the environment using the environment.yml file included in this repository.

conda env create -f environment.yml

conda activate pywatemsedem

Next, install the package from within the pywatemsedem folder in the terminal and with the (conda/virtualenv) environment activated:

pip install --no-deps -e .

Or for development purposes of this package, run following code to install developer dependencies as well (using pip):

pip install -e .[develop]

Note

The -no-deps option does not search for the dependencies from pip, but only installs the package itself for development and assumes you already have the dependencies installed yourself.

Note

If you wish to make use of hvplot, please manually install hvplot with conda.

Using venv

Run the dev tox command, which will create a venv with a development install of the package and it will register the environment as a ipykernel (for usage inside jupyter notebook):

tox -e dev

Note

Make sure you have a later python version installed than the one specified in the environment.yml-file in the environment from where tox is run.

Note

If you wish to make use of hvplot, please manually install hvplot with pip.

Dependencies

The pywatemsedem package has two external dependencies (outside the python dependencies):

Ensure you:

Note that the required version of WaTEM/SEDEM and SAGA are mentioned in the release page and Changelog.

Once you have downloaded both SAGA-WaTEM and WaTEM/SEDEM, pywatemsdem must know the locations of these binaries. This can be done in two ways:

The first way is to add the locations of the binaries to the environment variable PATH of your system. This method has the advantage that you will be able to use these software packages in a terminal in every directory. However, you might need admin rights to do this.

A second way, it to define the locations of the binaries of saga and WaTEM/SEDEM by adding a path to these executables in a .env-file in the locations main folder of this repo:

WATEMSEDEM = $YOUR_PATH/watem-sedem/watem_sedem #folder reference
SAGA = $YOUR_PATH/saga-9.3.1_x64 #folder reference

In your scripts/notebooks, add following before importing pywatemsedem:

from dotenv import load_dotenv, find_dotenv
load_dotenv(find_dotenv())

When importing pywatemsedem, it will add the directories of saga and watem-sedem to your PATH envrionment variable.