ANSI-C program: scale_base_pt.c
NAME
scale_base_pt - scale unwrapped phase according to baselines
SYNOPSIS
scale_base_pt <plist> <pmask>
<pSLC_par> <ppos> <itab> <pbase>
<punw_in> <rec_num_in> <punw_out>
[ph_flag]
| <plist> | (input) point list (int) |
| <pmask> | (input) point data stack of mask values (uchar, set to - to accept all points) |
| <pSLC_par> | (input) stack of SLC/MLI parameters (binary) |
| <ppos> | (input) point data stack of interpolated point target positions (fcomplex, enter - to use plist coordinates) |
| <itab> | (input) table associating interferogram stack records
with pairs of SLC stack records (ascii) (line entries are: pSLC_rec1 pSLC_rec2 itab_rec_num switch_flag) |
| <pbase> | (input) stack of baseline parameters (binary) |
| <punw_in> | (input) point data stack of unwrapped phase to be scaled (float) |
| <rec_num_in> | record number of input unwrapped phase (to be scaled) |
| <punw_out> | (output) point data stack of scaled unwrapped phase (float) |
| <rec_num_out> | record number of output scaled unwrapped phase |
| [ph_flag] | range phase ramp flag (default=0: unflattened, 1: flattened) |
EXAMPLE
scale_base_pt testsite.plist testsite.pmask testsite.ppar
testsite.ppos testsite.itab testsite.pbase testsite.punw1 3
testsite.punw2 5 0
Scales the input unwrapped interferometric phase (record 3 in testsite.punw1) according to the baselines of records 3 and 5, and writes out the scaled unwrapped phase to record 5 of testsite.punw2.
INSTALLATION
Source code scale_base_pt.c in ./IPTA/src, executable version
scale_base_pt in ./IPTA/bin
DESCRIPTION
scale_base_pt scales unwrapped phase images according to the
related baselines using the proportionality of the topographic
phase term with the perpendicular component of the baseline.
The coordinates of the points considered are defined in the point list. The optional mask file (in point data format) indicates for each point if it is valid (1, i.e. considered) or not valid (0, excluded).
Information required for the reference SLCs of the indicated interferometric pair(s) is provided in the stack of SLC parameter files.
Optionally, interpolated point position coordinates can be used instead of the integer coordinates from the point list.
Interferometric pairs are defined in the itab, an ascii file with a table associating interferogram stack records with pairs of SLC stack records. For each pair (line of itab, record of point data stacks) the stack of baseline parameters contains a record with the related baseline parameters which are the same parameters as used in the baseline parameter file, i.e. initial baseline, precision baseline, and phase constant.
The input unwrapped phase image is provided as a record of a point data stack.
Scaled unwrapped interferometric phases are calculated for each valid point of the point list. Valid points are points with a non-zero height value and a non-zero point mask value (if provided). In a first step the local perpendicular and parallel components are determined for a point. If non-zero the precision baseline is used, otherwise the initial baseline. The unwrapped phase is then scaled and the result written out to the indicated record in the output point data stack.
Input and output stacks may be identical.
A flag indicates if the unwrapped phases are unflattened (0) or the flattended (1), accordingly the scaling is adjusted.
To display the simulated interferometric phase images contained in the point data stack the programs pt2data or pt2d can be used to convert the point data to raster data format which can then be displayed using conventional display programs.
OPTIONS
To subtract a scaled phase image from an interferogram in a point
data stack the program sub_phase_pt can be used.
SEE ALSO
pt2data, pt2d,
sub_phase_pt, ipta.h.
© Copyrights for Documentation, Users Guide and Reference Manual by Gamma Remote Sensing, 2003.
UW, CW, TS, last change 20-Feb-2003.