Version 1.3.1

Cut a new release for the 2021 UNAVCO short course.

New Features:

• big-data friendly features:
  • memory-efficient tsview.py via downsampling.
  • CPU-efficient dask parallelization in ifgram_inversion.py and dem_error.py by limiting *NUM_THREADS env variable to 1.
• support hyp3 product from ASF HyP3 service [preliminary]
  • load HyP3 products via prep_hyp3.py contributed by Forrest Williams, Bryan Marfito and Jiang Zhu.
  • support UTM projection in tropo_pyaps3.py and solid_earth_tides.py contributed by Jiang Zhu and Bryan Marfito.
• support gmtsar geocoded product via prep_gmtsar.py with contributions from Xiaohua Xu and Rebecca Bussard
• add save_kite.py to save mintpy displacement for pyrocko suite contributed by Marin Govorcin
• timeseries2velocity.py:
  • add two time functions: exponential via --exp and logarithmic via --log contributed by Yuan-Kai Liu
  • support STD propagation from time-series to time func
• modify_network.py:
  • add "Effective Coherence Ratio" method from Kang et al. (2021) contributed by Forrest Williams
  • calc MST network from remaining pairs after all the other criteria applied contributed by Brett Buzzanga
• utilities contributed by Forrest Williams:
  • spatial_filter.py: add double_difference algorithm from Bekaert et al. (2020)
  • generate_mask.py: add --minpixel option to select pixels based on cluster size
  • generate_mask.py: add --vstd option to select pixels based on signal-to-noise ratio using velocity STD
• visualizations:
  • save_kmz: support radar-coded file with point styles
  • tsview.py: plot & save the time function fitting results with contributions from Yuan-Kai Liu
  • view.py:
    • support --ref-point out of the subset box
    • support --ref-lalo for radar-coded file
    • support UTM projections
    • add --math option for simple operations, e.g. sqrt to display STD from VAR file
    • improved save & re-use GPS LOS data in CSV file
    • plot colorbar with the unit in the label for each subplot in case of multi-subplots with different units
    • add --mask-vmin/vmax options to adjust masking thresholds on the fly
  • more colormaps

Technical Improvements:

• translate plot_smallbaselineApp.sh from shell script to python, for better cross-platform compatibility with parallelization, contributed by Panji Brotoisworo and Joshua Zahner
• improvement API support of isce-2/topsApp geocoded products contributed by Yuan-Kai Liu
• improved support of isce-2 data files in the utility scripts (geocode.py, multilook.py and subset.py).
• Circle CI:
  • speedup installation using mamba
  • separate datasets into different runs for better navigation
  • platform-independent fortran compiler
• Various bugs and typo fixes.

Contributors:

• Zhang Yunjun
• Forrest Williams
• Yuan-Kai Liu
• Xiaohua Xu
• Marin Govorcin
• Panji Brotoisworo
• Bryan Marfito
• Jiang Zhu
• Brett Buzzanga
• Joshua Zahner
• Rebecca Bussard
• Simran Sangha
• Oliver Stephenson
• Sara Mirzaee
• Russell Grew
• Andrew Johnston
• James Rine

Version 1.3.0 - memory efficient routine workflow

New Features

• big-data friendly features:
  • memory efficient smallbaselineApp.py (and all scripts it relied on) via block-by-block IO or downsampling controlled via mintpy.compute.maxMemory (4GB by default) with contributions from Yuan-Kai Liu
  • parallel computing via dask extended to dem_error.py controlled via mintpy.compute.cluster/numWorker/config
  • mintpy.load.x/ystep to multilook while loading data to reduce the data size
• ISCE/alosStack products support (require isce2>=2.5) via mintpy.load.processor = isce contributed by Cunren Liang
• solid_earth_tides.py for solid Earth tides correction using PySolid and integrate into the routine workflow
• refactor tropo_gacos.py to bring back GACOS tropospheric correction and integrate into the routine workflow contributed by Sara Mirzaee and Simran Sangha
• complex time functions in timeseries2velocity.py contributed by Yuan-Kai Liu
• more example datasets and tests:
  • SanFranSenDT42 for aria contributed by Heresh Fattahi
  • WCapeSenAT129 for snap contributed by Andre Theron
