Installation

From pip

gridmarthe is available on PyPi and can be installed with:

pip install gridmarthe

From conda-forge (with conda or mamba)

Not yet available.

From the source

Get the sources:

git clone https://gitlab.com/brgm/hydrogeological-modelling/marthe-tools/gridmarthe.git
cd gridmarthe

Gridmarthe uses Fortran sources for efficient I/O operations on Marthe grid files. These sources need to be compiled in order to use the lecsem module in gridmarthe. The F90 sources are compiled with f2py (so make sure to have a compiler [gfortran for example] and make installed on your system/python environment).

With pip

Then, for developper mode (ie with editable flag) just use the Makefile provided to do the compilation process and python installation.

make

Or, for a standard installation (not with editable flag):

pip install .

With conda (recommended on windows)

Alternatively, you can use a conda environment. For example with miniforge/mamba installed:

mamba env create -n gm -f environment.yml
mamba activate gm
pip install --no-deps .

For the editable/developper mode, one can add the -e flag in pip command, or use conda-build:

mamba env create -n gm -f environment.yml
mamba activate gm
mamba install conda-build
## Compile lecsem lib
## manual compilation
# cd src/gridmarthe/lecsem
# f2py -c lecsem.f90 edsemigl.f90 scan_grid.f90 -m lecsem --backend=meson --lower
# cd ../../../
## or just use the makefile
make lib
conda develop src/

Verification

At this point, the following command should not give any error:

python3 -c "import gridmarthe"