Gamma ISP: Reference Manual


S1_burstloc

ANSI-C program: S1_burstloc.c

NAME
S1_burstloc - extract burst location and time information given in the Sentinel-1 annotation

SYNOPSIS
S1_burstloc <annotation_XML>

<annotation_XML> (input) Sentinel-1 L1 XML annotation file

EXAMPLE
S1_burstloc s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml

DESCRIPTION
S1_burstloc reads the burst location information from the Sentinel-1 annotation file of a given swath and polarization. The program then prints out a table of the start time of each burst and the geographic latitude and longitude of each corner. Each S1 SLC data product has a set of annotation XML files located in the annotation product directory. There are individual annotation files for each swath and polarization. For an image acquired over Montreal, Canada, these are the XML files contained in the annotation directory:

s1a-iw2-slc-vv-20200128t224415-20200128t224440-031007-038fbf-005.xml
s1a-iw1-slc-vh-20200128t224414-20200128t224440-031007-038fbf-001.xml 
s1a-iw3-slc-vh-20200128t224414-20200128t224439-031007-038fbf-003.xml
s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml
s1a-iw3-slc-vv-20200128t224414-20200128t224439-031007-038fbf-006.xml
s1a-iw2-slc-vh-20200128t224415-20200128t224440-031007-038fbf-002.xml

Note that the XML file name includes the swath (iw1, iw2, iw3) and the polarization (vv, vh).

An example of the output of S1_burstloc for the first swath (iw1) and VV polarization (vv):

S1_burstloc s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml
*** Print Burst information found in the Sentinel-1 annotation file ***
*** Copyright 2018, Gamma Remote Sensing, v1.2 4-Sep-2018 awi/cm ***
S1 XML annotation: s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml
Burst: s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml   1    135 IW1 VV 81856.42758411 45.04650886  0.00000000      44.97667280 -74.28317919      45.15654784 -74.33336168      45.29936492 -73.25512804      45.11940728 -73.20846578
Burst: s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml   2    135 IW1 VV 81859.19025211 45.21446346  0.16795460      45.14225699 -74.32936761      45.32211753 -74.37972641      45.46501279 -73.29822358      45.28506743 -73.25141484
Burst: s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml   3    135 IW1 VV 81861.94880811 45.38215805  0.16769459      45.30770460 -74.37568368      45.48742738 -74.42618611      45.63040277 -73.34139128      45.45059297 -73.29446655
Burst: s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml   4    135 IW1 VV 81864.70736511 45.54984270  0.16768465      45.47361598 -74.41680976      45.65332473 -74.46747461      45.79623635 -73.38008876      45.61643871 -73.33302942
Burst: s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml   5    135 IW1 VV 81867.46386611 45.71739240  0.16754971      45.63879096 -74.46336964      45.81860815 -74.51425153      45.96160374 -73.42351988      45.78169530 -73.37627663
Burst: s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml   6    135 IW1 VV 81870.22242211 45.88505707  0.16766467      45.80407555 -74.51013172      45.98400105 -74.56123326      46.12708280 -73.46712478      45.94706367 -73.41969540
Burst: s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml   7    135 IW1 VV 81872.98097911 46.05271188  0.16765481      45.96934656 -74.55706341      46.14913397 -74.60831677      46.29230393 -73.51080770      46.11242059 -73.46325530
Burst: s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml   8    135 IW1 VV 81875.73748011 46.22023185  0.16751997      46.13448068 -74.60413160      46.31437620 -74.65560925      46.45763662 -73.55466799      46.27764272 -73.50692547
Burst: s1a-iw1-slc-vv-20200128t224414-20200128t224440-031007-038fbf-004.xml   9    135 IW1 VV 81878.49603611 46.38786684  0.16763499      46.29972410 -74.65140856      46.47948137 -74.70304237      46.62283439 -73.59864210      46.44297641 -73.55077283

The different fields of the each line include the XML filename, burst number, track number, swath, polarization, start time of the burst, the sum of the argument of periapsis (perigee) + true anomaly, the change in true anomaly relative to the previous burst, and 4 coordinate pairs in latitude and longitude of the burst corners.  See the Wikipedia for an explanation of orbital elements: https://en.wikipedia.org/wiki/Orbital_elements.

SEE ALSO
ScanSAR_burst_corners, S1_import_SLC_from_zipfiles
UW, CW, TS, Copyright Gamma Remote Sensing AG, last change 13-Sep-2021