ANSI-C program: SLC_mosaic_S1_TOPS.c
NAME
SLC_mosaic_S1_TOPS - Calculate SLC mosaic of Sentinel-1 TOPS
burst SLC data
SYNOPSIS
SLC_mosaic_S1_TOPS <SLC_tab> <SLC>
<SLC_par> <rlks> <azlks> [wflg]
| <SLC_tab> | (input) 3 column list of TOPS SLC swaths in row
order IW1, IW2, IW3: SLC_tab line entries: SLC SLC_par TOPS_par |
| <SLC> | (output) SLC mosaic image |
| <SLC_par> | (output) SLC mosaic image parameter file |
| <rlks> | number of range looks used to determine burst window boundaries for the mosaic |
| <azlks> | number of azimuth looks used to determine burst window boundaries for the mosaic |
| [wflg] | burst window calculation flag: 0: use existing burst window parameters if they exist, otherwise calculate burst window parameters (default) 1: calculate burst window parameters from burst parameters and the number of range and azimuth looks |
EXAMPLES
Mosaic the bursts in the TOPS mode SLC data specified by SLC_tab. The burst boundaries are calculated from the number of looks in range and azimuth, in this case 5 range looks and 1 azimuth looks. Alternately 10 range looks and 2 azimuth looks could be used.SLC_mosaic_S1_TOPS SLC_20140809_tab slc/20140809_vv.slc slc/20140809_vv.slc.par 5 1 1
Output is written to <SLC> and the parameters to
<SLC_par>
DESCRIPTION
SLC_mosaic_S1_TOPS mosaics a set of
SLC bursts from one data set to a single SLC file. The
input SLC_tab file is a
text file with one line for each SLC in the data set. Typically
there are 3 images for Sentinel-1 Interferometric Wide
Mode. The three columns correspond to the SLC data file
name, the SLC parameter file name and the TOPS_par file name. The
TOPS_par contains information on each burst in the burst
SLC. The SLC_tab can contain fewer than 3 records, and in
the case of Extended Wide mode, it can contain information for
the five sub-swaths.
Below are examples of the input SLC_tab: SLC_20140809_tab1
slc_TOPS/20140809_iw1_vv.slc
slc_TOPS/20140809_iw1_vv.slc.par
slc_TOPS/20140809_iw1_vv.tops_par
slc_TOPS/20140809_iw2_vv.slc
slc_TOPS/20140809_iw2_vv.slc.par
slc_TOPS/20140809_iw2_vv.tops_par
slc_TOPS/20140809_iw3_vv.slc
slc_TOPS/20140809_iw3_vv.slc.par
slc_TOPS/20140809_iw3_vv.tops_par
A segment of each burst is windowed on the basis of the number of range and azimuth looks. The width of the burst window is a multiple of the number of range looks and the height a multiple of the number of azimuth looks. In this way when a multi-look interferogram or MLI image is created for the mosaic, there is no mixing of pixels from different bursts in the multi-look result. The burst window is specified for each burst in the TOPS_par. The actual location in time of the burst varies from one burst to the next, so the burst window will also shift. The burst window parameters are described in the TOPS_par documentation. The burst window is calculated both in lines and pixels as well as slant-range and azimuth time. The bounds of the output mosaic SLC are first calculated from the available burst data. Critical is the location of the break between bursts both in azimuth time and slant rThe start and end of valid samples and lines are used to determine the cut location as close as possible to the center of the region of overlap with valid data consistent with the constraint that the window be have dimensions that are a multiple of rlks and azlks.
An example of SLC_mosaic_S1_TOPS for a single swath of Sentinel-1 data is shown below:
$ SLC_mosaic_S1_TOPS SLC_20140809_tab
slc/20140809_vv.slc slc/20140809_vv.slc.par 5 1 0
*** Calculate SLC mosaic of Sentinel-1 TOPS burst SLC data
***
*** Copyright 2014, Gamma Remote Sensing v2.7 6-Oct-2014 clw/awi
***
SLC_tab: SLC_20140809_tab
range looks used to determine burst data window:
5
azimuth looks used to determine burst data window: 1
NOTE: using previously calculated burst window parameters
if available
output S1 TOPS SLC mosaic image: slc/20140809_vv.slc
output S1 TOPS SLC mosaic parameter file:
slc/20140809_vv.slc.par
number of input SLC images: 1
S1 TOPS SLC file: slc_TOPS/20140809_iw1_vv.slc
SLC parameter file: slc_TOPS/20140809_iw1_vv.slc.par
TOPS parameter file: slc_TOPS/20140809_iw1_vv.tops_par
r0 (m): 800420.570 r2 (m): 849928.422 nr: 21253
rpix (m): 2.329562 t0 (s): 60946.535388 t2 (s):
60971.946175 nlines: 14661 time_per_line (s):
2.055556e-03
S1 TOPS SLC range sample spacing
(m): 2.32956
S1 TOPS SLC azimuth sample spacing (m): 13.96211
S1 TOPS SLC image range samples: 21253
S1 TOPS SLC image azimuth lines: 12363
maximum number of bursts in an SLC: 9
SLC 1 r0: 800420.5701 r1:
825174.4959 r2: 849928.4217 fvs:
152 lvs: 20633 r_fvs: 800774.6635
r_lvs: 848486.4228
SLC: 1 burst: 1 az_time:
60946.5354
lstart: 0.000
SLC: 1 burst: 2 az_time:
60949.3083 dtb (s): 2.77295 az_ovlp (s):
0.57556 az_ovlp (lines): 279.99973
lstart: 1629.000
nlb: 1629.0000
SLC: 1 burst: 3 az_time:
60952.0607 dtb (s): 2.75239 az_ovlp (s):
0.59611 az_ovlp (lines): 290.00092
lstart: 3258.000
nlb: 1629.0000
SLC: 1 burst: 4 az_time:
60954.8193 dtb (s): 2.75856 az_ovlp (s):
0.58995 az_ovlp (lines): 287.00027
lstart: 4887.000
nlb: 1629.0000
SLC: 1 burst: 5 az_time:
60957.5778 dtb (s): 2.75856 az_ovlp (s):
0.58994 az_ovlp (lines): 286.99833
lstart: 6516.000
nlb: 1629.0000
SLC: 1 burst: 6 az_time:
60960.3364 dtb (s): 2.75856 az_ovlp (s):
0.58994 az_ovlp (lines): 286.99979
lstart: 8145.000
nlb: 1629.0000
SLC: 1 burst: 7 az_time:
60963.0949 dtb (s): 2.75856 az_ovlp (s):
0.58995 az_ovlp (lines): 287.00027
lstart: 9774.000
nlb: 1629.0000
SLC: 1 burst: 8 az_time:
60965.8535 dtb (s): 2.75856 az_ovlp (s):
0.58995 az_ovlp (lines): 287.00027
lstart: 11403.000 nlb:
1629.0000
SLC: 1 burst: 9 az_time:
60968.5997 dtb (s): 2.74622 az_ovlp (s):
0.60228 az_ovlp (lines): 292.99962
lstart: 13032.000 nlb:
1629.0000
SLC: 1 burst: 1 burst_t0:
60946.5354 t2: 60949.8818 win_t0:
60946.5354 iaz0: 0 naz:
1481 win_t2: 60949.5776 loff:0
SLC: 1 burst: 2 burst_t0:
60949.3083 t2: 60952.6548 win_t0:
60949.5797 iaz0: 132 naz: 1349
win_t2: 60952.3506
SLC: 1 burst: 3 burst_t0:
60952.0607 t2: 60955.4072 win_t0:
60952.3526 iaz0: 142 naz: 1339
win_t2: 60955.1029
SLC: 1 burst: 4 burst_t0:
60954.8193 t2: 60958.1657 win_t0:
60955.1050 iaz0: 139 naz: 1342
win_t2: 60957.8615
SLC: 1 burst: 5 burst_t0:
60957.5778 t2: 60960.9243 win_t0:
60957.8636 iaz0: 139 naz: 1343
win_t2: 60960.6221
SLC: 1 burst: 6 burst_t0:
60960.3364 t2: 60963.6828 win_t0:
60960.6242 iaz0: 140 naz: 1342
win_t2: 60963.3807
SLC: 1 burst: 7 burst_t0:
60963.0949 t2: 60966.4414 win_t0:
60963.3827 iaz0: 140 naz: 1342
win_t2: 60966.1392
SLC: 1 burst: 8 burst_t0:
60965.8535 t2: 60969.2000 win_t0:
60966.1413 iaz0: 140 naz: 1342
win_t2: 60968.8978
SLC: 1 burst: 9 burst_t0:
60968.5997 t2: 60971.9462 win_t0:
60968.8998 iaz0: 146 naz: 1482
win_t2: 60971.9441
NOTE: using existing burst window parameters
SLC: 1 S1 TOPS file size (bytes): 2492721864
S1 TOPS SLC number of records: 14661
S1 TOPS number of records per burst: 1629
S1 TOPS number of bursts: 9
0 0 800420.5701
849921.4330 60946.53539
60949.57761 0
21250 0
1481
burst 1 burst window TOPS
line: 0
win_r0: 800420.570 win_ir0: 0
0 1 800420.5701
849921.4330 60949.57967
60952.35056 0
21250 132 1349
burst 2 burst window TOPS line:
1481 win_r0: 800420.570
win_ir0: 0
0 2 800420.5701
849921.4330 60952.35261
60955.10295 0
21250 142 1339
burst 3 burst window TOPS line:
2830 win_r0: 800420.570
win_ir0: 0
0 3 800420.5701
849921.4330 60955.10500
60957.86150 0
21250 139 1342
burst 4 burst window TOPS line:
4169 win_r0: 800420.570
win_ir0: 0
0 4 800420.5701
849921.4330 60957.86356
60960.62212 0
21250 139 1343
burst 5 burst window TOPS line:
5511 win_r0: 800420.570
win_ir0: 0
0 5 800420.5701
849921.4330 60960.62417
60963.38067 0
21250 140 1342
burst 6 burst window TOPS line:
6854 win_r0: 800420.570
win_ir0: 0
0 6 800420.5701
849921.4330 60963.38273
60966.13923 0
21250 140 1342
burst 7 burst window TOPS line:
8196 win_r0: 800420.570
win_ir0: 0
0 7 800420.5701
849921.4330 60966.14128
60968.89778 0
21250 140 1342
burst 8 burst window TOPS line:
9538 win_r0: 800420.570
win_ir0: 0
0 8 800420.5701
849921.4330 60968.89984
60971.94412 0
21250 146 1482
burst 9 burst window TOPS line:
10880 win_r0: 800420.570
win_ir0: 0
range samples: 21253 azimuth lines: 12363
output S1 TOPS SLC mosaic image: slc/20140809_vv.slc
output S1 TOPS SLC parameter file: slc/20140809_vv.slc.par
user time (s):
5.420
system time (s): 1.520
elapsed time (s): 16.490
SEE ALSO
SLC_par, typedef_ISP.h, TOPS_par