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.