• diversity updates with contributions from Sara Mirzaee:
  • replace oppressive language identified in the community with neutral language
  • rename the default branch from master to main

Technical Improvements

• support mintpy.load.autoPath = yes for aria
• support load interferogram magnitude data via mintpy.load.magFile
• support stitching non-phase files via image_stitch.py --no-offset contributed by Robert Zinke
• improved time series analysis for offset stack
• use NCORRLOOKS for weighting if available
• improved documentation
• cleanup sub-directory:
  • remove mintpy/objects/insarStack
  • remove mintpy/legacy
  • remove mintpy/dev
  • move sh to mintpy/sh
  • move data/resource files from docs into mintpy so that the latter is independent from the former.
• visualization:
  • auto discretize colormap if input data has <= 20 unique values
  • show colorer for multiple subplots with different units
• preliminary version of setup.py
• register mintpy to PyPI with contributions from Meissam Mehdizadeh
• support adding missing attributes from template files directly for load_data.py and save_hdfeos5.py
• new ASCII logo
• files/scripts name change:
  • match.py -> image_stitch.py
  • ifgramStack_coherence_spatialCoh.txt -> coherenceSpatialAvg.txt
  • numNonzeroIntClosure.h5 -> numTriNonzeroIntAmbiguity.h5
• drop python 3.5 support.
• bugs fix

Contributors

• Zhang Yunjun
• Cunren Liang
• Yuan-Kai Liu
• Sara Mirzaee
• Simran Sangha
• Heresh Fattahi
• Andre Theron
• Xiaoran Lv
• Robert Zinke
• Meissam Mehdizadeh
• Scott Staniewicz
• Russel Grew
• Bryan Marfito 
• Lei Yuan

Version 1.2.3

Cut a release for the 2020 UNAVCO InSAR short course.

New features

• support UAVSAR stack processed by isce/stripmapStack via mintpy.load.processor = isce contributed by Talib Oliver Cabrera
• computing- and memory-efficient ifgram_inversion.py as a prototype of the next version contributed by Joshua Zahner
• bootstrap velocity uncertainty integrated into timeseries2velocity contributed by Emre Havazli
• save_gdal.py to output gdal support files, i.e. GeoTIFF, ENVI, etc., contributed by Forrest Williams
• circle CI build_and_test workflow contributed by Meissam Mehdizadeh
• mintpy.load.autoPath option for automatic file path setting with contributions from Sara Mirzaee

Technical improvements

• move insarmaps scripts to geodesymiami org for more independent maintenance contributed by Alfredo Terreco
• replace xml.etree with defusedxml for XML file parsing
• improved implementations for save_qgis.py and prep_fringe.py
• documentation updates
• bugs fix

Contributors

• Zhang Yunjun
• Joshua Zahner
• Talib Oliver Cabrera
• Forrest Williams
• Meissam Mehdizadeh
• Sara Mirzaee
• Emre Havazli
• Xiaoran Lv
• Falk Amelung
• Alfredo Terreco

Version 1.2.2

Cut a release to match with ARIA-tools version 1.1.0.

New features

• full aria processor support in smallbaselineApp.py (require gdal>3)
• FRInGE time-series loading via prep_fringe.py contributed by Forrest Williams
• generic Dask cluster support for parallel processing in ifgram_inversion.py contributed by Joshua Zahner
• offset time-series with individual utils scripts.
• bootstrapping method for the linear velocity uncertainty estimation contributed by Emre Havazli
• phase-unwrapping error identification via the number of triplets with non-zero integer ambiguity numTriNonzeroIntAmbiguity.h5.

Technical improvements

• replace basemap with cartopy for geo visualization contributed by Joshua Zahner
• update default UNR GPS solution version from IGS08 to IGS14
• update example datasets with tropospheric correction from ERA-I to ERA5
• update simulation/fractal module
• better support of IO / plotting for binary data files
• bugs fix

