Installation

Code download

First, download the source code, typically using git:

git clone git@gricad-gitlab.univ-grenoble-alpes.fr:deformvis/insarviz.git

Environment setup

  • With Anaconda

We recommend you install the Insarviz tool in a virtual environment. If you have installed the Anaconda distribution, navigate to within the top-level insarviz folder and create a conda environment with the required dependencies using :

conda env create -f environment.yaml

And activate it:

conda activate insarviz-env

  • Without Anaconda

Without Anaconda, create an virtual environment, activate it and install the required packages using the following commands:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Installation type

Finally, install the Insarviz module within your virtual environment. If you do not want to modify the source code, follow the Regular installation instructions. If you would like to be able to modify the code, follow the Developper install instructions.

  • Regular installation

Installing Insarviz in a virtual environment, or system-wide, is just a one-line command:

pip install .

  • Developper installation

If you intend to change the source code, you should install the tool in a editable mode:

pip install -e .

Test your installation

You can check your installation by doing:

ts_viz --help

This should print the help message. If not, your install failed.

Debug

If you get errors mentioning rasterio, try:

python3
>> import rasterio

If this fails with a error mentioning that rasterio cannot find the libgdal.so.XX then you should try either to change the version of rasterio (in the requirements.txt file) or the gdal version you are using.

InsarViz has rasterio (https://rasterio.readthedocs.io) as dependency. Rasterio depends upon the gdal library and assumes gdal is already installed. We recommend using version 1.2.10 of rasterio which is compatible with gdal 3.4.1 (on linux, use the command gdalinfo –version to figure aout which version of gdal you have).

Running InsarViz

Simply run InsarViz using the following command line:

ts_viz