GAMMA Interferometric Point Target Analysis Software (IPTA): Reference Manual


mb_pt

ANSI-C programs: mb_pt.c

NAME
mb_pt -Calculate phase time series from a set of multi-reference unwrapped  point interferograms (mb stands for multi-baseline (temporal and spatial))

SYNOPSIS
mb_pt <plist> <pmask> <pSLC_par> <itab> <pdiff_in> <np_ref> <sigma> <itab_out> <pdiff_out> [pdiff_sim] [psigma_out] [hgt_flg] [hgt_out] [gamma] [SLC_ref_par]

<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)
<itab> (input) multi-reference table associating interferogram stack records with pairs of SLC stack records (ascii)
(line entries are: pSLC_rec1  pSLC_rec2  itab_rec_num  switch_flag)
<pdiff_in> (input) point data stack of unwrapped deformation phases for interferogram pairs specified in the itab (binary)
<np_ref> reference point number for the phase reference point(beginning from 0)
<sigma> (input) input values to calculate layer weights of the multi-reference input data for use in the  least-squares solution. (enter - for all equal to 1.0) (ascii)
<itab_out> (output) single-reference table associating output deformation stack records with pairs of SLCs (ascii).
(line entries are: pSLC_rec1  pSLC_rec2  itab_rec_num  switch_flag)
<pdiff_out> (output) unwrapped differential phase time series of single-reference stack defined in the itab_out file (float)
[pdiff_sim] (output) simulated unwrapped differential phases  for multi-reference stack defined in the itab which are calculated from the
optimized time-series solution. (enter - for none) (float)
[psigma_out] (output) standard deviation of the phase residuals  for each point (enter - for none) (float)
[hgt_flg]
estimate interferometric height corrections:
    0: no estimation of height correction from interferometric phase
    1: estimate height corrections using interferometric phase (default)

[hgt_out]
(output)height corrections calculated for each point
[gamma]
weighting factor for smoothing of the first deformation velocity: 0.500
[prate]
(output) deformation rate (radians/year )for the linear fit of the time-series (enter - for none)
[pconst]
(output) phase constant for the linear fit of the time-series (enter - for none)
[psigma_fit]
(output) standard deviation of the phase residuals relative to the linear fit (enter - for none)
[SLC_ref_par]
(input) SLC parameter file of the image used for geometric coregistration (enter - for none)

EXAMPLE
mb_pt pt pmsk pSLC_par itab_mb pdiffs_mb_unw 9179 - itab_ts pdiff_ts pdiff_mb_sim psigma_mb_ts 1 phgt_out 1.0 prate pconst psigma_fit 20030404.slc.par

generates the time series of unwrapped phase using the point list pt and unwrapped point differential interferograms pdiffs_mb_unw. The output itab is itab_ts, the output  time series of the phases is pdiff_ts. Simulated phase due to deformation estimated in the  time series solution are in the output stackpdiff_mb_sim. The standard deviation of the solution psigma_out is estimated using the residuals of the time series phase minus the input interferograms.  The height flag is set to 1 such that at each point a correction to height is determined.  Smoothing of the data is performed using a smoothing parameter value  gamma of 1.

A linear regression of the unwrapped phase is performed. The linear deformation phase rate is stored in the prate, the intercept at the start of the phase is stored in pconst, and the standard deviation of the phase series relative to the linear fit is stored in psigma_fit.

The SLC reference parameter file is required to determine the derivative of phase with respect to height if height corrections are being estimated.

DESCRIPTION
This program addresses the problem where you want to solve for the time-series of the deformation phase given a set of multi-reference unwrapped deformation phases. The input set of deformation phases are typically over specified such that more than one interferogram contains information from each of the SLCs in the input data set and that the observations can be linked together. Implicit is the idea that the total deformation phase at time t2 is the sum of deformations from t0 to t1 and from t1 to t2.  Therefore the total deformation phase at some time  time tn can be expressed as a linear combination of  measurements in the input data if tn is  exists in the set of input deformation phases and the the set of measurements is connected.

The program mb_pt generates a times-series of unwrapped deformation phase given a multi-temporal reference stack of unwrapped phases. The deformation phase data are derived from pairs of SLC images covering the time intervals of interest.  mb_pt estimates the deformation phase time-series using a weighted least-squares algorithm that minimizes the sum of squared weighted residual phases. The residuals are the differences between input  phases (the observations) and the differential phases derived from the time-series solution. Smoothing of the time series solution is acheived by introduction of constraints on the change in velocity as described by Schmidt and Burgmann (Journal of Geophysical Research,  VOL. 108, NO. B9, 2416, doi:10.1029/2002JB002267, 2003). Higher values of gamma lead to smoother solutions. Values of gamma =1 are moderately smoothed, while gamma=100 leads to an essentially linear deformation curve.

We also include estimation of a DEM height correction parameter (hgt_flg=1). The phase model includes a height related term proportional to the derivative of the interferometric phase with respect to height. This additional degree of freedom permits calculation of a height correction for all the interferograms that minimizes the phase residuals in a least-squares sense. If the value of the smoothing parameter is set to 0, then the value of the height correction will be very close to 0.0 since the phase can then be fully attributed to motion of the surface or atmosphere. Only when the smoothing parameter is > 0 can height corrections be calculated.  The height corrections are consistant over a range of values of the smoothing parameter gamma > 0.5.

Input to mb_pt is the multi-reference itab file that provides information on the pairs of SLCs used to create each of the interferogram layers in the diff_in stack. Also input is the stack of SLC parameters for the images referenced in the itab, and the corresponding unwrapped deformation phases diff_in. Typically the input deformation phases are from differential interferograms with the topographic and residual orbital phases removed. 

