Trying to simplify the installation of the ISCE2 framework (primarily for myself)
Inspiration: [https://github.com/lijun99/isce2-install] (Lijun Zhu)
- OS: Linux (Ubuntu 24.04 LTS)
- Board: ASUS TUF GAMING X570-PRO WIFI II
- Processor: AMD Ryzen™ 9 5950X × 32
- Graphics: NVIDIA GeForce RTX™ 3090
Open the shell on your machine, and switch to your work directory. I recommend that you setup a folder, say "ISCE". The ISCE2 framework that you'll install is available here: https://github.com/isce-framework/isce2. Let's say you want to install the latest release. I recommend [optionally]:
mkdir ISCE && cd ISCE
mkdir v2_6_3 # folder named according to the release, assuming the latest is 2.6.3
cd v2_6_3
If you don't have conda installed on your machine, please do it first. Next, create a new conda environment, and install Python 3.9 in it.
conda create --name isce python=3.11
conda activate isce
Install packages listed in the requirement.txt
file.
conda install -c conda-forge --file requirements.txt
Check out the latest ISCE2 from its GitHub repository. The code will be checked out at the current directory.
git clone https://github.com/isce-framework/isce2.git
cd isce2
Now make a subfolder for the build
mkdir build
cd build
Create a symbolic link in this folder to point to the site packages directory.
ln -sf `python3 -c 'import site; print(site.getsitepackages()[0])'` $CONDA_PREFIX/packages
Here, python3 -c 'import site; print(site.getsitepackages()[0])
is simply going to return the complete path where Python is installed in the current conda environment. In my case, it is /home/adnan/miniconda3/envs/isce/lib/python3.11/site-packages
.
Configure Cmake and install
# run cmake config
cmake .. -DCMAKE_INSTALL_PREFIX=$CONDA_PREFIX \
-DCMAKE_CUDA_ARCHITECTURES=native \
-DCMAKE_PREFIX_PATH=${CONDA_PREFIX} \
-DCMAKE_BUILD_TYPE=Release
Carefully observe the screen dump. There are likely to be several warnings. If there are any missing libraries, try to troubleshoot. If there is no critical error, proceeded as follows:
# compile and install
make -j && make install
Check if the installation is correct:
python3 -c 'import isce'
This should print something like Using default ISCE Path: /home/adnan/miniconda3/envs/isce/lib/python3.11/site-packages/isce
.
topsApp.py --help --steps
It should print details:
2024-08-04 11:37:09,034 - isce.insar - INFO - ISCE VERSION = 2.6.3, RELEASE_SVN_REVISION = ,RELEASE_DATE = 20230418, CURRENT_SVN_REVISION =
ISCE VERSION = 2.6.3, RELEASE_SVN_REVISION = ,RELEASE_DATE = 20230418, CURRENT_SVN_REVISION =
None
The currently supported sensors are: ['SENTINEL1']
...
Things should work now!