Documenting file names

[Kurt Feigl]

Looking at the output from mintpy, I wonder what is contained in the following file names?

avgPhaseVelocity.h5 # does this contain the same values as in the dataset named "velocity" in timeseries.h5 which is supposed to contain the "raw time series"?

demErr.h5  #   Is this the topographic error in the interferogram from some model?
timeseries_demErr.h5 # what is the data set named "timeseries" in this file? 

I have read the docs at the site below, but could not find the answers.

https://mintpy.readthedocs.io/en/latest/api/data_structure/

Would it be too much to ask to include a text description in the HDF5 files that a human could read using h5ls or h5dump?

Thanks!

[Kavya Kinjalk]

If anyone else was wondering about this, here are the answers to the following:

1. Debian Manpage, and this notebook for mintpy explains: "the average phase velocity using traditional stacking technique (Zebker et al., 1997) by dividing the unwrapped interferometric phase by their temporal baselines and averaging all interferograms." It is NOT the same as the linear velocity in m/yr from time‐series fitting.

2. demErr.h5 contains a 2D dataset /demErr (ℓ×w) of estimated DEM residual errors (meters) per pixel, computed via the baseline‐dependency method of Fattahi & Amelung (2013). These values represent the topographic error relative to the reference pixel (set to zero). The way it does this is to estimate each pixel’s DEM residual error by looking at the correlation between phase residuals and perpendicular baseline variations (source)

3. It is simply just the raw time-series (timeseries.h5) after applying the DEM‐error correction. I guess there's no relevant documentation exactly, but if it follows the general data structure, it can be inferred.

Sources definitely exist, but yeah, this should really be more clearly explained in the official documentation instead of being scattered around so much.

[Zhang Yunjun]

Thank you for the question and suggestions. We now added a new section with an link to this notebook in the official documentation.

Cheers,

Yunjun

[Kurt Feigl]

What is contained in the file named 'timeseries_tropHgt.h5'?

It is only output by setting mintpy.troposphericDelay.method = height_correlation

Does the file contain the time series AFTER correction, or only the correction itself?

[Yunjun Zhang]

It's the time series after the correction.

You may find the explanation on the input/output of each step in the notebook below:

https://github.com/insarlab/MintPy-tutorial/blob/main/workflows/smallbaselineApp.ipynb

Yunjun

--
You received this message because you are subscribed to a topic in the Google Groups "MintPy" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/mintpy/LwEtcH3-rzg/unsubscribe.
To unsubscribe from this group and all its topics, send an email to mintpy+un...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/mintpy/9454dfc7-7315-488c-ad56-daeca7d684b1n%40googlegroups.com.