How to install#
Installing with mamba
(recommended)#
mamba install -c conda-forge xdem
Important
Solving dependencies can take a long time with conda
, mamba
significantly speeds up the process. Install it with:
conda install mamba -n base -c conda-forge
Once installed, the same commands can be run by simply replacing conda
by mamba
. More details available in the mamba documentation.
If running into the sklearn
error ImportError: dlopen: cannot load any more object with static TLS
, your system
needs to update its glibc
(see details here).
If you have no administrator right on the system, you might be able to circumvent this issue by installing a working
environment with specific downgraded versions of scikit-learn
and numpy
:
mamba create -n xdem-env -c conda-forge xdem scikit-learn==0.20.3 numpy==1.19.*
On very old systems, if the above install results in segmentation faults, try setting more specifically
numpy==1.19.2=py37h54aff64_0
(works with Debian 8.11, GLIBC 2.19).
Installing with pip
#
pip install xdem
Warning
Updating packages with pip
(and sometimes mamba
) can break your installation. If this happens, re-create an environment from scratch pinning directly all your other dependencies during initial solve (e.g., mamba create -n xdem-env -c conda-forge xdem myotherpackage==1.0.0
).
Installing for contributors#
git clone https://github.com/GlacioHack/xdem.git
mamba env create -f xdem/dev-environment.yml
After installing, you can check that everything is working by running the tests: pytest -rA
.