An  example of a multi-reference itab is:

1   3    1  1
1   4    2  1
1   5    3  1
3   5    4  1
4   7    5  1
4   8    6  1
5   7    7  1
5   9    8  1
6   8    9  1
6  10   10  1
6  11   11  1
  ...
22  25   35  1
22  27   36  1
23  27   37  1
24  27   38  1
25  27   39  1
25  28   40  1

The entries in the multi-reference itab were selected such that they satisfy specific criteria with respect to perpendicular baseline and time interval. The program  base_calc, can be used to construct the multi-reference  itab with entries that fulfill baseline, and time interval criteria. Note that the minimum time interval should be set to 1 day to avoid having auto-interferograms that contain no phase information.

Gaps in interferometric times series occur if there is no interferogram connecting different dates in the input data set.  In  a connected set of observations it is possible to synthesize an interferogram for any set of dates covered by the input measurements by taking a linear combination of the existing interferograms. If this is not possible then the network is not fully connected. The gap can be interpolated under the assumption that the phase rate does not change discontinously. Setting the smoothing parameter gamma > 0  adds a cost associated with a change in the deformation rate.  The least-squares minimization will then interpolate across the gap.  If no smoothing is performed, then the deformation rate will be 0 across the gap and lead to errors in the total deformation.

An example of an input itab with a temporal gap would be:

1   2    1  1
1   3    2  1
4   5    3  1
4   6    4  1

As can be seen by inspection  there is no interferometric phase information covering the period between the times when SLC-3 and SLC-4 were acquired. There is no connection between the interferometric data for acquisitions {1, 2, 3} and acquisitions {4, 5, 6} and hence there is no change in the output  time series phase during the time interval from SLC-3 to SLC-4. When the smoothing of the time series is performed then the gap interpolated with a function that minimizes the change in deformation rate before and after the gap.

The output deformation phase time-series is calculated at each acquisition time of SLCs used to create the input interferogram stack. The solution is only available for times covered in the input interferogram data set. The phase time-series values are obtained by summing up the phase contribution for each time interval from the start of the series. In the example, the output single reference itab_out has entries:

1   3    1  1
1   4    2  1
1   5    3  1
1   6    4  1
...
1  27    23  1
1  28    24  1

Note that each differential interferogram in the output is referenced to the time of the earliest scene in the series. By definition, the deformation is set to 0 at the initial epoch for the series. If phase values are desired for other times, then these can be obtained by interpolation using the program t_interp_pt. The phase series values can be converted to deformation along the line of sight (LOS) using the program dispmap_pt.

The program mb_pt uses Singular Value Decomposition (SVD) (see  http://en.wikipedia.org/wiki/Singular_value_decomposition ) to obtain the least-squares solution for the phase time-series. As part of the screen output mb_pt generates a list of the singular values of the design matrix constructed from the itab and observation times. The design matrix contains the coefficients of the set of linear equations that express the relationships between the observed phase data and the desired times series values. The number of singular values is equal to the number of  times in the output time series. If a value is less than the largest singular value/1.e5, the value is set to 0. A singular value indicates that the constraints in the design matrix are insufficient to fully define the output time series. Setting the singular value to zero forces the time-series output  to remain constant over the unconstrained gap in the input observations. 

mb_pt also calculates the set of simulated deformation phase for each of the input interferograms  using  the estimated deformation phase-time series. Subtracting the simulated deformation phase from the input interferogram leaves a combination of  residual baseline phase, noise, and phase unwrapping errors. This suggests the use of mb_pt  for iterative improvement of the processing results.  

Redundancy in the the differential interferogram input data reduces errors in the time-series due to phase errors due to baseline, topographic phase correction, and interferometric decorrelation. The effect of atmospheric phase on the other hand is not reduced by this estimation procedure. The reason for this is that the atmospheric phase cannot be distinguished from random deformation since it is directly related to path delay. The smoothing parameter gamma introduces an additional cost related to rapid changes in the phase. This permits independent estimation of a height correction for each point.

Individual interferogram layers in the input stack can be switched on and off using the switch_flag value (last column) in the input itab. Setting the switch_flag to 0 removes that particular layer from the solution. Note that if a particular acquisition occurs only in this layer, then it will not appear in the solution. Also realize that removing a particular interferogram has a good chance of destroying the connectivity of the input interferogram network causing a gap in the output  time-series. However even if the the switch_flag is set to 0 for a particular layer, the deformation phase for that layer is simulated when possible. The simulated phase can then be subtracted from the input interferogram and help with unwrapping that layer.  If the unwrapped phase for a single point is 0.0 in a layer  that is turned on (switch_flag = 1), then no time-series solution is generated for that point.

The output stack psigma_out contains an estimate of the standard deviation of time series phase values obtained from the residuals simulated phases pdiff_out and the input observations pdiff_in. For each point sigma is evaluated over the number of layers in the diff_in stack Contributions to the standard deviation include interferometric decorrelation, residual baseline error, and possibly phase unwrapping errors.

It is also possible to perform a linear regression of the the time-series phase. The slope of the linear regression is stored in the the prate file, the phase constant at relative time t=0 is stored in pconst, and the standard deviation of the phase relative to the linear fit in psigma_fit.

SEE ALSO
base_calc, dispmap_ptspf_pt, tpf_pt, t_interp_pt, mb, ipta.h.


© Copyrights for Documentation, Users Guide and Reference Manual by Gamma Remote Sensing, 2012.
UW, CW,TS, last change 11-Jun-2012.