.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
.TH MINTPY-GEOCODE "1" "May 2022" "mintpy-geocode v1.3.3" "User Commands"
.SH NAME
mintpy-geocode \- Resample radar coded files into geo coordinates, or reverse
.SH DESCRIPTION
usage: geocode.py [\-h] [\-d DSET] [\-l LOOKUPFILE] [\-\-lat\-file LATFILE]
.IP
[\-\-lon\-file LONFILE] [\-\-geo2radar] [\-t TEMPLATEFILE]
[\-b S N W E] [\-\-lalo LAT_STEP LON_STEP]
[\-i {nearest,linear}] [\-\-fill FILLVALUE] [\-n NPROCS]
[\-\-software {pyresample,scipy}] [\-\-update] [\-o OUTFILE]
[\-\-outdir OUT_DIR] [\-\-ram MAXMEMORY]
file [file ...]
.PP
Resample radar coded files into geo coordinates, or reverse
.SS "positional arguments:"
.TP
file
File(s) to be geocoded
.SS "options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-d\fR DSET, \fB\-\-dset\fR DSET
dataset to be geocoded, for example:
height                        for geometryRadar.h5
unwrapPhase\-20100114_20101017 for ifgramStack.h5
.TP
\fB\-l\fR LOOKUPFILE, \fB\-\-lookup\fR LOOKUPFILE
Lookup table file generated by InSAR processors.
.TP
\fB\-\-lat\-file\fR LATFILE
lookup table file for latitude.
.TP
\fB\-\-lon\-file\fR LONFILE
lookup table file for longitude.
.TP
\fB\-\-geo2radar\fR, \fB\-\-geo2rdr\fR
resample geocoded files into radar coordinates.
ONLY for lookup table in radar\-coord (ISCE, Doris).
.TP
\fB\-t\fR TEMPLATEFILE, \fB\-\-template\fR TEMPLATEFILE
Template file with geocoding options.
.TP
\fB\-\-update\fR
skip resampling if output file exists and newer than input file
.TP
\fB\-o\fR OUTFILE, \fB\-\-output\fR OUTFILE
output file name. Default: add prefix 'geo_'
.TP
\fB\-\-outdir\fR OUT_DIR, \fB\-\-output\-dir\fR OUT_DIR
output directory.
.TP
\fB\-\-ram\fR MAXMEMORY, \fB\-\-memory\fR MAXMEMORY
Max amount of memory in GB to use (default: 4.0).
Adjust according to your computer memory.
.SS "grid in geo-coordinates:"
.TP
\fB\-b\fR S N W E, \fB\-\-bbox\fR S N W E
Bounding box for the area of interest.
using coordinates of the uppler left corner of the first pixel
.TP
and the lower right corner of the last pixel
for radar2geo, it's the output spatial extent
for geo2radar, it's the input  spatial extent
.TP
\fB\-\-lalo\fR LAT_STEP LON_STEP, \fB\-\-lalo\-step\fR LAT_STEP LON_STEP
output pixel size in degree in latitude / longitude.
degrees     \fB\-\-\fR> meters on equator
0.000925926 \fB\-\-\fR> 100
0.000833334 \fB\-\-\fR> 90
0.000555556 \fB\-\-\fR> 60
0.000462963 \fB\-\-\fR> 50
0.000277778 \fB\-\-\fR> 30
0.000185185 \fB\-\-\fR> 20
0.000092593 \fB\-\-\fR> 10
.SS "interpolation:"
.TP
\fB\-i\fR {nearest,linear}, \fB\-\-interp\fR {nearest,linear}
interpolation/resampling method (default: nearest).
.TP
\fB\-\-fill\fR FILLVALUE
Fill value for extrapolation (default: nan).
.TP
\fB\-n\fR NPROCS, \fB\-\-nprocs\fR NPROCS
number of processors to be used for calculation (default: 1).
Note: Do not use more processes than available processor cores.
.TP
\fB\-\-software\fR {pyresample,scipy}
software/module used for interpolation (default: pyresample)
Note: \fB\-\-bbox\fR is not supported for \fB\-p\fR scipy
.SS "template options:"
.IP
# for input dataset in radar coordinates only
# commonly used resolution in meters and in degrees (on equator)
# 100,         60,          50,          30,          20,          10
# 0.000925926, 0.000555556, 0.000462963, 0.000277778, 0.000185185, 0.000092593
mintpy.geocode              = auto  #[yes / no], auto for yes
mintpy.geocode.SNWE         = auto  #[\-1.2,0.5,\-92,\-91 / none ], auto for none, output extent in degree
mintpy.geocode.laloStep     = auto  #[\-0.000555556,0.000555556 / None], auto for None, output resolution in degree
mintpy.geocode.interpMethod = auto  #[nearest], auto for nearest, interpolation method
mintpy.geocode.fillValue    = auto  #[np.nan, 0, ...], auto for np.nan, fill value for outliers.
.SS "example:"
.IP
geocode.py velocity.h5
geocode.py velocity.h5 \fB\-b\fR \fB\-0\fR.5 \fB\-0\fR.25 \fB\-91\fR.3 \fB\-91\fR.1
geocode.py velocity.h5 timeseries.h5 \fB\-t\fR smallbaselineApp.cfg \fB\-\-outdir\fR ./geo \fB\-\-update\fR
.IP
# geocode file using ISCE\-2 lat/lon.rdr file
geocode.py filt_fine.int \fB\-\-lat\-file\fR ../../geom_reference/lat.rdr \fB\-\-lon\-file\fR ../../geom_reference/lon.rdr
.IP
# radar\-code file in geo coordinates
geocode.py swbdLat_S02_N01_Lon_W092_W090.wbd \fB\-l\fR geometryRadar.h5 \fB\-o\fR waterMask.rdr \fB\-\-geo2radar\fR
geocode.py geo_velocity.h5 \fB\-\-geo2radar\fR