NAME

       mintpy-prep_hyp3 - Prepare attributes file for HyP3 InSAR product.

DESCRIPTION

       usage: prep_hyp3.py [-h] file [file ...]

       Prepare attributes file for HyP3 InSAR product.

              For  each  interferogram,  the unwrapped interferogram, coherence, and metadata the
              file name is required e.g.:
              1) S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_unw_phase.tif
              2) S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_corr.tif
              3) S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2.txt

       A DEM filename is needed and a incidence angle filename is recommended
              e.g.:

              1) S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_dem.tif
              2) S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_lv_theta.tif

              This script will read these files, read the geospatial metadata from GDAL, find the
              corresponding HyP3 metadata file (for interferograms and coherence), and write to a
              ROI_PAC .rsc metadata file with the same name as the input file with  suffix  .rsc,
              e.g. S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_unw_phase.tif.rsc

              Here is an example of how your HyP3 files should look:

              Before loading:

              For each interferogram, 3 files are needed:

              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_unw_phase_clip.tif
              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_corr_clip.tif
              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2.txt

              For the geometry file 2 file are recommended:

       S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_dem_clip.tif
              (required)

              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_lv_theta_clip.tif
              (optional but recommended)

              After running prep_hyp3.py:

              For each interferogram:

              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_unw_phase_clip.tif
              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_unw_phase_clip.tif.rsc
              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_corr_clip.tif
              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_corr_clip.tif.rsc
              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2.txt

              For the input geometry files:

              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_dem_clip.tif
              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_dem_clip.tif.rsc
              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_lv_theta_clip.tif
              S1AA_20161223T070700_20170116T070658_VVP024_INT80_G_ueF_74C2_lv_theta_clip.tif.rsc

              Notes:

              HyP3 currently only supports  generation  of  Sentinel-1  interferograms,  so  some
              Sentinel-1  metadata  is hard-coded. If HyP3 adds processing of interferograms from
              other satellites, changes will be needed.

   positional arguments:
       file   HyP3 file(s)

   options:
       -h, --help
              show this help message and exit

   example:
       prep_hyp3.py
              interferograms/*/*unw_phase_clip.tif

       prep_hyp3.py
              interferograms/*/*corr_clip.tif

       prep_hyp3.py
              interferograms/*/*dem_clip.tif

       prep_hyp3.py
              interferograms/*/*lv_theta_clip.tif

       prep_hyp3.py
              interferograms/*/*clip.tif