ISCE has the following dependencies
One can use any of the three package managers - Macports, Homebrew or Conda to install ISCE on macOS.
We will only walk through the installation steps using Macports. It is highly recommend to not mix
packages installed by different package managers as this typically leads to library incompatibility issues.
We write the instructions assuming that we are using clang-8.0 and python37.
Changes these to appropriate version numbers for your installation.
If you decide to use gcc (say gcc7) on your mac - note that you may have to make additional changes
to your macports commands to force it to use libstdc++ instead of libc++.
We present instructions with clang here to ensure compatibility with most binaries that are distributed for osx.
sudo port install clang-8.0
In this section we will walk through the directory setup and build system instructions
for installing ISCE. ISCE can be built with 2 different build systems
In this set of instructions, we focus on cmake as it is already available via
standard package managers.
We assume the following directory structure in this tutorial
Location | Description |
---|---|
${ISCEHOME}/tools/isce/src | git checkout location/ unpacked tarball location of ISCE source |
${ISCEHOME}/tools/isce/build | cmake build location |
${ISCEHOME}/tools/isce/install | cmake install location |
Note that ${ISCEHOME} can point to any directory on your machine.
Ensure that you are in the build folder
Run cmake with the correct inputs
Other optional arguments can be added to the cmake line
Option | Description |
---|---|
-DMEMORY_CHECK_COMMAND=PATH_TO_VALGRIND_EXECUTABLE -DMEMORYCHECK_COMMAND_OPTIONS="--trace-children=yes --leak-check=full --dsymutil=yes --track-origins=yes" -DCMAKE_BUILD_TYPE=Debug | |
Run tests with "-T memcheck" to check for memory leaks. | |
valgrind needs to be installed. | |
-DCMAKE_BUILD_TYPE=RelWithDebInfo | Build with optimization flags with release. Default is to build in debug mode |
Build the software
Ensure that you are in the build folder
Install the software
Setup the environment variables. Note that these need to be done in addition to the settings needed for pyre.
Variable | Setting | Description |
---|---|---|
PATH | $PATH:${ISCEHOME}/tools/isce/install/bin | For executables installed by ISCE |
PYTHONPATH | $PYTHONPATH:${ISCEHOME}/tools/isce/install/packages | ISCE python package |
LD_LIBRARY_PATH | $LD_LIBRARY_PATH:${ISCEHOME}/tools/isce/install/lib | Shared libraries built by ISCE |