mobigroup/gmtsar repository overview

GMTSAR is an open source (GNU General Public License) InSAR processing system designed for users familiar with Generic Mapping Tools (GMT). The code is written in C and will compile on any computer where GMT and NETCDF are installed. The system has three main components:

• a preprocessor for each satellite data type (ERS-1/2, Envisat, ALOS-1, TerraSAR-X, COSMOS-SkyMed, Radarsat-2, Sentinel-1A/B, and ALOS-2) to convert the native format and orbital information into a generic format;
• an InSAR processor to focus and align stacks of images, map topography into phase, and form the complex interferogram;
• a postprocessor, mostly based on GMT, to filter the interferogram and construct interferometric products of phase, coherence, phase gradient, and line-of sight displacement in both radar and geographic coordinates; GMT is used to display all the products as pdf files and KML images for Google Earth. A set of shell scripts has been developed for standard 2-pass processing as well as geometric image alignment for stacking and time series. Users are welcome to contribute to this effort.

⁠Docker Image

Download and launch the Docker image to open "ubuntu" user terminal using the commands below:

docker pull mobigroup/gmtsar
docker run -it --name gmtsar docker.io/mobigroup/gmtsar

or built the image yourself locally using Docker file inside the repository and open the terminal:

docker build --no-cache -t gmtsar . -f gmtsar.Dockerfile
docker run -it --name gmtsar docker.io/library/gmtsar

To download orbit data for ERS and Envisat (6 GB) enter this command:

download_orbits.sh

Note: use no-password "sudo" for all operations requiring "root" user access.

Note: to build the multi-arch images and share them to DockerHub use the command below with your own repository name:

docker buildx create --name mobigroup
docker buildx use mobigroup
docker buildx inspect --bootstrap
docker buildx build . -f gmtsar.Dockerfile \
    --platform linux/amd64,linux/arm64 \
    --tag mobigroup/gmtsar:2022-10-11 \
    --tag mobigroup/gmtsar:latest \
    --pull --push --no-cache

⁠Run Examples

Run example "Sentinel-1 TOPS Time Series" from https://topex.ucsd.edu/gmtsar/downloads/⁠ using the commands:

# download and unpack the example
wget -c http://topex.ucsd.edu/gmtsar/tar/S1A_Stack_CPGF_T173.tar.gz
tar xvzf S1A_Stack_CPGF_T173.tar.gz -C .
# clean 3rd party artefacts for pre-processing the Sentinel-1 SLC scenes
find raw_orig -name '2015*_manifest.safe' -exec cp /dev/null '{}' \;
# run the example processing scripts
./README_prep.txt
./README_proc.txt
./README_sbas.txt

Attention: the example 3rd party artefacts and hidden scripts for pre-processing the Sentinel-1 SLC scenes disabled above (see command noted “clean all the 3rd party artefacts”). The expected result is a ramp because of the old Sentinel-1 data issue resolved in 2016 year. We don’t need to worry about it anymore because all the affected Sentinel-1 scenes were replaced in data catalogs years ago.

⁠View Results

View the results in the terminal window using terminal image viewer:

chafa intf_all/2015020_2015068/phasefilt_mask.pdf

chafa intf_all/2015020_2015068/phasefilt_mask_ll.png

View the results in Docket Desktop CLI using terminal image viewer:

⁠Use Python scripts and Jupyter Notebooks

See Docker image PyGMTSAR (Python GMTSAR) - Sentinel-1 Satellite Interferometry for everyone⁠ and PyPI Python library⁠.

⁠Citations

Sandwell, D. ., R. . Mellors, X. Tong, M. Wei, and P. Wessel (2011), Open radar interferometry software for mapping surface deformation, Eos Trans. AGU, 92(28), doi:10.1029/2011EO280002.

Sandwell, D., Mellors, R., Tong, X., Xu, X., Wei, M., Wessel, P. (2016) GMTSAR: An InSAR Processing System Based on Generic Mapping Tools. UC San Diego: Scripps Institution of Oceanography. Retrieved from: http://topex.ucsd.edu/gmtsar/tar/GMTSAR_2ND_TEX.pdf⁠

⁠Learn more

• Official site: https://topex.ucsd.edu/gmtsar/⁠

• Issue tracker: https://github.com/gmtsar/gmtsar/issues⁠

• Source code: https://github.com/gmtsar/gmtsar⁠

• Example datasets: https://topex.ucsd.edu/gmtsar/downloads/⁠