Contributors:

• Zhang Yunjun
• Joshua Zahner
• Forrest Williams
• Emre Havazli
• Brett Buzzanga
• Simran Sangha

Version 1.2.1 - last version with basemap

New features

• cyclic colormap cmy provided by Piyush Agram.
• tropo_pyaps3.py: save the absolute tropospheric delay in HDF5 file for more generic usage and apply double differencing on the fly for InSAR, instead of saving the double-differenced tropospheric delay in HDF5 file.

Technical improvement

• use conda install basemap to replace pip install basemap contributed by Robert Zinke.
• minor updates:
  • prep_isce: use az/rgResolution from Sentinel-1 product definition doc.
  • view: keep binary file ext in fig title
  • utils/readfile: easy read magnitude data from .int file.

Contributors

• Zhang Yunjun
• Piyush Agram
• Robert Zinke

Version 1.2.0 - Yunjun et al. (2019, CAGEO)

Cut a version to match with Yunjun et al. (2019) and its jupyter notebooks.

New features

• Block-by-block file IO in ifgram_inversion.py for efficient memory usage.
• save_qgis.py to save time-series in QGIS format contributed by Piyush Agram.

Technical improvements

• Updates in smallbaselineApp.py:
  • add mintpy.networkInversion.shadowMask option
  • ignore no-data values from geometry file while writing waterMask.h5 for default masking.
• Improve mintpy.simulation tools for decorrelation noise and tropospheric turbulence.
• Save calculated GPS velocities to CSV file whiling plotting in view.py contributed by Emre Havazli.
• Add GitHub robot, issue and pull request templates, and CODE_OF_CONDUCT.md.
• Move jupyter notebooks from insarlab/MintPy to insarlab/MintPy-tutorial repo.
• Improved visualization scripts.
• Bugs fix.

Contributors

• Zhang Yunjun
• Heresh Fattahi
• Piyush Agram
• Emre Havazli

Version 1.2 beta

New features

• lookup_geo2radar.py to convert lookup table from geo (GAMMA) to radar (ISCE) coordinates contributed by Yunmeng Cao.

Technical improvements

• Reduced memory usage in ifgram_inversion.py
• Add docs/conda_env.yml for mintpy environment installation.
• Bugs fix

Contributors

• Zhang Yunjun
• Yunmeng Cao

Version 1.2 alpha - ARIA and SNAP product support

New features

• ARIA GUNW product support (powered by ISCE and ARIA-tools) via prep_aria.py.
• SNAP geocoded product support via prep_snap.py contributed by Andre Theron.
• GBIS data preparation / result loading via save/load_gbis.py.
• plot_transection.py for the interactive profile plot.
• support GAMMA lookup table with coordinates in meters (for polar regions).

Technical improvements

• Create ReadTheDoc website: https://mintpy.readthedocs.io.
• Add Docker image on DockerHub and config file contributed by Andre Theron.
• Add preliminary CI circle service, with help from David Bekaert and Gerald Manipon.
• Improved visualization.
• Increase connectComponent data type from bool to int16 for large amount of reliable regions in large scale processing.
• Reduced memory usage for geocoding small AOI using geocode.py with pyresample.
• Bugs fix.

Contributors

• Zhang Yunjun
• Heresh Fattahi
• Andre Theron
• Emre Havazli
• Falk Amelung
• Sang-Hoon Hoon
• David Bekaert
• Gerald Manipon
• Yunmeng Cao
• Scott Staniewicz

Version 1.1.2 - first release as MintPy

• Rename PySAR to MintPy (Miami INsar Time-series software in PYthon)
• Rename pysarApp.py to smallbaselineApp.py
• Update file/dir structure to be all in the small case

Contributor

• Zhang Yunjun

Version 1.1.1

Technical improvements

• expose pysar.troposphericDelay.minCorrelation by Lei Xie
• pysarApp.py -v to include the version number and release date for every commit
• bugs fix

Contributors

• Zhang Yunjun
• Lei Xie
• Bhuvan Varugu