Package: mintpy
MintPyThe Miami INsar Time-series software in PYthon (MintPy as /mɪnt paɪ/) is an open-source package for Interferometric Synthetic Aperture Radar (InSAR) time series analysis. It reads the stack of interferograms (coregistered and unwrapped) inISCE,ARIA,FRInGE,HyP3,GMTSAR,SNAP,GAMMAor 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.This is research code provided to you "as is" with NO WARRANTIES OF CORRECTNESS. Use at your own risk.1.Installation2. Running MintPy2.1 Routine workflowsmallbaselineApp.pyMintPy reads a stack of interferograms (unwrapped interferograms, coherence and connected components from SNAPHU if available) and the geometry files (DEM, lookup table, incidence angle, etc.). You need to give thepath to where the files areand MintPy takes care of the rest!smallbaselineApp.py# run with default template 'smallbaselineApp.cfg'smallbaselineApp.py<custom_template># run with default and custom templatessmallbaselineApp.py-h/--help# helpsmallbaselineApp.py-H# print    default template optionssmallbaselineApp.py-g# generate default template if it does not existsmallbaselineApp.py-g<custom_template># generate/update default template based on custom template# Run with --start/stop/dostep optionssmallbaselineApp.pyGalapagosSenDT128.txt--dostepvelocity# run step 'velocity' onlysmallbaselineApp.pyGalapagosSenDT128.txt--endload_data# end run after step 'load_data'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 the temporal coherence 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.Configuration parameters for each step are initiated with default values in a customizable text filesmallbaselineApp.cfg.Exampleon Fernandina volcano, Galápagos with Sentinel-1 datawgethttps://zenodo.org/record/3952953/files/FernandinaSenDT128.tar.xz
tar-xvJfFernandinaSenDT128.tar.xzcdFernandinaSenDT128/mintpy
smallbaselineApp.py${MINTPY_HOME}/docs/templates/FernandinaSenDT128.txtResults are plotted in./picfolder. To explore more data information and visualization, try the following scripts:info.py# check HDF5 file structure and metadataview.py# 2D map viewtsview.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 datasetplot_transection.py# plot 1D profile along a line of a 2D matrix (interactive)save_kmz.py# generate Google Earth KMZ file in points or raster imagesave_kmz_timeseries.py# generate Google Earth KMZ file in points for time-series (interactive)2.2 Customized processing recipeMintPy is a toolbox with individual utility scripts. Simply run the script with-h / --helpto see its usage, you could build your own customized processing recipe!Hereis an example to compare the velocities estimated from displacement time-series with different tropospheric delay corrections.2.3 Build on top ofmintpymoduleMintPy is modulized in Python with utilities classes and functions and well commented in the code level. Users who are familiar with Python could build their own functions and modules on top ofmintpy.objectsandmintpy.utils. However, we don't have a complete API document website yet (maybe you can contribute this!). Below is an example of reading the 3D matrix of displacement time-series from an HDF5 file.frommintpy.utilsimportreadfilets_data,meta=readfile.read('timeseries_ERA5_ramp_demErr.h5')3.DocumentationAlgorithms implemented in the software are described in details atYunjun et al. (2019).Quick start with example datasetsExample data directoryExample template filesTutorials in Jupyter Notebook4. Contact usMost development discussion happens on GitHub. Feel free toopen an issueor comment on any open issue or pull request.Join ouruser forum on google groupsor usegithub discussionsto ask questions or leave comments.5. ContributingImposter syndrome disclaimer:We want your help. No, really.There may be a little voice inside your head that is telling you that you're not ready to be an open source contributor; that your skills aren't nearly good enough to contribute. What could you possibly offer?We assure you - the little voice in your head is wrong. If you can write code at all, you can contribute code to open source. Contributing to open source projects is a fantastic way to advance one's coding skills. Writing perfect code isn't the measure of a good developer (that would disqualify all of us!); it's trying to create something, making mistakes, and learning from those mistakes. That's how we all improve, and we are happy to help others learn.Being an open source contributor doesn't just mean writing code.You can help out by writing or proofreading documentation, suggesting or implementing tests, or even giving feedback about the project (and yes - that includes giving feedback about the contribution process). Some of these contributions may be the most valuable to the project as a whole, because you're coming to the project with fresh eyes, so you can see the errors and assumptions that seasoned contributors have glossed over.For more information, please read ourcontributing guide.This disclaimer was adapted from theMetPy project.6. Citing this workYunjun, Z., Fattahi, H., and Amelung, F. (2019), Small baseline InSAR time series analysis: Unwrapping error correction and noise reduction,Computers & Geosciences,133, 104331. [doi|arxiv|data|notebook]In addition to the above, we recommend that you cite the original publications that describe the algorithms used in your specific analysis. They are noted briefly in thedefault template fileand listed in thereferences.md file.