The Miami INsar Time-series software in PYthon (MintPy) is an open-source package for Interferometric Synthetic Aperture Radar time series analysis. It reads the stack of interferograms (coregistered and unwrapped) in ISCE, GAMMA, ARIA, SNAP or ROI_PAC format, and produces three dimensional (2D in space and 1D in time) ground surface displacement in line-of-sight direction. It includes a routine time series analysis (smallbaselineApp.py) and some independent toolbox.
This package was called PySAR before version 1.1.1. For version 1.1.2 and onward, we use MintPy instead.
1. Installation
MintPy reads a stack of interferograms (unwrapped interferograms, coherence and connecting components from SNAPHU if available) and the geometry files (DEM, lookup table, incidence angle, etc.). You need to give the path to where the files are and MintPy takes care of the rest!
smallbaselineApp.py #run with default template 'smallbaselineApp.cfg'
smallbaselineApp.py <custom_template> #run with default and custom templates
smallbaselineApp.py -h / --help #help
smallbaselineApp.py -H #print default template options
smallbaselineApp.py -g #generate default template if it does not exist
smallbaselineApp.py -g <custom_template> #generate/update default template based on custom template
# Run with --start/stop/dostep options
smallbaselineApp.py GalapagosSenDT128.template --dostep velocity #run at step 'velocity' only
smallbaselineApp.py GalapagosSenDT128.template --end load_data #end after step 'load_data'Example on Fernandina volcano, Galápagos with Sentinel-1 data
wget https://zenodo.org/record/3635245/files/FernandinaSenDT128.tar.xz
tar -xvJf FernandinaSenDT128.tar.xz
cd FernandinaSenDT128/mintpy
smallbaselineApp.py ${MINTPY_HOME}/docs/examples/input_files/FernandinaSenDT128.txt
Inside smallbaselineApp.py, it reads the unwrapped interferograms, references all of them to the same coherent pixel (reference point), calculates the phase closure and estimates the unwrapping errors (if it has been asked for), inverts the network of interferograms into time-series, calculates a parameter called "temporal coherence" which can be used to evaluate the quality of inversion, corrects local oscillator drift (for Envisat only), corrects stratified tropospheric delay (using global atmospheric models or phase-elevation-ratio approach), removes phase ramps (if it has been asked for), corrects DEM error,... and finally estimates the velocity.
Check ./pic folder for auto-generated figures. More details about this test data are in here.
Below are some useful scripts for data information and visulization.
info.py #check HDF5 file structure and metadata
view.py #2D map view
tsview.py #1D point time-series (interactive)
plot_coherence_matrix.py #plot coherence matrix for one pixel (interactive)
plot_network.py #plot network configuration of the dataset
plot_transection.py #plot 1D profile along a line of a 2D matrix (interactive)
save_kmz.py #generate Google Earth KMZ file in raster image
save_kmz_timeseries.py #generate Goodle Earth KMZ file in points for time-series (interactive)2.2 Customized processing recipe: example
MintPy is a toolbox with a lot of individual utility scripts, modulized in Python. Check its documentation or simply run the script with -h to see its usage, you could build your own customized processing recipe! Here is an example to compare the velocities estimated from displacement time-series with different tropospheric delay corrections: link
- Tutorials in Jupyter Notebook
- Example datasets
- Example data directory
- Example template files for InSAR processors
- Google Earth KMZ file
- Paper figures in Jupyter Notebook
Join our google group https://groups.google.com/forum/#!forum/mintpy to ask questions, get notice of latest features pushed to you!
Yunjun, Z., H. Fattahi, F. Amelung (2019), Small baseline InSAR time series analysis: Unwrapping error correction and noise reduction, Computers & Geosciences, 133, 104331, doi:10.1016/j.cageo.2019.104331, ArXiv.
In addition to the above, we recommend that you cite the original publications that describe the algorithms used in your specific analysis.
- Zhang Yunjun
- Heresh Fattahi
- Falk Amelung
- Scott Baker
- Joshua Zahner
- Alfredo Terreco
- David Grossman
- Yunmeng Cao
- Andre Theron
- Other community members. [Contribute]