Sentinel 1 Product Specification
Sentinel 1 Product Specification
(signature / date)
CHANGE RECORD
From issue 1.0 to 2.9, the Sentinel-1 Product Specification was maintained by a consortium led
by MDA under the reference S1-RS-MDA-52-7441.
The S-1 IPF and associated documentation is then maintained by the S-1 Mission Performance
Centre. From the issue 3.0 the Sentinel-1 Product Specification is maintained by The S-1 Mission
Performance Center which is a consortium led by CLS.
TABLE OF CONTENTS
1 INTRODUCTION.......................................................................................................... 1-1
1.1 Purpose................................................................................................................. 1-1
1.2 Scope .................................................................................................................... 1-1
1.3 Document Structure ............................................................................................. 1-1
2 DOCUMENTS................................................................................................................ 2-1
2.1 Applicable Documents ......................................................................................... 2-1
2.2 Reference Documents .......................................................................................... 2-1
LIST OF FIGURES
LIST OF TABLES
Table 6-14 Summary of GeoTIFF Tags/Keys Used in Sentinel-1 Products ............................ 6-15
Table 6-15 L2 OCN Product .................................................................................................... 6-19
Table 6-16 L2 OCN Global Attributes .................................................................................... 6-22
Table 6-17 L2 OCN Dimensions ............................................................................................. 6-24
Table 6-18 L2 OSW Component Variables ............................................................................. 6-28
Table 6-19 L2 OWI Component Variables .............................................................................. 6-35
Table 6-20 L2 RVL Component Variables .............................................................................. 6-40
Table 6-21 Element - product .................................................................................................. 6-44
Table 6-22 Data Type - l1QualityInformationType ................................................................. 6-47
Table 6-23 Data Type - qualityDataListType .......................................................................... 6-47
Table 6-24 Data Type - qualityDataType................................................................................. 6-47
Table 6-25 Data Type - downlinkQualityType ........................................................................ 6-48
Table 6-26 Data Type - rawDataAnalysisQualityType ............................................................ 6-51
Table 6-27 Data Type - dopplerCentroidQualityType ............................................................. 6-51
Table 6-28 Data Type - imageQualityType.............................................................................. 6-52
Table 6-29 Data Type - imageStatisticsType ........................................................................... 6-52
Table 6-30 Data Type - l1GeneralAnnotationType ................................................................. 6-53
Table 6-31 Data Type - productInformationType .................................................................... 6-54
Table 6-32 Data Type - downlinkInformationListType ........................................................... 6-55
Table 6-33 Data Type - downlinkInformationType ................................................................. 6-55
Table 6-34 Data Type - bitErrorCountType ............................................................................. 6-56
Table 6-35 Data Type - downlinkValuesType ......................................................................... 6-58
Table 6-36 Data Type - dataFormatType ................................................................................. 6-59
Table 6-37 Data Type - rangeDecimationType ........................................................................ 6-59
Table 6-38 Data Type - swlListType ....................................................................................... 6-59
Table 6-39 Data Type - swlType.............................................................................................. 6-60
Table 6-40 Data Type - swstListType ...................................................................................... 6-60
Table 6-41 Data Type - swstType ............................................................................................ 6-60
Table 6-42 Data Type - pointingStatusListType ...................................................................... 6-60
Table 6-43 Data Type - pointingStatusType ............................................................................ 6-61
Table 6-44 Data Type - orbitListType ..................................................................................... 6-61
Table 6-45 Data Type - orbitType............................................................................................ 6-62
Table 6-46 Data Type - positionType ...................................................................................... 6-62
Table 6-47 Data Type - velocityType ...................................................................................... 6-62
Table 6-48 Data Type - attitudeListType ................................................................................. 6-63
Table 6-49 Data Type - attitudeType ....................................................................................... 6-63
Table 6-50 Data Type - rawDataAnalysisListType.................................................................. 6-64
Table 6-51 Data Type - rawDataAnalysisType ........................................................................ 6-64
Table 6-52 Data Type - rawDataAnalysisSupportType ........................................................... 6-65
Table 6-53 Data Type - replicaInformationListType ............................................................... 6-66
Table 6-54 Data Type - replicaInformationType ..................................................................... 6-66
Table 6-55 Data Type – referenceReplicaType ....................................................................... 6-66
ESA Unclassified – For Official Use
(xviii)
Ref: S1-RS-MDA-52-7441
MPC Nom: DI-MPC-PB
Sentinel-1 MPC Ref:
Issue/Revision:
MPC-0240
3/5
Date: 19/04/2018
PG Product Generation
PNG Portable Network Graphics
pol. Polarisation
PRF Pulse Repetition Frequency
PRI Pulse Repetition Interval
RDA Raw Data Analysis
RDS Representation Data Set
RGB Red Green Blue
RID Review Item Disposition
RMS root mean squared
RVL Radial Surface Velocity
S-1 Sentinel-1
SAR Synthetic Aperture Radar
SAS SAR Antenna Sub-system
SES SAR Electronic Sub-system
SI International System of Units
SLC Single Look Complex
SM Stripmap
SOW Statement of Work
SPPDU Space Packet Protocol Data Unit
SWL Sampling Window Length
SWST Sampling Window Start Time
TBC To Be Confirmed
TBD To Be Determined
TIFF Tag Image File Format
TOPSAR Terrain Observation with Progressive Scanning SAR
Tx Transmit
URL Uniform Resource Locator
UTC Universal Time Coordinated
VH Vertical Horizontal polarisation
VV Vertical polarisation
W3C World Wide Web Consortium
WGS 84 World Geodetic System (1984)
WV Wave
ESA Unclassified – For Official Use
(xxiii)
Ref: S1-RS-MDA-52-7441
MPC Nom: DI-MPC-PB
Sentinel-1 MPC Ref:
Issue/Revision:
MPC-0240
3/5
Date: 19/04/2018
1 INTRODUCTION
This section introduces the purpose, scope and structure of the document.
1.1 Purpose
This document defines the detailed product format for all Sentinel-1 Level 1 (L1)
and Level 2 (L2) products. It specifies the content and format of the products
generated by the Sentinel-1 Instrument Processing Facility (IPF).
1.2 Scope
This document specifies the content and format of Sentinel-1 L1 and L2 products for
the four Sentinel-1 Synthetic Aperture Radar (SAR) acquisition modes: Stripmap
(SM); Interferometric Wide Swath (IW); Extra Wide Swath (EW); and Wave (WV).
The performance and characteristics for each of the products in the Sentinel-1
product family are detailed in the Sentinel-1 Product Definition [A-3]. The
definition of Level 0 (L0) products is contained in the Sentinel-1 L0 Product Format
Specification [R-8] and is not part of this document.
The Sentinel-1 product schema files form the definitive source for the content and
format of Sentinel-1 products. The schema files are included in Appendix A and are
distributed with every Sentinel-1 L1 and L2 product.
• Section 5 defines the collections of data sets from Section 6 that make up each
Sentinel-1 L2 product;
• Section 6 describes the contents and format of each Sentinel-1 L1 and L2 data
set. This section presents an abstract view of the details of each data set
contained in the schemas defined in Appendix A and is intended for users of
all levels;
• Appendix A contains the eXtensible Markup Language (XML) schema files
that define the content and format of all Sentinel-1 L1 data sets. The XML
schema files are the definitive source for the Sentinel-1 L1 product format.
This section is intended for an audience with an understanding of XML
Schema.
Within this document, Sections 1 and 2 are independent and stand-alone in the
respect that they do not rely on other sections within the document for context;
however, Sections 3 through 6 and Appendix A deserve special attention because
inter-dependencies do exist between these sections of the document. Figure 1-1
presents a graphical view of the structure of the sections described in the list above
and the relationships between each.
Section 1
INTRODUCTION
Section 2
DOCUMENTS
Section 3
PRODUCT FORMAT OVERVIEW
Introduces Introduces
Section 4 Section 5
LEVEL 1 PRODUCT SPECIFICATION LEVEL 2 PRODUCT SPECIFICATION
Describe Describe
Section 6
PRODUCT DATA SETS
Is composed of Is composed of
Appendix A
PRODUCT SCHEMAS
2 DOCUMENTS
The following documents of the date/revision indicated form part of this document
to the extent referenced herein.
The following documents provide useful reference information associated with this
document. These documents are to be used for information only and changes to the
date/revision number (if provided) shall not make this document out of date.
The objectives of this specification are to define a Sentinel-1 product format for the
L1 and L2 products defined in the Sentinel-1 Product Definition [A-3] that:
• applies to Sentinel-1 L1 and L2 products;
• contains the complete set of parameters and annotations required for
calibration, analysis, quality assessment and post-processing of the product;
• supports the harmonisation of product formats across a multitude of Global
Monitoring for Environment and Security (GMES) missions;
• supports a computer-based approach for validation of the consistency and
content of the product; and,
• uses technologies that are current and widely supported to ensure ease of use
for end users.
In order to meet these objectives the Sentinel-1 product format leverages the
following key concepts:
• the product format is based on SAFE, an XML-based format that has the
following advantages:
• XML is an ASCII based language that is both human and machine
readable;
• XML is widely supported by Commercial off the Shelf (COTS) tools
including image processors, databases, browsers and translators;
• XML supports a computer based approach to format and content
validation through the use of XML schema files;
• SAFE uses a data wrapping technique that provides the flexibility to
support any binary data format (making the format scalable enough to
represent all levels of Sentinel-1 products);
• SAFE is endorsed as the recommended product format for the
harmonisation of products across GMES missions by the GMES Product
Harmonisation Study;
• the product annotations are based on ENVISAT ASAR heritage, have been
augmented to include the specialisations required to fully support Sentinel-1
and have been enhanced by the experience from other SAR missions like
RADARSAT-2 and TerraSAR-X; and
• the data formats selected to represent images and measurement data (GeoTIFF,
PNG, NetCDF) within the products are based on industry standard formats.
The Sentinel-1 IPF supports the generation of L1 and L2 products for the following
four SAR acquisition modes:
• Stripmap (SM) – A standard SAR stripmap imaging mode where the ground
swath is illuminated with a continuous sequence of pulses while the antenna
beam is pointing to a fixed azimuth and elevation angle. Refer to Section
3.3.1 of [A-3] for a detailed description of SM.
• Interferometric Wide Swath (IW) – Data is acquired in 3 swaths using the
Terrain Observation with Progressive Scanning SAR (TOPSAR) imaging
technique. In IW mode bursts are synchronised from pass to pass to ensure the
alignment of interferometric pairs. Refer to Section 3.3.2 of [A-3] for a
detailed description of IW.
• Extra Wide Swath (EW) – Data is acquired in 5 swaths using the TOPSAR
imaging technique. EW mode provides very large swath coverage at the
expense of spatial resolution. Refer to Section 3.3.3 of [A-3] for a detailed
description of EW.
• Wave (WV) – Data is acquired in small stripmap scenes called “vignettes”,
situated at regular intervals of 100 km along track. The vignettes are acquired
in ‘leap frog’ mode; i.e., one vignette is acquired at a near range incidence
angle while the next vignette is acquired at a far range incidence angle. Refer
to Section 3.3.4 of [A-3] for a detailed description of WV.
• Elevation Notch (EN) and Azimuth Notch (AN) – The notch acquisition
modes are instrument calibration modes used for the determination of
elevation pointing. They are fully based on SM acquisition parameters with the
main difference being the excitation coefficients used during the acquisition of
measurement data.
The Sentinel-1 IPF is capable of generating a family of Level 1 and Level 2 products
from the four SAR measurement modes and the tree illustrating the Sentinel-1
family of products is presented in Figure 3-1.
SLC
FR
SM/EN/AN GRD HR
MR
OCN
SLC
IW GRD HR
MR
OCN
SLC
EW GRD HR
MR
OCN
SLC
WV GRD MR
OCN
SLC products are images in the slant range by azimuth imaging plane, in the image
plane of satellite data acquisition. Each image pixel is represented by a complex (I
and Q) magnitude value and therefore contains both amplitude and phase
information. The processing for all SLC products results in a single look in each
dimension using the full available signal bandwidth. The imagery is geo-referenced
using orbit and attitude data from the satellite.
GRD products lie in the ground range by azimuth surface, with image coordinates
oriented along ground range and flight direction. To convert from imaging slant
range coordinates to ground range coordinates, a slant to ground projection is
performed onto an ellipsoid (typically the WGS84 ellipsoid) corrected using terrain
height, which varies in azimuth and is constant in range. The standard GRD products
are detected, multi-look products, with approximately square resolution cells and
square pixel spacing. Multi-looking is a processing property that results in images
with reduced speckle, but also with reduced resolution: the more looks the less
speckle noise and the lower the resolution.
The resolution of SLC products is determined by the acquisition mode; however, the
GRD products can be further classified into a resolution class characterised by the
acquisition mode employed as well as by the level of multi-looking performed
during processing:
• Full Resolution (FR) products;
• High Resolution (HR) products; and
• Medium Resolution (MR) products.
For detailed descriptions of the properties and characteristics of each product type
for the various modes, refer to [A-3].
The IPF is also capable of generating Annotation products for the L1 SLC and GRD
product types. Annotation products are generated for internal PDGS purposes and
are not distributed externally to users.
L1 Annotation products are generated using the same processing as the “nominal”
products and so are identical to the nominal products except that they contain only
the product annotations and exclude the image MDS; this results in a product
containing all the metadata but with a significantly reduced data volume. For SM,
IW and EW modes annotation products may contain a Quick-look image for a visual
reference of the product scene coverage. For detailed descriptions of the properties
and characteristics of each product type for the various modes, refer to [A-3].
For L2 products, the metadata in the annotation product is based on the internal L1
SLC product that was used as input to the L2 Processor.
The Sentinel-1 IPF is capable of generating an L2 Ocean (OCN) product from input
L1 products (note that these input SLC and GRD products are produced using
different parameters than standard L1 products, specifically for the purpose of L2
processing). The L2 OCN product is composed of three components: an Ocean
Swell Spectra (OSW) component; an Ocean Wind Field (OWI) component; and, a
Radial Velocity (RVL) component. Each of the three components is described in the
subsequent sections (respectively).
The OSW component of the OCN product is a two-dimensional ocean surface swell
spectra estimated from a Level 1 SLC image. The OSW component also contains
one estimate of the wind speed and direction per ocean swell spectrum, as well as
parameters derived from the ocean swell spectra (integrated wave parameters) and
from the vignette (image statistics).
Refer to Section 6.2.1.1 of [A-3] for the detailed description and definition of the L2
OSW component.
The OWI component of the OCN product is a ground-range gridded estimate of the
surface wind speed and direction at a height of 10 m above the ocean surface,
derived from an input L1 GRD image from SM, IW or EW mode. Refer to Section
6.2.1.2 of [A-3] for the detailed description and definition of the L2 OWI
component.
The RVL component of the OCN product is calculated based on the difference
between the measured L2 Doppler grid and the geometrical Doppler calculated by
the L1 processor. The measured L2 Doppler grid accounts for the antenna
mispointing Doppler by including the antenna error matrix in the antenna model
synthesis. The RVL estimates are produced on a ground-range grid, although the
input product is SLC.
Refer to Section 6.2.1.3 of [A-3] for the detailed description and definition of the L2
RVL component.
This section describes the high-level format and structure that is applicable to all
Sentinel-1 L1 and L2 products. The term “product” simply refers to a directory
folder that contains a collection of information. Sentinel-1 products contain related
information grouped together into files referred to as data sets, and data sets are
collected and grouped together to form a complete product.
The Sentinel-1 product format is a specialisation of the SAFE format and thus
inherits its information, logical, and physical models from the SAFE standard. One
of the key advantages of the SAFE format is its ability to capture how the
information in a product is logically interconnected and validated; however, the
focus of this product specification document is to present the physical structure and
composition of Sentinel-1 products.
The detailed implementation of the SAFE format for Sentinel-1 products is managed
in the XML schema files contained in Appendix A. The purpose of this document is
to clearly and concisely convey the Sentinel-1 product format in a manner that
allows the user to gain understanding without knowledge of the details at the XML
schema level; that is:
• this document deals with what information is contained in a product and where
it is located; and
• the schema files in Appendix A define the detailed product format as a SAFE
specialisation.
1..1
Manifest
File
Describe Define
Define (optionally)
Every Sentinel-1 product contains a manifest file, which can be thought of as the top
level of each product as it describes the content and the structure of the product.
The product data and metadata are contained in data set records (DSR). Data set
records are composed of nested structures that contain fields of information logically
related and grouped together within the DSR. Data set records are logically grouped
together to form files called data sets (DS). The structure and content of one type of
DSR is always the same; however, a dataset may contain multiple different types of
DSRs. For example, the L1 Product Annotation Data Set (ADS) describes the
properties of the product. The information fields in this data set are grouped into the
DSRs to which they apply; for example, the fields describing the general properties
of the product are found in the generalAnnotation DSR while the Doppler
information is found in the dopplerCentroid DSR. The generalAnnotation and
dopplerCentroid DSRs differ in structure and content because of the information that
each contains; however, all generalAnnotation DSRs are identical to each other in
structure and content and all dopplerCentroid DSRs are identical to each other in
structure and content. These rules apply to all DSRs within Sentinel-1 products.
ESA Unclassified – For Official Use
(3-7)
Ref: S1-RS-MDA-52-7441
MPC Nom: DI-MPC-PB
Sentinel-1 MPC Ref:
Issue/Revision:
MPC-0240
3/5
Date: 19/04/2018
This concept differs from the ENVISAT product format in which the structure of all
DSRs within a data set is the same.
In addition to physical data sets, Sentinel-1 products also contain information called
resources. Resources are any data that have a direct influence over how the product
was created, such as input files and auxiliary or external data files. Resources are
not physically included in the product but are identified by special fields in the
manifest file. Resources are described in more detail in Section 3.3.5.
This section introduces the components and data sets that may be included in a
Sentinel-1 product.
The manifest file is an XML file that forms the core of every Sentinel-1 product.
The manifest file serves two important purposes within the product:
1. It contains information about the collection of data sets that comprise the
product, the nature of each data set and how the data sets relate to one another;
and
2. It contains general information about the product that is useful for cataloguing
and identification purposes.
The manifest file can be thought of as the map of each product and there is one
manifest file present in every product.
Table 3-1 introduces the Annotation Data Set Records (ADSR) contained in the
manifest file for Sentinel-1 products and a more detailed description of the structure
of, and the information contained in the manifest file is presented in Section 6.1.
ESA Unclassified – For Official Use
(3-8)
Ref: S1-RS-MDA-52-7441
MPC Nom: DI-MPC-PB
Sentinel-1 MPC Ref:
Issue/Revision:
MPC-0240
3/5
Date: 19/04/2018
Information Package The information package map contains a high-level textual description of 6.1.1
Map the product and references to all of the MDS and ADS contained within
the product.
Metadata Section The metadata section contains a minimal set of wrapped product metadata 6.1.2
that can be used for product identification and cataloguing and it also
contains references to each of the ADS contained within the product.
Data Object Section The data object section contains references to the physical location of each 6.1.3
MDS and ADS file comprising the product with a description of the file
format, file location and checksum of each file.
The content and format of the measurement data sets is described in detail in Section
6.2; however, in order to provide context for the following sections, Table 3-2
introduces the measurement data sets and provides a general description of the
content and format of each.
L1 Image Image data sets contain SAR data that has been processed GeoTIFF 6.2.1
into an image.
Quick look Image Quick look image data sets are an averaged, decimated PNG 6.2.2
version of the image data set that results in a smaller image
file that is suitable for previewing products.
L2 Ocean The L2 Ocean data set contains an Ocean Swell Wave NetCDF 6.2.3
Spectra (OSW), an Ocean Wind Field (OWI) and a Radial
Surface Velocity vector (RVL) estimated from input L1
SAR images (note that these input L1 SLC and GRD
products are produced using different parameters than
standard L1 products, specifically for the purpose of L2
processing).
Annotation data sets are files that contain metadata – data that describes other data –
that describe characteristics of the product.
The general structure and content of the annotation data is described in detail in
Section 6; however, Table 3-3 introduces the different types of annotation data sets
and provides a general description of the information contained in each. Table 3-4
introduces all of the Annotation DSRs (ADSR) that may be included in the Level 1
Product Annotation DS and within Section 4 the exact ADSR included with each
specific product is detailed.
Level 1 Product Annotation The Level 1 product annotation data set contains the metadata 6.3.1
that describes the main characteristics of the product such as:
A2
state of the platform during acquisition, image properties,
Doppler information, geographic location, etc. A summary of
annotation data set records included in the product annotation
data set is presented in Table 3-4.
Level 1 Calibration The calibration data set contains calibration information and the 6.3.2
beta nought, sigma nought, gamma and digital number (DN)
A3
Look-up Tables (LUT) that can be used for absolute product
calibration.
Level 1 Noise The noise data set contains the estimated thermal noise LUT. 6.3.3
A4
Map Overlay The map overlay data set includes information about the 6.3.4
geographic coverage of the product.
Product Preview The product preview data set presents a graphical overview of 6.3.5
the product using the Quick-look image MDS and provides
access to the data sets contained within the product through
hyperlinks.
Quality Information The quality information data set represents a summary of quality flags 6.3.1.1
and values for information extracted from other data set records.
General Annotation The general annotation data set record contains a summary of 6.3.1.2
information extracted from the downlink echo, calibration and noise
packets used to generate all Level 1 products.
Image Annotation The image annotation data set record contains properties and 0
parameters for all Level 1 slant range and ground rage images.
Doppler Centroid The Doppler centroid (DC) data set record contains the Doppler 6.3.1.4
centroid estimate (DCE) list, which contains the Doppler estimates
calculated from orbit geometry and data analysis. These estimates are
used by the IPF during image processing and focusing.
Antenna Pattern The antenna pattern data set record contains a list of vectors of the 6.3.1.5
antenna elevation pattern values that have been updated along track
and used to correct the radiometry during image processing.
Swath Timing The swath timing data set record contains information for each burst 6.3.1.6
within a swath for TOPSAR products and is specific to IW and EW
SLC products. The purpose of the information included in this file is
to allow users of IW and EW products to extract bursts from the
image files included with the product.
Geolocation Grid The geolocation grid data set record contains a matrix of points 6.3.1.7
defining the slant range time, incidence angle, and geodetic latitude
and longitude positions at various range and azimuth positions within
the image.
Coordinate Conversion The coordinate conversion data set record contains information 6.3.1.8
required to perform the conversions between the slant-range and
ground-range coordinate systems. This DSR is present only if slant
range to ground range conversion was performed during processing.
Swath Merging The swath merging data set record contains information about how 6.3.1.9
multiple swaths were stitched together to form one large contiguous
swath. This data set record only applies to IW and EW GRD
products.
The representation data sets define the detailed format and content of the datasets
within the Sentinel-1 products using XML Schema [R-3] and [R-4] and implement
the Sentinel-1 specialisations of the SAFE specification. Each representation data
set is an XML formatted schema file with ASCII encoding and an “.xsd” file
extension.
Representation data sets are included with every Sentinel-1 product and may be used
by image processors to interpret and manipulate measurement and annotation data
sets and can be used by XML validation tools to validate the format and content of
the annotation data sets. Table 3-5 below describes the Sentinel-1 L1 and L2 datasets
and indicates whether or not each has an associated RDS.
3.3.5 Resources
Resources are data that are not physically included in the product but are
fundamentally applicable to the generation of the product, such as:
• the L0 input product and all of its applicable resources;
• the software name and version used to process the product; and
• the auxiliary data used to generate the product.
As mentioned above, resources are not included with the product but are referenced
by file name, with an entry in the manifest file. The content and format of each
resource is governed by its applicable documentation and is beyond the scope of this
specification.
Section 3.4.1 introduces the concept of slice products and describes the methods for
combining a set of slice products into an assembled product. Sections 3.4.2, 3.4.3,
and 3.4.4 describe specifically how information is combined into an assembled
product for the manifest file, the measurement data sets and the annotation data sets
(respectively).
Note that representation data sets do not require any assembly because they define
the structure and content of the data sets and do not themselves include any
measurement data or metadata.
3.4.1 Overview
In both cases the output products are fully formatted Sentinel-1 L1 products
compliant with the format defined in this specification and the properties of L1 slice
products within a set are such that:
• All slices are generated using the same set of processing parameters;
• The image data is continuous in terms of geometry, radiometry and phase; and
• The annotations are coherent in terms of update rate and grid spacing.
The Sentinel-1 product format has been designed to support individual scene
products, slice products and the scenario where a set of slice products is combined
into an assembled product.
The following list introduces the three strategies for combining sliced products into
an assembled product. These are used throughout the remainder of the document:
• Include – the value of the information is identical for all slices and a single
occurrence of the value is copied into the assembled product;
• Merge – the value of the information may differ between slices and a single
value must be amalgamated into the assembled product using the values from
all slices (the exact method for how this is done is described in the following
sections on a field-by-field basis; e.g., averaging, majority polling, summing,
etc.); and
• Concatenate – the information is stored in list format and the values from each
slice are appended to the appropriate list in the assembled product in Zero
Doppler Time (ZDT) ordered sequence and the list count attribute is updated
to contain the number of items in the concatenated list.
3.4.1.1 Include
The include strategy is used when the value of the field is identical for all slices.
This means that without loss of generality the value for the field can be taken from
any slice. A practical approach is to always take the value from the first slice. In the
example illustrated in Figure 3-3 below, the four fields: missionId, productType,
polarisation, and swath from the adsHeader DSR are shown for a set of slice
products containing N slices numbered 1 .. N. The example shows that the values for
each field are identical for all slices and are taken from the first slice and included in
the assembled product.
Slice1 SliceN
product product
adsHeader adsHeader
<product> <product>
<adsHeader> <adsHeader>
<missionId>S1A</missionId> <missionId>S1A</missionId>
<productType>SLC</productType> <productType>SLC</productType>
<polarisation>HH</poplarisation> <polarisation>HH</poplarisation>
<swath>S3</swath> <swath>S3</swath>
. . . . . .
</adsHeader> </adsHeader>
. . . . . .
</product> </product>
INCLUDE
Assembled Product
product
adsHeader
missionId = “S1A”
productType = “SLC”
polarisation = “HH”
swath = “S3”
<product>
<adsHeader>
<missionId>S1A</missionId>
<productType>SLC</productType>
<polarisation>HH</poplarisation>
<swath>S3</swath>
. . .
</adsHeader>
. . .
</product>
3.4.1.2 Merge
The merge strategy is used when the field is unique within the product (i.e. there is
only one occurrence of the field within the product) and the value of the field differs
between slices. Depending on the nature of the value of the field within the slices,
different approaches apply when merging the values for fields. These approaches are
explained in the sections below on a field-by-field basis.
In the example illustrated in Figure 3-4, the two fields: startTime and stopTime from
the adsHeader DSR are shown for a set of slice products containing N slices
numbered 1 .. N. These fields are unique within each product and the example shows
that the values for each field differ between slices. To merge the startTime field, the
value is taken from the first slice (Slice1) and to merge the stopTime field, the value
is taken from the last slice (SliceN) as shown in the figure.
Slice1 SliceN
product product
adsHeader adsHeader
... ...
... ...
<product> <product>
<adsHeader> <adsHeader>
. . . . . .
<startTime> <startTime>
2010-10-27T09:30:47Z 2010-10-27T09:31:46Z
</startTime> </startTime>
<stopTime> <stopTime>
2010-10-27T09:30:58Z 2010-10-27T09:31:57Z
</stopTime> </stopTime>
. . . . . .
</adsHeader> </adsHeader>
. . . . . .
</product> </product>
MERGE
Assembled Product
product
adsHeader
...
startTime = “2010-10-27T09:30:47Z”
stopTime = “2010-10-27T09:31:57Z”
...
<product>
<adsHeader>
. . .
<startTime>2010-10-27T09:30:47Z</starTime>
<stopTime>2010-10-27T09:31:57Z</stopTime>
. . .
</adsHeader>
. . .
</product>
3.4.1.3 Concatenate
The concatenate strategy is used when the field or record is contained within a list.
This applies to both binary image data as well as XML annotation data.
For imagery data, the binary data from each slice is appended in order and any
applicable length (azimuth) dimension is updated to reflect the length of the
assembled image. The image width can vary from azimuth line to azimuth line and
this must be considered when assembling the final output image. The pixels should
be assembled in range time order and padding – zero-fill, for example – should be
applied for missing range pixels. A conceptual example of assembling imagery data
is illustrated in Figure 3-6.
For XML annotations, lists within a data set are always suffixed with the word
“List” and always contain an integer attribute named “count” that identifies the
number of items within the list. In general, concatenation is simply appending
records to the list in time ordered sequence and updating (merging in a sense) the
count attribute to identify the total number of items in the concatenated list.
Concatenation of any list within a data set is done at the highest level at which a list
exists. For example, if aList contains a record named aRecord and aRecord contains
a list named bList, concatenation is always performed on aList. To ensure data
completeness within each slice it is possible that list entries may be duplicated near
the time boundaries of consecutive slices. Duplicate list entries will always have the
exact same azimuthTime value and can be identified in this way. In terms of
handling duplicate entries in the assembled output product, they could be trimmed to
one entry in the assembled output product, or they could simply be left as duplicates
in the assembled output product. This specification makes no recommendation on
the approach for the handling of duplicates; the decision on how to handle duplicate
list entries is left to the discretion of the assembler.
In the example illustrated in Figure 3-5 below, the Doppler annotations for the slices
are concatenated. For sake of example the data segment is 60 seconds long and
divided into 6 slices of 10 seconds each, numbered 1 .. 6. The Doppler centroid
estimates are done every 5 seconds creating 2 estimates per slice and a total of 12
estimates over all the slices. For compactness, only the information for the first slice
and last slice are shown in the graph. The figure shows the dcEstimateList from the
first and last slice with two dcEstimate records under each. In both cases the value of
the count attribute is 2. For the assembled product, the figure shows how the
dcEstimateList has grown because the dcEstimate records from each slice have been
added and the value of the count attribute is set to 12.
Slice1 Slice6
product product
dopplerCentroid dopplerCentroid
dcEstimateList dcEstimateList
dcEstimate dcEstimate
t0 = 7.265845301551916e+06 t0 = 7.265845301551916e+06
... ...
...
dcEstimate dcEstimate
t0 = 7.265845301551916e+06 t0 = 7.265845301551916e+06
... ...
<product> <product>
. . . . . .
<dopplerCentroid> <dopplerCentroid>
<dcEstimateList count=”2”> <dcEstimateList count=”2”>
<dcEstimate> <dcEstimate>
<azimuthTime> <azimuthTime>
2010-10-27T09:30:47Z 2010-10-27T09:31:46Z
</azimuthTime> </azimuthTime>
<t0>7.265845301551916e+06</t0> ... <t0>7.265845301551916e+06</t0>
. . . . . .
</dcEstimate> </dcEstimate>
<dcEstimate> <dcBlock>
<azimuthTime> <azimuthTime>
2010-10-27T09:30:52Z 2010-10-27T09:31:51Z
</azimuthTime> </azimuthTime>
<t0>7.265845301551916e+06</t0> <t0>7.265845301551916e+06</t0>
. . . . . .
</dcEstimate> </dcEstimate>
</dcEstimateList> </dcEstimateList>
</dopplerCentroid> </dopplerCentroid>
. . . . . .
</product> </product>
CONCATENATE
Assembled Product
product <product>
. . .
<dopplerCentroid>
dopplerCentroid <dcEstimateList length=”12”>
<dcEstimate>
dcEstimateLis <azimuthTime>
2010-10-27T09:30:47Z
t </azimuthTime>
@count = “12” <t0>7.265845301551916e+06</t0>
. . .
</dcEstimate>
dcEstimate <dcEstimate>
<azimuthTime>
azimuthTime = “2010-10-27T09:30:47Z” 2010-10-27T09:30:52Z
</azimuthTime>
<t0>7.265845301551916e+06</t0>
t0 = 7.265845301551916e+06 . . .
</dcEstimate>
<!-- 2 dcEstimate records for Slice2 -->
... <!-- 2 dcEstimate records for Slice3 -->
<!-- 2 dcEstimate records for Slice4 -->
<!-- 2 dcEstimate records for Slice5 -->
<dcEstimate>
<azimuthTime>
dcEstimate
2010-10-27T09:31:46Z
</azimuthTime>
azimuthTime = “2010-10-27T09:30:52Z” <t0>7.265845301551916e+06</t0>
. . .
</dcEstimate>
t0 = 7.265845301551916e+06 <dcEstimate>
<azimuthTime>
2010-10-27T09:31:51Z
... </azimuthTime>
<t0>7.265845301551916e+06</t0>
. . .
</dcEstimate>
</dcEstimateList>
<!-- 2 dcEstimate records for Slice2 --> </dopplerCentroid>
. . .
<!-- 2 dcEstimate records for Slice3 --> </product>
dcEstimate
azimuthTime = “2010-10-27T09:31:46Z”
t0 = 7.265845301551916e+06
...
dcEstimate
azimuthTime = “2010-10-27T09:31:51Z”
t0 = 7.265845301551916e+06
...
Table 3-6 describes the assembly strategy on a field-by-field basis for the Manifest
file at the granularity needed to create an assembled product. Note that only fields
with a variable value are mentioned in the table. The strategy for fields with a
constant value is always “include” so they have been omitted from the table.
Data Object Section The data object section is assembled by merging each dataObject as 6.1.3
follows:
• The ID attribute may be merged by updating its value based on
filename of the object within the assembled product;
• The href attribute of the byteStream element is merged by updating
its value so that it points to the filename of the object within the
assembled product;
• The checksum element of the byteStream element is merged by re-
calculating the checksum on the object file within the assembled
product;
• The size attribute of the byteStream element is merged by setting its
value to the size of the object file within the assembled product.
Table 3-7 describes the assembly strategy on a field-by-field basis for the L1 image
MDS at the granularity needed to create an assembled product. Note that only fields
with a variable value are mentioned in the table. The strategy for fields with a
constant value is always “include” so they have been omitted from the table. The
reference column in the table indicates the section where the field is described.
Figure 3-6 illustrates the process of assembling the information in an L1 image
MDS.
L1 Image TIFF/GeoTIFF header tags are included and merged. Details are provided 6.2.1
in Table 3-8.
Measurement (image) data is concatenated.
Quick look Image The PNG header is merged by setting the Width field to the maximum 6.2.2
range extent across all the slices and summing the Height field for all
slices. All other header fields are included.
Measurement (image) data is concatenated.
Note: For IW and EW SLC images, the Quick-Look image for a slice will
contain black fill at the start and end of the image that varies for each
swath. This is due to the fact that the SLCs consist of staggered bursts
from multiple swaths, so that the edges of the Quick-Look image of a slice
must be padded out so that all swaths start and end at the same line. As a
result, the concatenated Quick-Look images from IW and EW SLC slices
will also contain extra padding at slice boundaries, and the resulting
Quick-Look image will be longer than the concatenated full resolution
Quick-Look image. In addition, if a KML bounding box is used to
overlay the IW/EW Quick-Look on a map, due to the mismatch in image
dimensions and the physical geolocation, the image will appear "squished"
in the overlay.
This only applies to IW and EW SLC Quick-Look images, it does not
apply to other modes or to other IW and EW products.
L2 Ocean Not Applicable. The L2 OCN product is generated only from an 6.2.3
individual scene or slice input L1 product and assembled products are not
relevant to the generation of L2 products. The combination of data sets
within L2 products is beyond the scope of this specification.
Where:
N = Slice number
i = Line number relative to N
numLines = Total number of lines in
slice
GeoKeyDirectoryTag Include N/A 6.2.2
GeoDoubleParamsTag Include N/A 6.2.2
GeoAsciiParamsTag Include N/A 6.2.2
GTModelTypeGeoKey Include N/A 6.2.2
GTRasterTypeGeoKey Include N/A 6.2.2
GTCitationGeoKey Include N/A 6.2.2
GeographicTypeGeoKey Include N/A 6.2.2
GeogCitationGeoKey Include N/A 6.2.2
GeogLinearUnitsGeoKey Include N/A 6.2.2
GeogAngularUnitsGeoKey Include N/A 6.2.2
GeogEllipsoidGeoKey Include N/A 6.2.2
GeogSemiMajorAxisGeoKey Include N/A 6.2.2
GeogSemiMinorAxisGeoKey Include N/A 6.2.2
GeogInvFlatteningGeoKey Include N/A 6.2.2
GeoTIFF
Header
C
o
GeoTIFF
n
Header
c
a
Merge t
e
C
Slice 1 Image MDS n
o
a
n
t
c
GeoTIFF e
a
Header t
e
n
a
t
e
GeoTIFF
Header
R
a
n
g Assembled L1 Image MDS
e
Azimuth
Table 3-9 describes how to combine each type of L1 ADS into an assembled
product. The reference column in the tables indicates the sections where the data set
is defined.
Level 1 Product Annotation The Level 1 Product Annotation data set requires inclusion, 6.3.1
merging and concatenation. A breakdown of the general merging
A2
and concatenation strategy by record for this data set is presented
in Table 3-10.
Level 1 Calibration The Calibration ADS is assembled as follows: 6.3.2
• The values for the fields in the ADS header are included A3
except for the values of the startTime and stopTime fields,
which are merged as follows:
• startTime is merged by taking the value of the field from
the first slice.
• stopTime is merged by taking the value of the field from
the last slice;
• The values for the fields in the calibrationInformation record
are included; and,
• The list of calibration annotations contained in the
calibrationVectorList is concatenated and the count attribute is
updated to contain the number of calibrationVector records in
the concatenated list.
• The line element in each calibrationVector record is updated
to reflect the line in the assembled image.
ADS Header The values for the fields in the ADS header are included except for the Table 3-20
values of the startTime and stopTime fields, which are merged as
follows:
• startTime is merged by taking the value of the field from the first
slice.
• stopTime is merged by taking the value of the field from the last
slice.
Quality Information The list of quality annotations contained in the qualityDataList element 6.3.1.1
is concatenated and the count attribute is updated to contain the
number of qualityData records in the concatenated list.
General Annotation The productInformation sub-record contains single value fields that are 6.3.1.2
merged and included. All other sub-records contain lists which are
concatenated. Details are presented in Table 3-11.
Image Annotation This DSR contains two records which contain only single value fields. 0
The fields in the imageInformation record are included and merged
and all the fields for the processingInformation record are included;
except for the inputDimensionsList record, which is concatenated.
Details are presented in Table 3-12.
Doppler Centroid The list of Doppler centroid annotations contained in the dcBlockList 6.3.1.4
element is concatenated and the count attribute is updated to contain
the number of dcBlock records in the concatenated list.
Antenna Pattern The list of antenna pattern annotations contained in the 6.3.1.5
antennaPatternList element is concatenated and the count attribute is
updated to contain the number of antennaPattern records in the
concatenated list.
Swath Timing The list of swath timing annotations contained in the burstList element 6.3.1.6
is concatenated and the count attribute is updated to contain the
number of burst records in the concatenated list.
In addition to concatenation, each byteOffset field must be merged to
contain the correct byte offset by recalculating each byteOffset relative
to all preceding bursts within the assembled image:
N −1
byteOffsetiN = SlicelastByteOf fset + Slicei
N
Where:
N = Slice number
i = Byte offset relative to N
lastByteOffset = Largest (last) byte offset from the previous
slice
Geolocation Grid The list of geolocation grid points contained in the 6.3.1.7
geolocationGridPointList element is concatenated and the count
attribute is updated to contain the number of geolocationGridPoint
records in the concatenated list.
In addition to the concatenation, the value of the line field must be
merged for each grid point by recalculating the line number relative to
the total number of lines in all preceding slices:
N −1
lineiN = SlicenumLines
x
+ SliceiN
x =1
Where:
N = Slice number
i = Line number relative to N
numLines = Total number of lines in slice
Coordinate Conversion The list of coordinate conversion annotations contained in the 6.3.1.8
coordinateConversionList is concatenated and the count attribute is
updated to contain the number of coordinateConversion records in the
concatenated list.
Swath Merging The lists of swath merging annotations are concatenated. There is a 6.3.1.9
swathBoundsList for each swath. The list of swath merging
annotations contained in each swathBoundsList is concatenated and
the count attribute for each is updated to contain the number of
swathBounds records in the concatenated list.
Field Path
Strategy Details
/product/generalAnnotation/productInformation/pass
Merge Use the pass field from the first slice in the product.
/product/generalAnnotation/productInformation/timelinessCategory
Include N/A
/product/generalAnnotation/productInformation/platformHeading
Merge The platformHeading field is merged recalculating the platform heading mid-
acquisition (azimuth direction) for the assembled product.
/product/generalAnnotation/productInformation/projection
Include N/A
/product/generalAnnotation/productInformation/rangeSamplingRate
Include N/A
/product/generalAnnotation/productInformation/radarFrequency
Include N/A
/product/generalAnnotation/productInformation/azimuthSteeringRate
Include N/A
/product/generalAnnotation/downlinkInformationList
Concatenate The list of downlink information annotations contained in the
downlinkInformationList element is concatenated and the count attribute is updated to
contain the number of downlinkInformation records in the concatenated list.
/product/generalAnnotation/orbitList
Concatenate The list of orbit annotations contained in the orbitList element is concatenated and the
count attribute is updated to contain the number of orbit records in the concatenated
list.
/product/generalAnnotation/attitudeList
Concatenate The list of downlink information annotations contained in the attitudeList element is
concatenated and the count attribute is updated to contain the number of attitude
records in the concatenated list.
/product/generalAnnotation/replicaInformation/replicaInformationList
Concatenate The list of replicaInformation annotations contained in the replicaInformationList
element is concatenated and the count attribute is updated to contain the number of
replicaInformation records in the concatenated list.
Field Path
Strategy Details
/product/generalAnnotation/noiseList
Concatenate The list of noise measurement annotations contained in the noiseList element is
concatenated and the count attribute is updated to contain the number of noise records
in the concatenated list.
/product/generalAnnotation/terrainHeightList
Concatenate The list of terrain height annotations contained in the terrainHeigthList element is
concatenated and the count attribute is updated to contain the number of terrainHeight
records in the concatenated list.
/product/generalAnnotation/azimuthFmRateList
Concatenate The list of azimuth FM rate annotations contained in the azimuthFmRateList element
is concatenated and the count attribute is updated to contain the number of
azimuthFmRate records in the concatenated list.
Field Path
Strategy Details
/product/imageAnnotation/imageInformation/productFirstLineUtcTime
Merge The productFirstLineUtcTime field is merged by using the value of this field from the
first slice.
/product/imageAnnotation/imageInformation/productLastLineUtcTime
Merge The productLastLineUtcTime field is merged by using the value of this field from the
last slice.
/product/imageAnnotation/imageInformation/ascendingNodeTime
Merge The ascendingNodeTime field is merged by using the value of this field from the first
slice.
/product/generalAnnotation/imageInformation/anchorTime
Include The anchorTime value will be the same in every slice
/product/generalAnnotation/imageInformation/productComposition
Merge The productComposition field is set to “Assembled” for the final product (the input
slice productComposition fields should be set to “Slice”).
/product/generalAnnotation/imageInformation/sliceNumber
Merge The sliceNumber field is set to 0.
/product/generalAnnotation/imageInformation/sliceList
Include N/A
/product/generalAnnotation/imageInformation/slantRangeTime
Include The slantRangeTime value will be the same in every slice
/product/imageAnnotation/imageInformation/pixelValue
Include N/A
Field Path
Strategy Details
/product/imageAnnotation/imageInformation/outputPixels
Include N/A
/product/imageAnnotation/imageInformation/rangePixelSpacing
Include N/A
/product/imageAnnotation/imageInformation/azimuthPixelSpacing
Merge The value of the azimuthPixelSpacing field is merged by calculating the average value
of the azimuthPixelSpacing field across all slices.
/product/imageAnnotation/imageInformation/azimuthTimeInterval
Include N/A
/product/imageAnnotation/imageInformation/azimuthFrequency
Include N/A
/product/imageAnnotation/imageInformation/numberOfSamples
Merge The value of this field is merged by considering the minimum range sample across all
slices, Rangemin and the maximum range sample across all slices, Rangemax:
This section defines the naming convention for Sentinel-1 products. Consideration
has been made with respect to the ESA Sentinel-1 Products Naming Convention
described in [R-9]. This document has been created specifically to meet the product
naming needs of the Sentinel-1 mission.
3.5.1 Product
This section defines the naming standard for the top-level Sentinel-1 product folder.
The top-level Sentinel-1 product folder name is composed of upper-case
alphanumeric characters separated by an underscore “_”. Figure 3-7 defines the
naming standard for Sentinel-1 products. Table 3-13 defines the naming elements
and their range and is used throughout the remainder of this document as the
standard for naming Sentinel-1 product folders.
Note that ASAR options are only valid for ASAR offline test products and will not
be available operationally.
Product Type:
“SLC” / “GRD” / Absolute Orbit Number
“OCN”
MMM_BB_TTTR_LFPP_YYYYMMDDTHHMMSS_YYYYMMDDTHHMMSS_OOOOOO_DDDDDD_CCCC.EEEE
manifest.safe
This section defines the naming standard for all data set files within a Sentinel-1
product. Sentinel-1 product data sets are composed of lower-case alphanumeric
characters separated by a hyphen “-”. Table 3-14 defines the naming elements and
their range and is used throughout the remainder of this document as the standard for
naming Sentinel-1 product data sets.
In the case of assembled products, the data set names are updated as follows:
• The value of each naming element is included, except for:
• Sensing start date/time which is merged by using the value from the first
slice; and
• Sensing stop date/time which is merged by using the value from the last
slice.
Note that ASAR options are only valid for ASAR offline test products and will not
be available operationally.
mmm Mission identifier. The s1a option is used for s1a, s1b, asa
products produced for the Sentinel-1A
instrument and the s1b is used for products
produced for the Sentinel-1B instrument. The
asa option is used for products produced from
the ENVISAT ASAR instrument.
sss Swath identifier (up to 3 lower case s1, s2, s3, s4, s5, s6, iw, iw1, iw2,
alphanumeric characters). The s1-s6 swaths iw3, ew, ew1, ew2, ew3, ew4, ew5,
apply to SM products, the iw and iw1-3 swaths wv1, wv2, en, n1, n2, n3, n4, n5, n6,
apply to IW products (iw is used for detected IW is1, is2, is3, is4, is5, is6, is7
products where the 3 swaths are merged into one
image), the ew and ew1-5 swaths apply to EW
products (ew is used for detected EW products
where the 5 swaths are merged into one image),
and the wv1-2 swaths apply to WV products.
The en and n1-n6 swaths apply to the notch
acquisition modes. The is1-is7 swaths apply to
ASAR IM and WV products.
ttt Product type slc, grd, ocn
pp Polarisation hh (Single HH polarisation),
hv (Single HV polarisation),
vv(Single VV polarisation),
vh (Single VH polarisation)
nnn Image number. For WV products the image 001-999
number is used to distinguish between vignettes.
See notes 1234 below.
For SM, IW and EW modes the image number is
still used but refers instead to each swath and
polarisation combination (known as the
“channel”) of the data.
yyyymmddthhmmss Product start or stop date and time. Fourteen digits representing the date
and time separated by the character t5.
oooooo Absolute orbit number at product start time. 000001-999999
1
WV mode has an image number for each vignette. For a WV product with 105 vignettes, 105 images
exist numbered in time ascending order from 001 through 105.
2
SM single polarisation products have one channel numbered 001. SM dual polarisation products
have two channels numbered 001 and 002 in the order they are processed by the IPF.
3
IW single polarisation products have three channels numbered 001 – 003. IW dual polarisation
products have six channels numbered 001 – 006 in the order they are processed by the IPF.
4
EW single polarisation products have five channels numbered 001 – 005. EW dual polarisation
products have ten channels numbered 001 – 010 in the order they are processed by the IPF.
5
For IW and EW SLC products the start and stop times are different for each MDS.
Table 3-15 defines the naming convention for all measurement data sets used within
Sentinel-1 products.
Table 3-16 defines the naming convention for all annotation data sets used within
Sentinel-1 products.
Table 3-17 defines the names of all representation data sets used within Sentinel-1
products.
3.6.1 Decisions
• GeoTIFF imagery will be stored in native byte endian format, nominally little
endian (byte order is specified in the TIFF format).
• Product annotations will use standard SI units whenever possible.
• Attributes should be defined using only the following types from the XML
Schema namespace [http://www.w3.org/2001/XMLSchema]:
• long
• int
• short
• byte
• unsignedLong
• unsignedInt
• unsignedShort
• unsignedByte
• string
• Where ever possible elements should be defined using the primitive data types
described in Section 3.6.3 for the Sentinel-1 namespaces:
• s1sar: http://www.esa.int/safe/sentinel-1.0/sentinel-1/sar
• s1sarl1: http://www.esa.int/safe/sentinel-1.0/sentinel-1/sar/level-1
• s1sarl2: http://www.esa.int/safe/sentinel-1.0/sentinel-1/sar/level-2
Description Describes the purpose of the element or attribute including the units (if applicable). The
absence of a unit designation for string data types implies a string literal and for numerical
data types (integers, floats, etc…) the absence of a unit designation implies an absolute
number.
Elements are displayed in normal font.
Attributes are displayed in italics.
Cardinality Elements are displayed in normal font and this column defines the number of occurrences
of the element in the form:
[minOccurs ..] maxOccurs
Attributes are displayed in italics and this column describes the use of the attribute where,
“optional” means the attribute may or may not be present and “required” means the
presence of the attribute is mandatory.
Table 3-19 describes the primitive data types defined in the Sentinel-1 namespace.
For data types which express floating point or integer numbers, these are expressed
as ASCII strings in XML files with enough digits to express the full precision of the
data type.
Note that ASAR options are only valid for ASAR offline test products and will not
be available operationally.
missionId missionIdType 1
Mission identifier for this data set.
productType productType 1
Product type for this data set.
polarisation polarisationType 1
Polarisation for this data set.
mode sensorModeType 1
Sensor mode for this data set.
swath swathType 1
Swath identifier for this data set. This element
identifies the swath that applies to all data contained
within this data set. The swath identifier "EW" is
used for products in which the 5 EW swaths have
been merged. Likewise, "IW" is used for products in
which the 3 IW swaths have been merged.
startTime timeType 1
Zero Doppler start time of the output image [UTC].
stopTime timeType 1
Zero Doppler stop time of the output image [UTC].
absoluteOrbitNumber absOrbitNumberType 1
Absolute orbit number at data set start time.
missionDataTakeId missionDataTakeIdType 1
Mission data take identifier.
imageNumber imageNumberType 1
Image number. For WV products the image number
is used to distinguish between vignettes. For SM,
IW and EW modes the image number is still used
but refers instead to each swath and polarisation
combination (known as the 'channel') of the data.
This section defines the composition of all Level 1 products; that is, the collection of
data sets included in each Sentinel-1 Level-1 product type. It defines how the
measurement, annotation and representation data sets presented in Section 6 are put
together to form a complete Sentinel-1 Level 1 product.
This section defines the composition of Sentinel-1 Level-1 SLC products. The
collection of data sets that comprise Level-1 SLC products is presented in Table 4-1.
Table 4-2 lists the data set records from the Level 1 product annotation data set that
are included in the Level 1 SLC products.
MMM_BB_TTTR_LFPP_YYYYMMDDTHHMMSS_YYYYMMDDTHHMMSS_OOOOOO_DDDDDD_CCCC.SAFE
manifest.safe 1 1 1 1
1 1 1 1
annotation/
1 1 1 1
calibration/
1 1 1 1
measurement/1
1 1 1 1
preview/
map-overlay.kml 1 1 1 1
product-preview.html 1 1 1 1
quick-look.png 0 or 1 0 or 1 0 or 1 0
1 1 1 1
icons/
Image files required to support the product-preview.html file As required As required As required As required
1 1 1 1
support/
s1-level-1-calibration.xsd 1 1 1 1
s1-level-1-measurement.xsd 11 11 11 11
s1-level-1-noise.xsd 1 1 1 1
s1-level-1-product.xsd 1 1 1 1
s1-level-1-quicklook.xsd 1 1 1 0
s1-map-overlay.xsd 1 1 1 1
s1-object-types.xsd 1 1 1 1
s1-product-preview.xsd 1 1 1 1
Notes:
1 – The start and stop times for TOPS SLC products are different for each swath.
Table 4-2 Level 1 Product Annotation DSR Applicable to Level 1 SLC Products
Quality Information ✓ ✓ ✓ ✓
General Annotation ✓ ✓ ✓ ✓
Image Annotation ✓ ✓ ✓ ✓
Doppler Centroid ✓ ✓ ✓ ✓
Antenna Pattern ✓ ✓ ✓ ✓
Swath Timing ✓ ✓
Geolocation Grid ✓ ✓ ✓ ✓
Coordinate Conversion
Swath Merging
This section defines the composition of Sentinel-1 Level-1 GRD products. The
collection of data sets that comprise Level-1 GRD products is presented in Table
4-3. Table 4-4 lists the data set records from the Level 1 product annotation data set
that are included in the Level 1 GRD products.
MMM_BB_TTTR_LFPP_YYYYMMDDTHHMMSS_YYYYMMDDTHHMMSS_OOOOOO_DDDDDD_CCCC.SAFE
manifest.safe 1 1 1 1
1 1 1 1
annotation/
mmm-sss-ttt-pp-yyyymmddthhmmss-yyyymmddthhmmss-oooooo- 1 per
1 per pol. 1 per pol. 1 per pol.
vignette
dddddd-nnn.xml
1 1 1 1
calibration/
calibration-mmm-sss-ttt-pp-yyyymmddthhmmss- 1 per
1 per pol. 1 per pol. 1 per pol.
vignette
yyyymmddthhmmss-oooooo-dddddd-nnn.xml
noise-mmm-sss-ttt-pp-yyyymmddthhmmss-yyyymmddthhmmss- 1 per
1 per pol. 1 per pol. 1 per pol.
vignette
oooooo-dddddd-nnn.xml
1 1 1 1
measurement/1
mmm-sss-ttt-pp-yyyymmddthhmmss-yyyymmddthhmmss-oooooo- 1 per
1 per pol. 1 per pol. 1 per pol.
vignette
dddddd-nnn.tiff1
1 1 1 1
preview/
map-overlay.kml 1 1 1 1
product-preview.html 1 1 1 1
quick-look.png 0 or 1 0 or 1 0 or 1 0
1 1 1 1
icons/
Image files required to support the product-preview.html file As required As required As required As required
support/
s1-level-1-calibration.xsd 1 1 1 1
s1-level-1-measurement.xsd 11 11 11 11
s1-level-1-noise.xsd 1 1 1 1
s1-level-1-product.xsd 1 1 1 1
s1-level-1-quicklook.xsd 1 1 1 0
s1-map-overlay.xsd 1 1 1 1
s1-object-types.xsd 1 1 1 1
s1-product-preview.xsd 1 1 1 1
Notes:
Table 4-4 Level 1 Product Annotation DSR Applicable to Level 1 GRD Products
Quality Information ✓ ✓ ✓ ✓
General Annotation ✓ ✓ ✓ ✓
Image Annotation ✓ ✓ ✓ ✓
Doppler Centroid ✓ ✓ ✓ ✓
Antenna Pattern ✓ ✓ ✓ ✓
Swath Timing
Geolocation Grid ✓ ✓ ✓ ✓
Coordinate Conversion ✓ ✓ ✓ ✓
Swath Merging ✓ ✓
This section defines the composition of all Level 2 products; that is, the collection of
data sets included in each Sentinel-1 Level 2 product. It defines how the
measurement, annotation and representation data sets presented in Section 6 are put
together to form a complete Sentinel-1 Level 2 product.
This section defines the composition of Sentinel-1 Level 2 OCN products. The
collection of data sets that comprise Level 2 OCN products is presented in Table 5-1.
File/Folder Name SM IW EW WV
MMM_BB_TTTR_LFPP_YYYYMMDDTHHMMSS_YYYYMMDDTHHMMSS_OOOOOO_DDDDDD_CCCC.SAFE
manifest.safe 1 1 1 1
1 1 1 1
measurement/
mmm-sss-ttt-pp-yyyymmddthhmmss-yyyymmddthhmmss-oooooo- 1 per
1 1 1
vignette
dddddd-nnn.nc
1 1 1 1
preview/
map-overlay.kml 1 1 1 1
product-preview.html 1 1 1 1
1 1 1 1
icons/
Image files required to support the product-preview.html file As required As required As required As required
1 1 1 1
support/
s1-level-2-measurement.xsd 1 1 1 1
s1-map-overlay.xsd 1 1 1 1
s1-object-types.xsd 1 1 1 1
s1-product-preview.xsd 1 1 1 1
The sub-sections within this section describe in detail all of the data sets that are or
can be included with any of the Sentinel-1 products.
The objective of this section is to define the mandatory components of the manifest
file that are present in all Sentinel-1 products. A graphical representation of the top
level of the manifest file is shown in Figure 6-1, and the XML structure is described
in Table 6-1. These structures are further decomposed in sections 6.1.1
through6.1.3.
Within the tables below text in normal font is used to describe XML elements and
text in italicised font is used to describe XML attributes.
The data types used in the manifest structure are part of the SAFE specification and
Sentinel-1 specialisation of SAFE XFDU, whereas the types used elsewhere in this
document are defined specifically for Sentinel-1 product files. These types are
independent of each other because they are defined in different schemas and
different XML namespaces; however, in some cases, the data type names used by
SAFE, the Sentinel-1 SAFE specialisation and those defined for Sentinel-1 may
overlap. A table of manifest-specific primitive data types used for Sentinel-1
products is presented in Table 6-2 and the structure of the manifest file is presented
in Table 6-7.
The manifest file contains exactly one information package map with one content
unit as a child element. Beneath the first content unit is a list of content units that
define the metadata and data objects within the product; that is, the data sets that
make up the product.
contentUnit contentUnitType 1
The informationPackageMap contains exactly 1
contentUnit and this contentUnit catalogues the
physical data components included in the product.
ID ID optional
Unique identifier for this contentUnit.
unitType string required
Describes the type of data referenced by this content
unit.
textInfo string optional
A brief textual description of the information or data
referenced by this content unit.
repID IDREFS optional
Identifier of the representation data set(s) applicable
to this content unit. This can be a single item or a list
with each item separated by a space.
dmdID IDREFS optional
Identifier of the metadata or annotation data set(s)
applicable to this content unit. This can be a single
item or a list with each item separated by a space.
pdiID IDREFS optional
Identifier of the preservation description information
applicable to this content unit. For Sentinel-1
products this attribute shall always point to the
"processing" wrapped metadata object.
contentUnit contentUnitType 0 .. ∞
Content unit elements may include other content units
or may be internal pointers to elements in the data
object section. Content units are used to associate data
objects with one or more metadata objects and present
a view of these data/metadata associations.
dataObjectPointer dataObjectPointerType 0 .. 1
Through the use of its dataObjectID attribute, this
element points to the data object in the
dataObjectSection that this content unit describes.
The manifest file contains exactly one metadata section. The metadata section
contains a list of metadata objects that contain either wrapped metadata (information
included directly in the manifest file), a data object pointer that refers to a physical
annotation data set file on disk, or a metadata reference that points to a
representation data set schema file on disk.
metadataObject metadataObjectType 6 .. ∞
Metadata objects can take one of three forms: the first is
"wrapped metadata" in which valid XML data is
embedded directly in the manifest file itself using an
metadataWrap element; the second is a reference to an
annotation data set in the dataObjectSection through a
dataObjectPointer element; and, the third is a physical
reference to a representation data set on the filesystem
through the use of a metadataReference element.
ID ID required
Unique identifier of this meta data object.
category string required
Defines the category of this meta data. The category is
used to specify the nature of the metadata, whether it is
preservation information (PDI), description information
(DMD) or representation information (REP)
classification string required
A textual description of the classification of this meta
data. The classification is linked to the category and
provides a more verbose description of the nature of the
metadata, whether it is preservation information
(PROVENANCE), description information
(DESCRIPTION) or representation information
(REPRESENTATION)
The mandatory wrapped metadata elements included in all Sentinel-1 products are
described in Table 6-7.
stop Relative orbit number of the most recent line within the unsignedInt required
image data.
safe:cycleNumber Absolute sequence number of the mission cycle to which unsignedInt 1
the oldest image data applies.
safe:phaseIdentifier Id of the mission phase to which the oldest image data unsignedInt 1
applies.
safe:extension extensionType 1
s1:orbitProperties s1:orbitPropertiesType
s1: pass Direction of the orbit (ascending, descending) for the s1:passType 1
oldest image data in the product (the start of the product).
s1:ascendingNodeTime UTC time of the ascending node of the orbit. This element dateTime 0 .. 1
is present for all products except ASAR L2 OCN products
which are generated from an ASAR L1 input.
safe:frameSet Geographical and time location of the instrument footprint, frameSetType 0 .. 1
considered as a single frame. This element is present for all
products except ASAR L2 OCN products which are
generated from an ASAR L1 input.
safe:frame The instrument footprint frame. There is one frame per frameType 1 .. 200
product for SM, IW and EW modes, and one frame per
vignette for WV mode products.
safe:number Number of the WV vignette which this frame describes. unsignedInt 0 .. 1
safe:footprint Coordinates of instrument footprint in GML notation gml:LinearRingType 1
(gml:coordinates type as defined in
http://www.opengis.net/gml , namely string with 4 pairs of
coordinates (lon,lat of near and far range at start and stop
time of the image) separated by a space.
s1sarl1:standAloneProductIn Metadata describing the product. s1sar:standAloneProductInformationType 1
formation
s1sarl1:instrumentConfigur The instrument configuration ID (Radar database ID) for unsignedInt 1
ationID this data.
s1sarl1:missionDataTakeID Unique ID of the datatake within the mission. unsignedInt 1
s1sarl1:transmitterReceiver Transmit/Receive polarisation for the data. There is one transmitterReceiverPolarisationType 1 .. 2
Polarisation element for each Tx/Rx combination.
s1sarl1:productClass Output product class “A” for Annotation or “S” for productClassType 1
Standard.
s1sarl1:productClassDescri Textual description of the output product class. productClassDescriptionType 1
ption
s1sarl1:productComposition The composition type of this product: “Individual”, “Slice” productCompositionType 1
or “Assembled”.
s1sarl1:productType The product type (correction level) of this product. productTypeType 1
s1sarl1:productTimelinessC Describes the required timeliness of the processing. One productTimelinessCategoryType 1
ategory of:
• NRT-10m
• NRT-1h
• NRT-3h
• Fast-24h
• Off-line
• Reprocessing
s1sarl1:sliceProductFlag True if this is a slice from a larger product or false if this is bool 1
a complete product.
s1sarl1:segmentStartTime Sensing start time of the segment to which this slice dateTime 0 .. 1
belongs. This field is only present if sliceProductFlag =
true.
s1sarl1:sliceNumber Absolute slice number of this slice starting at 1. This field unsignedInt 0 .. 1
is only present if sliceProductFlag = true.
s1sarl1:totalSlices Total number of slices in the complete data take. This field unsignedInt 0 .. 1
is only present if sliceProductFlag = true.
The manifest file contains exactly one data object section. The data object section
contains a list of data objects that contain references to the physical MDS and ADS
data files on disk.
dataObject dataObjectType 1 .. ∞
Each data object refers to a physical file on the filesystem
through the use of its byteStream element. The mandatory ID
attribute is used by elements in the informationPackageMap
and the metadataSection to refer to these physical data objects.
ID ID required
Unique identifier for this data object
repID string required
Representation metadata identifier. This attribute describes the
applicable RDS for this data object.
byteStream byteStreamType 1
The byte stream element points to the physical file that this
data object represents. The byteStream element contains the
location of the file and associated information like the format
of the file, the size and the data integrity checksum.
This section describes the content and format of the measurement data sets used in
Sentinel-1 products.
This section describes the image measurement data sets that can be included in a
Sentinel-1 Level 1 product.
Image measurement data sets within Sentinel-1 L1 products are stored in GeoTIFF
format [R-6] which is built upon the TIFF format [R-5]. Every GeoTIFF file is
therefore a TIFF file. Some image files in Sentinel-1 products will be larger than
4 GB in size. The maximum size for a standard TIFF image is 4 GB, so in order to
accommodate files larger than 4 GB is size, the BigTIFF format [R-7] is used.
BigTIFF is also built upon the TIFF format, extending it to support files of an
arbitrarily large size.
L1 SLC images are generated in 32-bit signed integer format with each pixel
represented by two interleaved I&Q 16-bit signed integer samples in the order:
IQIQIQ… L1 GRD images are generated in 16-bit unsigned integer format with each
pixel representing a single 16-bit magnitude sample. In terms of TIFF output and
metadata tags, this equates to:
SamplesPerPixel = 1
SamplesPerPixel = 1
Note that for all L1 images the IPF supports only pixel interleaving (band
interleaving is not supported) and so PlanarConfiguration is always set to 1,
meaning contiguous (or pixel interleaved).
The TIFF tags used to annotate Sentinel-1 image files are presented in Table 6-13
and the GeoTIFF tags and keys used to annotate Sentinel-1 image files are presented
in Table 6-14.
StripByteCounts 279 Array of Variable Array of the number of bytes in each strip. For
LONG S1, the number of bytes in each “strip” will be
the same, as all image lines contain the same
number and type of samples.
PlanarConfiguration 284 SHORT 1 Configuration in which the components
(samples) of each pixel are stored. Always set
to 1 (contiguous).
Software 305 ASCII Variable Software name and version that created the
image.
DateTime 306 ASCII Variable Date and time of image creation in the format:
YYYY:MM:DD HH:MM:SS
SampleFormat 339 SHORT 5 or 1 Interpretation of pixel format. Set to 5
(complex signed integer, ‘int16’) for SLC
products, set to 1 (unsigned integer, ‘uint16’)
for all others.
A Quick-look image is a lower resolution version of the image MDS stored in PNG
file format [R-11] and is optionally included with any SM, IW or EW product.
Quick-look images are not included with WV mode products. The Quick-look
image is used in the Product Preview and is a convenient reference to the complete
image MDS. Being of lower resolution it is smaller and can be viewed (loaded) and
transferred faster than the complete image MDS. The following rules and properties
apply to Quick-look images:
• SM, IW and EW SLC Quick-look images are a power detected, averaged and
decimated version of the full SLC image; additionally,
• Merging is performed (bursts merged in azimuth and swaths merged in
range) for IW and EW SLC Quick-look images;
The Quick-look images for single polarisation products are output as greyscale PNG
images similar to the ones shown in Figure 6-5.
Figure 6-6 3 Channel (RGB) Composite Dual Polarisation VV/VH Quick-look Image
The Level 2 OCN MDS contains an Ocean Swell Wave spectra component (OSW),
an Ocean Wind field component (OWI) and a Radial Surface Velocity component
(RVL) estimated from an input L1 SAR image. The format of this data set is a
NetCDF file [R-12]. The information in the NetCDF file is broken into three groups
– attributes, dimensions and variables – as depicted in Figure 6-7 and described in
Table 6-15. The NetCDF format supports the inclusion of both the processed
measurement data and the associated metadata within the same file, so the L2 MDS
is a self-contained, self-describing file that requires no additional annotations or
supporting files.
Note: NetCDF is a binary format and because of its self-describing nature, differs
somewhat in format from the other data sets described so far; however, within this
section the use of XML diagrams is still employed to present a conceptual view of
the structure and content of the Level 2 ocean swell wave spectra and wind field data
set. The graphical and tabular views presented below are only conceptual and do not
reflect the physical layout of the NetCDF L2 MDS.
attributes NetCDF 1
Global attributes annotate variables or files with small
Construct
notes or supplementary metadata. Attributes are always
scalar values or 1D arrays which can be associated with
either a variable or the product as a whole.
dimensions NetCDF 1
Dimensions describe the axes of the data arrays
Construct
(variables). A dimension has a name and a length.
variables NetCDF 1
Variables are used to store both the processed L2
Construct
measurement data and the associated product annotations.
A variable represents an array of values of the same type.
A scalar value is treated as a 0-dimensional array. A
variable has a name, a data type, and a shape described by
its list of dimensions specified when the variable is
created.
Figure 6-8 and Table 6-16 present a graphical and tabular view, respectively, of the
L2 OCN attributes.
title string 1
Title/description of the L2 OCN product.
sourceProduct string 1
Identifier (file name) of the input L1 product.
missionName string 1
Identifier of the platform that acquired the SAR data that the
L2 OCN product was generated from.
missionPhase string 1
Phase of the mission (Calibration, Validation, Operational).
polarisation string 1
Polarisation (“HH”, “VV”, “VV/VH”, “HH/HV”).
acquisitionStation string 0
Name of the facility that acquired the SAR data (empty
string in most situations as the L2 OCN product can be
generated from L0 product received at different acquisition
stations)
oswAlgorithmVersion string 1
Version identifier of the OSW algorithm.
owiAlgorithmVersion string 1
Version identifier of the OWI algorithm.
rvlAlgorithmVersion string 1
Version identifier of the RVL algorithm.
idlVersion string 1
Version identifier of the IDL software used to generate the
L2 OCN product.
gmf string 1
Geophysical Model Function (GMF) used for OWI
processing.
polarisationRatio string 1
Name and parameters of polarisation ratio used for
transforming HH NRCS to VV NRCS before inversion.
processingStartTime timeType 1
Start time of L2 processing [UTC].
processingCenter string 1
Name of the processing center where the L2 OCN product
was generated.
firstMeasurementTime timeType 1
Zero Doppler start time of the source data acquisition
[UTC].
lastMeasurementTime timeType 1
Zero Doppler stop time of the source data acquisition
[UTC].
clmSource string 1
Coastline and land masking auxiliary data source.
bathySource string 1
Bathymetry auxiliary data source.
iceSource string 1
Ice coverage auxiliary data source. This attribute is set to
“None” if the ice auxiliary file is not available.
stokesSource string 1
Stokes drift auxiliary data source. This attribute is set to
“None” if the stokes drif auxiliary file is not available.
6.2.3.2 Dimensions
Dimensions describe the axes of the data arrays (variables). Each dimension has a
name and a length. Within the L2 OCN product, the dimensions are used to define
the sizes of the ocean swell wave spectra and wind field grids. Figure 6-9 and
Table 6-17 present a graphical and tabular view, respectively, of the L2 OCN
dimensions.
Cardinali
Name Description Data Type
ty
oswRaSize Number of range swell wave spectra cells. For WV mode unsignedInt 1
this dimension is set to 1 as there is 1 swell wave spectra
per WV vignette. For SM this dimension is set to the
number of cells in the range direction, nominally 4. This
parameter does not apply to IW nor EW mode.
Cardinali
Name Description Data Type
ty
rvlRaSize Number of range radial velocity cells. For WV mode this unsignedInt 1
dimension is set to 1 as there is 1 radial velocity cells per
WV vignette. For SM this dimension is set to the number
of cells in the range direction.
oswAngularBinSize Number of angular bins in the swell wave polar spectrum. unsignedInt 1
rvlSwath Number of swath for EW, IW (not used in SM and WV) unsignedInt 0..1
oswKxBinSize Number of bins in range direction for the cartesian wave unsignedInt 1
spectrum
6.2.3.3 Variables
Variables are used to store both the processed L2 measurement data and the
associated product annotations. A variable represents an array of values of the same
type. A scalar value is treated as an array with one element. A variable has a name, a
data type, and a shape described by its list of dimensions specified when the variable
is created. A graphical view of the L2 OCN variables is presented in Figure 6-10
and:
• Table 6-18 presents the variables in the OSW component grid;
• Table 6-19 presents the variables in the OWI component grid; and
• Table 6-20 presents the variables in the RVL component grid.
oswK Array of logarithmically spaced wavenumber bins for the array (float) 1
ocean swell wave spectra [rad/m]. The dimension of the
array is oswWavenumberBinSize.
oswPhi Array of equidistantly spaced directional bins for the array (float) 1
ocean swell wave spectra [degrees]. The dimension of
the array is oswAngularBinSize.
oswRaCutoff The range cut-off wavelength [m] is the shortest matrix (float) 1
wavelength in range direction that can be resolved in the
swell wave spectra. The cut-off wavelength is computed
from the slant range resolution (or range bandwidth, fsf )
and the local incidence angle as:
λrange(θ)=c/fsfsinθ
The dimensions of the matrix are oswAzSize x
oswRaSize
oswSpecRes The spectral resolution gives the shortest ocean matrix (float) 1
wavelength [m] that can be detected. This depends on
the sea state and the wave direction relative to azimuth.
This parameter is a vector of wave lengths equal to the
number of directional bins. In range, the theoretical limit
is given by the range bandwidth, and does not depend on
the sea state.
λ(φ)=(λc·cos(φ+φtrack))>λmin
where λmin=2π/kmax ≈ 30m is the shortest wavelength in
the spectra. Here λc is the azimuth cut-off wavelength
estimated from the SAR image spectra, and φtrack is the
satellite track heading counter clockwise relative to
North. The dimensions of the matrix are oswAzSize x
oswRaSize x oswAngularBinSize.
oswHs The significant waveheight computed from the five most matrix (float) 1
energetic wave partitions of the swell wave spectra [m].
The dimensions of the matrix are oswAzSize x
oswRaSize x oswPartitions.
oswWl The dominant wave length of the swell wave spectra [m] matrix (float) 1
for the five most energetic wave partitions. The
dimensions of the matrix are oswAzSize x oswRaSize x
oswPartitions.
oswDirmet The dominant wave direction of the swell wave spectra matrix (float) 1
[degrees] for the five most energetic wave partitions.
The dimensions of the matrix are oswAzSize x
oswRaSize x oswPartitions.
oswSnr . This is the signal-to-noise ratio [dB]of the cross- matrix (float) 1
spectra. The dimensions of the matrix are oswAzSize x
oswRaSize.
oswAmbiFac Ambiguity factor [1] measuring the ability to estimate matrix (float) 1
wave propagation direction from the sign of the
imaginary part of the cross spectra The dimensions of
the matrix are oswAzSize x oswRaSize x oswPartitions
oswIconf This flag provides the confidence of the swell wave matrix (byte) 1
spectra product for the five most energetic wave
partitions [0 or 1], where 0 means that the wave direction
is resolved while 1 means that there is a 180-degree
ambiguity in the wave direction. The dimensions of the
matrix are oswAzSize x oswRaSize x oswPartitions.
oswLookSeparationTime Separation time between inner and outer look [s]. The matrix (float) 1
dimensions of the matrix are oswAzSize x oswRaSize.
oswNrcs The normalized radar cross section of the imagette [dB] matrix (float) 1
is the measured radar cross section normalized to the
area on ground:
σ0=σ/A=σsinθ/ΔrΔa
where Δr, Δa are the slant range and azimuth resolution,
respectively. The NRCS is estimated within and
provided for each wave cell. The dimensions of the
matrix are oswAzSize x oswRaSize.
oswInten The input SLC image intensity [1] estimated within each matrix (float) 1
wave cell. The dimensions of the matrix are oswAzSize
x oswRaSize.
oswNv The variance of the input SLC image normalized by the matrix (float) 1
square of the mean intensity [1] estimated within each
wave cell. The dimensions of the matrix are oswAzSize
x oswRaSize.
oswSkew The skewness of the input SLC image [1] estimated matrix (float) 1
within each wave cell. The dimensions of the matrix are
oswAzSize x oswRaSize.
oswKurt The kurtosis of the input SLC image [a1] estimated matrix (float) 1
within each wave cell. The dimensions of the matrix are
oswAzSize x oswRaSize.
oswWindSpeed Wind speed [m/s] used for wave spectral retrieval. This matrix (float) 1
value is derived from the NRCS using the default wind
direction (45 degRa) or the value from the European
Centre for Medium-Range Weather Forecasts (ECMWF)
atmospheric model derived from the L2 auxiliary file .
The dimensions of the matrix are oswAzSize x
oswRaSize.
oswWindDirection Wind direction [degrees] used for wave spectral matrix (float) 1
retrieval. This value is derived from the ECMWF
atmospheric model derived from the L2 auxiliary file, or
set to 45deg. The dimensions of the matrix are
oswAzSize x oswRaSize..
oswWindSeaHs The significant waveheight for the wind sea part of the matrix (float) 1
total wave height spectrum [m]. Computed from the
wind speed and the inverse wave age. The dimensions
of the matrix are oswAzSize x oswRaSize.
oswWaveAge The parameter [1] derived from the SAR data that matrix (float) 1
describes the state of development of the wind sea
component of the wave spectra . The dimensions of the
matrix are oswAzSize x oswRaSize.
oswEcmwfWindSpeed Wind speed [m/s] from ECMWF atmoshperic model matrix (float) 1
extracted from S1__AUX_WND files. Dimension is
oswAzSize x oswRaSize
oswNlWidth Non linear inverse spectral width [m] describing non- matrix (float) 1
linear spectral cut-off computed from the cross-spectra.
The parameter can be used for calibration and gain
monitoring. The dimensions of the matrix are oswAzSize
x oswRaSize.
oswDepth Sea depth [m] from General Bathymetric Chart of matrix (float) 1
Oceans (GEBCO) data set. This parameter is resampled
into the wave cell grid. The dimensions of the matrix are
oswAzSize x oswRaSize.
oswLandCoverage Percentage [%] of land coverage within the estimation matrix (float) 1
area. The dimensions of the matrix are oswAzSize x
oswRaSize.
oswLandFlag Land mask flag. This flag is set to 1 if the land_coverage , matrix (byte) 1
> 10%; otherwise, it is set to 0. The dimensions of the
matrix are oswAzSize x oswRaSize.
oswIncidenceAngle Radar incidence angle [degrees] to the center of the matrix (float) 1
wave cells. This parameter is provided at each azimuth
line in the wave cell grid. The dimensions of the matrix
are oswAzSize x oswRaSize.
oswHeading Local Northing angle [degrees]. The dimensions of the matrix (float) 1
matrix are oswAzSize x oswRaSize.
oswGroundRngSize Ground range size of the estimation area [m]. The matrix (float) 1
dimensions of the matrix are oswAzSize x oswRaSize.
oswAziSize Azimuth size of the estimation area [m]. The matrix (float) 1
dimensions of the matrix are oswAzSize x oswRaSize.
oswCartSpecRe Real part of the Cathesian cross spectra [m^4]. Half of Matrix (float) 1
the full Cartesian cross spectras are stored (full
frequencies in azimuth direction and only positive
frequencies in range direction) to be symetrized. The
dimensions of the matrix are oswAzSize x oswRaSize x
oswKyBinSize x oswKxBinSize x oswLag.
- Zeros time lag= co-spectra: average cross
spectra of subviews 0-0, 1-1 and 2-2.
- First time lag= average cross spectra of
subviews 0-1 and 1-2
- Second time lag= cross spectra of subviews 0-2
oswCartSpecIm Imaginary part of the Cathesian cross spectra [m^4]. Matrix (float) 1
Half of the full Cartesian cross spectras are stored (full
frequencies in azimuth direction and only positive
frequencies in range direction) to be symetrized. The
dimensions of the matrix are oswAzSize x oswRaSize x
oswKyBinSize x oswKxBinSize x oswLag.
- Zeros time lag= co-spectra: average cross
spectra of subviews 0-0, 1-1 and 2-2.
- First time lag= average cross spectra of
subviews 0-1 and 1-2
- Second time lag= cross spectra of subviews 0-2
oswTotalHs Total significant wave height [m]. The dimensions of the Matrix (float) 1
matrix are oswAzSize x oswRaSize
oswQualityFlagPartition Quality flag for each partition. The dimensions of the Matrix(byte) 1
matrix are oswAzSize x oswRaSize x oswPartitions
Swell quality flag values can be 0 (high quality), 1
(medium quality), 2 (low quality) or 3 (bad quality).
oswQualityFlag Total Quality flag The dimensions of the matrix are Matrix(byte) 1
oswAzSize x oswRaSize.
Swell quality flag values can be 0 (high quality), 1
(medium quality), 2 (low quality) or 3 (bad quality).
oswGroupDir Swell direction estimated from the Group analysis Matrix (float) 1
[degrees]. The dimensions of the matrix are oswAzSize
x oswRaSize x oswPartitions.
oswEllipsWidth Length of the minor axis of the ellipsoid [m]. A Matrix (float) 1
parameter of the estimated fitting ellipsoid for Group
analysis. The dimensions of the matrix are oswAzSize x
oswRaSize x oswPartitions.
owiLon Geodetic longitude at wind cell center [degrees_east]. The matrix (float) 1
dimensions of the matrix are owiAzSize x owiRaSize.
owiLat Geodetic latitude at wind cell center [degrees_north]. The matrix (float) 1
dimensions of the matrix are owiAzSize x owiRaSize.
owiLandFlag Land mask flag. This flag is set to 1 if the land_coverage > matrix (byte) 0,1
10%; otherwise, it is set to 0. The dimensions of the
matrix are owiAzSize x owiRaSize.
Please note that this flag is not present for product of IPF
2.90 and latr
owiMask Owi mask. The dimensions of the matrix are owiAzSize x Matrix (byte) 1
owiRaSize . Byte value:
0: usefull data
1:land mask: set to 1 if the land_coverage > 10%
2: ice mask: Extended IceMask (10km dilated ice edge
area)
4: missing data
owiIncidenceAngle Radar incidence angle [degrees] to the center of the wind matrix (float) 1
cells. This parameter is provided at each azimuth line in
the wind cell grid. The dimensions of the matrix are
owiAzSize x owiRaSize.
owiHeading Local Northing angle [degrees]. The dimensions of the matrix (float) 1
matrix are owiAzSize x owiRaSize.
owiNrcs The normalized radar cross section of the imagette [m²/m²] matrix (float) 1
is the measured radar cross section normalized to the area
on ground:
σ0=σ/A=σsinθ/ΔrΔa
where Δr, Δa are the slant range and azimuth resolution,
respectively. The NRCS is estimated within and provided
for each wind cell. The dimensions of the matrix are
owiAzSize x owiRaSizex owiPolarisation.
owiNrcsNeszCorr The noise corrected NRCS [m²/m²] averaged within and matrix (float) 1
provided for each wind cell. The dimensions of the matrix
are owiAzSize x owiRaSizex owiPolarisation.
owiPBright Percentage of bright targets pixels detected in each SAR matrix (float) 1
wind cell and removed for the computation of the mean
NRCS [%]. The dimensions of the matrix are owiAzSize x
owiRaSize.
owiNrcsCmod Predicted NRCS from CMOD and ECMWF a priori 10m matrix (float) 1
wind for each SAR wind cell [m²/m²]. The dimensions of
the matrix are owiAzSize x owiRaSize.
owiWindSpeed SAR wind speed for each wind cell [m/s]. The dimensions matrix (float) 1
of the matrix are owiAzSize x owiRaSize.
owiWindDirection SAR wind direction for each wind cell [degrees]. The matrix (float) 1
dimensions of the matrix are owiAzSize x owiRaSize.
owiInversionQuality Inversion quality indicator for each wind cell. The matrix (byte) 1
dimensions of the matrix are owiAzSize x owiRaSize.
owiInversionQuality flag is related to the wind inversion
step relying on the NRCS, the incidence angle, azimuth
look angle and ancillary wind speed and direction. If the
NRCS, the incidence and azimuth look angles are correct,
then it is expected that the SAR wind will be consistent
with the ancillary wind. The owiInversionQuality flag is an
indication of this consistency between SAR and ancillary
winds. The values are as followed:
Inversion quality flag values can be 0 (high quality), 1
(medium quality) or 2 (low quality)
owiWindQuality SAR wind quality flag for each wind cell. The dimensions matrix (byte) 1
of the matrix are owiAzSize x owiRaSize.
The owiWindQuality flag Qw is more general than the
owiInversionQuality. This flag includes the inversion
quality but also the geophysical quality flag found for the
whole product and the quality of the NRCS estimated for
each wind vector cell. This quality depends on the
percentage of bright targets found among the pixels
included in each wind vector cell.
Wind quality flag values can be 0 (high quality), 1
(medium quality), 2 (low quality) or 3 (bad quality).
The quality of the of the NRCS is evaluated as followed:
, (good)
if, . (bad)
Where Tb is a configurable auxiliary input parameters with
a default value of 500.
If the geophysical calibration of the whole product has
been found bad then:
owiEcmwfWindSpeed Wind speed [m/s] from the European Centre for Medium- matrix (float) 1
Range Weather Forecasts (ECMWF) atmospheric model
derived from the L2 auxiliary file and resampled into wind
cell grid. The dimensions of the matrix are owiAzSize x
owiRaSize.
owiRadVel Radial velocities [m/s] from the RVL component matrix (float) 1
interpolated to the wind cell grid. The dimensions of the
matrix are owiAzSize x owiRaSize.
owiHs The significant waveheight [m] from the OSW component matrix (float) 1
interpolated to the wind cell grid. The dimensions of the
matrix are: for WV/SM, owiAzSize x owiRaSize x
oswPartitions. For IW/EW, as OSW is not performed, the
variable is fillvalue with dimensions oswAzSize x
oswRaSize x oswPartitions (1x 1x1).
owiWl The dominant wave length [m] from the OSW component matrix (float) 1
interpolated to the wind cell grid. The dimensions of the
matrix are: for WV/SM, owiAzSize x owiRaSize x
oswPartitions . For IW/EW, as OSW is not performed, the
variable is fillvalue with dimensions oswAzSize x
oswRaSize x oswPartitions (ie 1x 1x1)..
owiDirmet The dominant wave direction [degrees] from the OSW matrix (float) 1
component interpolated to the wind cell grid. The
dimensions of the matrix are, for WV/SM, owiAzSize x
owiRaSize x oswPartitions. For IW/EW, as OSW is not
performed, the variable is fillvalue with dimensions
oswAzSize x oswRaSize x oswPartitions (ie; 1x 1x1)..
owiWindSeaHs The significant waveheight for the wind sea part of the matrix (float) 1
total wave height spectrum [m] from the OSW component
interpolated to the wind cell grid. The dimensions of the
matrix are : for WV/SM owiAzSize x owiRaSize . For
IW/EW, as OSW is not performed, the variable is fillvalue
with dimensions, oswAzSize x oswRaSize (1x 1 and
fillvalue).
owiElevationAngle Radar elevation angle [degrees] to the center of the wind matrix (float) 1
cells. This parameter is provided at each azimuth line in
the wind cell grid.
The dimensions of the matrix are owiAzSize x owiRaSize.
rvlLon Geodetic longitude at RVL cell center [degrees_east]. The matrix (float) 1
dimensions of the matrix are: for SM/WV, rvlAziSize x
rvlRaSize; for EW/IW, rvlAziSize x rvlRaSize x
rvlSwath;.
rvlLat Geodetic latitude at RVL cell center [degrees_north]. The matrix (float) 1
dimensions of the matrix are; for SM/WV, rvlAziSize x
rvlRaSize; for EW/IW, rvlAziSize x rvlRaSize x
rvlSwath;.
rvlLandCoverage Percentage [%] of land coverage within the estimation matrix (float) 1
area. The dimensions of the matrix are ; for SM/WV,
rvlAziSize x rvlRaSize; for EW/IW, rvlAziSize x
rvlRaSize x rvlSwath.
rvlLandFlag Land mask flag This flag is set to 1 if the land_coverage > matrix (byte) 1
10%; otherwise, it is set to 0. The dimensions of the
matrix are : for SM/WV, rvlAziSize x rvlRaSize; for
EW/IW, rvlAziSize x rvlRaSize x rvlSwath..
rvlIncidenceAngle Radar incidence angle [degrees] to the center of the RVL matrix (float) 1
cells. This parameter is provided at each azimuth line in
the radial velocity cell grid. The dimensions of the matrix
are : for SM/WV, rvlAziSize x rvlRaSize; for EW/IW,
rvlAziSize x rvlRaSize x rvlSwath.
rvlHeading Local Northing angle [degrees]. The dimensions of the matrix (float) 1
matrix are : for SM/WV, rvlAziSize x rvlRaSize; for
EW/IW, rvlAziSize x rvlRaSize x rvlSwath.
rvlDcObsStd Estimated Doppler frequency standard deviation [Hz]. The array (float) 1
dimensions of the matrix are: for SM/WV, rvlAziSize x
rvlRaSize; for EW/IW, rvlAziSize x rvlRaSize x
rvlSwath;.
rvlRadVel Radial velocities [m/s]. The dimensions of the matrix are: matrix (float) 1
for SM/WV, rvlAziSize x rvlRaSize; for EW/IW,
rvlAziSize x rvlRaSize x rvlSwath.
rvlDcGeo Doppler centroid frequency from geometry [Hz]. This matrix (float) 1
parameter is interpolated from the L1 product. The
dimensions of the matrix are : for SM/WV, rvlAziSize x
rvlRaSize; for EW/IW, rvlAziSize x rvlRaSize x
rvlSwath;.
rvlYaw Yaw [degrees] of satellite platform versus zero Doppler matrix (float) 1
time. The dimensions of the matrix are: for SM/WV,
rvlAziSize x rvlRaSize; for EW/IW, rvlAziSize x
rvlRaSize x rvlSwath;.
rvlPitch Pitch [degrees] of satellite platform versus zero Doppler matrix (float) 1
time. The dimensions of the matrix are : for SM/WV,
rvlAziSize x rvlRaSize; for EW/IW, rvlAziSize x
rvlRaSize x rvlSwath.
rvlRoll Roll [degrees] of satellite platform versus zero Doppler matrix (float) 1
time. The dimensions of the matrix are : for SM/WV,
rvlAziSize x rvlRaSize; for EW/IW, rvlAziSize x
rvlRaSize x rvlSwath.
rvlSnr Signal to noise ratio estimated from Doppler spectra (side- matrix (float) 1
band corrected intensity/additive noise) [1]. The
dimensions of the matrix are : for SM/WV, rvlAziSize x
rvlRaSize; for EW/IW, rvlAziSize x rvlRaSize x rvlSwath.
rvlUssX Longitudinal component of surface stokes drift [m/s] from matrix (float) 1
WAVEWATCH III model. The dimensions of the matrix
are : for SM/WV, rvlAziSize x rvlRaSize; for EW/IW,
rvlAziSize x rvlRaSize x rvlSwath.
rvlUssY Meridianal component of surface stokes drift [m/s] from matrix (float) 1
WAVEWATCH III model. The dimensions of the matrix
are : for SM/WV, rvlAziSize x rvlRaSize; for EW/IW,
rvlAziSize x rvlRaSize x rvlSwath..
rvlSweepAngle Sweep angle of the TOPS mode [degrees]. The dimensions matrix (float) 1
of the matrix are : for SM/WV, rvlAziSize x rvlRaSize; for
EW/IW, rvlAziSize x rvlRaSize x rvlSwath.
rvlSlantRangeTime Slant range time [s]. The dimensions of the matrix are: for matrix (float) 1
SM/WV, rvlAziSize x rvlRaSize; for EW/IW, rvlAziSize x
rvlRaSize x rvlSwath.
rvlZeroDopplerTime Zero Doppler time. The dimensions of the matrix are: for matrix 1
SM/WV, rvlAziSize x rvlRaSize x length; for EW/IW, (timeType)
rvlAziSize x rvlRaSize x length x rvlSwath;.
rvlGroundRngSize Ground range resolution [m]. The pixel size is half this matrix (float) 1
value. The dimensions of the matrix are: for SM/WV,
rvlAziSize x rvlRaSize; for EW/IW, rvlAziSize x
rvlRaSize x rvlSwath.
rvlAziSize Azimuth resolution [m]. The pixel size is half this value. matrix (float) 1
The dimensions of the matrix are: for SM/WV, rvlAziSize
x rvlRaSize; for EW/IW, rvlAziSize x rvlRaSize x
rvlSwath.
rvlSwathNumber Swath number The dimension of the array is rvlSwath Array(byte) 1: for
EW/IW
0: for
SM/WV
The sub-sections within this section contain a detailed description of each annotation
data set in tabular format. The purpose of these sub-sections is to present the details
of every annotation contained within the data sets in a clear layout that does not
require the reader to have any knowledge of XML Schema.
The L1 Product ADS contains all the information pertaining to the L1 product
(except for the calibration and noise vectors which are contained in separate data
sets). This ADS describes attributes of the input data, the processing performed and
the final output. Figure 6-13 presents a high-level graphical overview of the L1
Product ADS
The content of the L1 Product Annotation Data Set is presented in the tables below.
adsHeader adsHeaderType 1
ADS header data set record. This DSR contains information that applies to the entire data set.
qualityInformation l1QualityInformationType 1
Quality information data set record. This DSR contains the quality flags and the values used to set them during
image processing as well as the overall quality index.
generalAnnotation l1GeneralAnnotationType 1
General annotation data set record. This DSR contains information describing some key characteristics that apply
to the entire L1 product. This includes annotations such as the sensing start and stop times, polarisation and swath.
It also contains annotations derived from the input processing step including information extracted/calculated from
the downlink data and raw data analysis (RDA) statistics.
imageAnnotation l1ImageAnnotationType 1
Image annotation data set record. This DSR contains information describing the properties of the image MDS (such
as data type and image dimensions) and the key parameters/options used during the processing of the image.
dopplerCentroid l1DopplerCentroidType 1
Doppler centroid data set record. This DSR contains information about the Doppler centroid values estimated and
used during image processing.
antennaPattern l1AntennaPatternType 1
Antenna pattern data set record. This DSR contains information describing the elevation antenna pattern and how it
was applied by the IPF during image processing.
swathTiming l1SwathType 1
Swath timing data set record. This DSR contains the information about the bursts within the image MDS including
the burst dimensions, burst timing and burst location. This DSR is specific to IW and EW SLC products.
geolocationGrid l1GeolocationGridType 1
Geolocation grid data set record. This DSR describes the geodetitic position of line/pixel combinations within the
image MDS.
coordinateConversion l1CoordinateConversionType 1
Coordinate conversion data set record. This DSR contains the annotations required to convert between the slant
range and ground range coordinate systems.
swathMerging l1SwathMergeType 1
Swath merging data set record. This DSR contains the annotations for interpreting the way in which IW or EW
swaths were merged during GRD processing.
Quality information data set record. This DSR contains the quality flags that are set during image processing as well as the overall quality index.
Each quality flag indicates the status of a comparison between the corresponding value from the product annotations and a pre-defined threshold.
The threshold usually comes from the auxiliary processor parameters file, but may also come from an internal parameter file.
The product quality index is a value that gives an overall assessment of the product quality by calculating a confidence measure based on the
detailed product quality information. Currently, the product quality index is reserved for future use and the value of this field is always set to 0.0.
Figure 6-14 presents a graphical view of the structure and content of the Quality Information ADSR and the subsequent tables describe the schemas
defined in Appendix A2.
productQualityIndex Overall product quality index. This annotation is calculated based on specific quality parameters and gives an double 1
overall quality value to the product. This parameter is reserved for future use and its value is set to 0.0.
qualityDataList Quality data list. This element contains a list of qualityData records which contain the quality values and flags qualityDataListType 1
calculated and set during image processing. For individual scene and slice products there is one qualityData
record in the list. For assembled products the list contains one qualityData record for each slice included in the
assembled product.
qualityData Quality data. This record contains the quality values and flags that are set during image processing. Each flag qualityDataType 1 .. 150
indicates the status of a comparison between the corresponding value(s) and a pre-defined threshold. For
individual scene and slice products there is one qualityData record. For assembled products the list contains all
the qualityData records for each slice included in the assembled product. For a minimum output slice length of
10s and a maximum segment length of 25 minutes, the maximum number of records in the list is 150.
azimuthTime Zero Doppler azimuth time at which this set of quality annotations applies [UTC]. timeType 1
downlinkQuality Downlink quality. This record contains the quality indicators - values and flags - related to the downlink downlinkQualityType 1
information.
iInputDataMean Calculated mean of the input data for the I channel. double 1
qInputDataMean Calculated mean of the input data for the Q channel. double 1
inputDataMeanOutsideNominalRangeFlag Input data mean outside nominal range flag. False if the mean of I and Q input values are both bool 1
within specified range from expected mean. For expected mean of x, the measured mean must fall
between x-threshold to x+threshold. True otherwise.
iInputDataStdDev Calculated standard deviation of the input data for the I channel. double 1
qInputDataStdDev Calculated standard deviation of the input data for the Q channel. double 1
inputDataStDevOutsideNominalRangeFlag Input data standard deviation outside nominal range flag. False if the standard deviation values of I bool 1
and Q input values are both within specified range of expected standard deviation. For expected std.
dev. x, the measured std. dev. must fall between x-threshold to x+threshold. True otherwise.
numDownlinkInputDataGaps Number of downlink gaps detected in the input data. uint32
downlinkGapsInInputDataSignificantFlag Significant downlink gaps in the input data flag. A downlink input data gap is defined as a bool
contiguous block of N downlink missing lines (the value of N is predefined for each product). False
if the number of downlink input gaps is less than or equal to the threshold value, true if number of
downlink input data gaps is greater than the threshold value.
instrumentGapsInInputDataSignificantFlag Significant instrument gaps in the input data flag. An instrument input data gap is defined as a bool 1
contiguous block of N instrument missing lines (the value of N is predefined for each product).
False if the number of instrument input gaps is less than or equal to the threshold value, true if
number of instrument input data gaps is greater than the threshold value.
numInstrumentInputMissingLines Number of instrument missing lines detected in the input data, excluding data gaps. An instrument uint32 1
missing line is defined as any echo line physically absent from the input data file due to a failure by
the instrument to produce the expected echo line.
instrumentMissingLinesSignificantFlag Instrument missing lines significant flag. False if the percentage of instrument missing lines is less bool 1
than or equal to the threshold value, true if the percentage of instrument missing lines is greater than
the threshold value. The number of instrument missing lines is numInstrumentInputMissingLines.
numSsbErrorInputDataGaps Number of gaps detected in the input data due to the SSB Error flag being set. uint32 1
ssbErrorGapsInInputDataSignificantFlag Significant SSB Error gaps in the input data flag. An SSB Error input data gap is defined as a bool 1
contiguous block of N lines in which the SSB Error Flag is set to true (the value of N is predefined
for each product). False if the number of SSB Error input gaps is less than or equal to the threshold
value, true if number of SSB Error input data gaps is greater than the threshold value.
numSsbErrorInputMissingLines Number of SSB Error missing lines detected in the input data, excluding data gaps. An SSB Error uint32 1
missing line is defined as any echo line in which the SSB Error Flag is the ISP secondary header is
set to true.
stdDevPgProductAmplitude Standard deviation of all PG product amplitude values from the replicas extracted from the double 1
calibration pulses.
meanPgProductPhase Mean value of all PG product phase values from the replicas extracted from the calibration pulses double 1
[radians].
stdDevPgProductPhase Standard deviation of all PG product phase values from the replicas extracted from the calibration double 1
pulses [radians].
pgProductDerivationFailedFlag PG product derivation failed flag. False if the percentage of invalid relative and absolute PG bool 1
products is below the configured threshold; or, true otherwise. If this flag is set to true then the
values from the PG product model will be used in place of the derived PG product values.
invalidDownlinkParamsFlag Invalid downlink parameters flag. False if all parameters read from the downlinked data were valid, bool 1
true if any downlink parameter is out of range and therefore a default value has been used during
processing.
iBias Calculated I bias. This value is a copy of the value from the rawDataAnalysis record. double 1
iBiasSignificanceFlag I bias significance, true if I bias falls within acceptable range, false otherwise. bool 1
qBias Calculated Q bias. This value is a copy of the value from the rawDataAnalysis record. double 1
qBiasSignificanceFlag Q bias significance, true if Q bias falls within acceptable range, false otherwise. bool 1
iqGainImbalance Calculated I/Q gain imbalance. This value is a copy of the value from the rawDataAnalysis record. double 1
iqGainSignificanceFlag I/Q Gain Significance, true if I/Q gain imbalance falls within acceptable range, false otherwise. bool 1
iqQuadratureDepartureSignificanceFlag I/Q Quadrature Departure Significance, true if quadrature departure falls within acceptable range, false bool 1
otherwise.
dcMethod Doppler centroid estimation method used during processing. Both the Doppler centroid (DC) calculated dcMethodType 1
from orbit geometry and the DC estimated from the raw data are annotated within the Doppler data set;
however, this parameter describes the actual DC method used during image processing. This value is a copy
of the value from the processingOptions record.
dopplerCentroidUncertainFlag Doppler centroid uncertain flag. False if the root mean squared (RMS) error for the DCE method used for bool 1
image processing is less than the specified threshold, true if the RMS error is greater than or equal to the
specified threshold. Note: if more than one Doppler centroid estimation is performed, the flag is set to true
if any RMS error is greater than or equal to the threshold).
imageStatistics Mean and standard deviation statistics for the image. This record is a copy of the record from the imageStatisticsType 1
imageInformation record.
outputDataMeanOutsideNominalRangeFlag Output data mean outside nominal range flag. False if the mean of I and Q output values for SLC bool 1
image or mean of detected pixels for a detected product, are both within specified range from
expected mean. For expected mean of x, the measured mean must fall between x-threshold to
x+threshold. True otherwise.
outputDataStDevOutsideNominalRangeFlag Output data standard deviation outside nominal range flag. False if the std. dev. of I and Q output bool 1
values for SLC image or std. dev. of detected pixels for a detected product, are both within
specified range from expected std. dev. For expected std. dev. of x, the measured std. dev. must
fall between x-threshold to x+threshold. True otherwise.
General annotation data set record. This DSR contains information describing some key characteristics that apply to the entire L1 product. This
includes annotations such as the sensing start and stop times, polarisation and swath. It also contains annotations derived from the input processing
step including information extracted/calculated from the downlink data and raw data analysis statistics.
Figure 6-15 presents a graphical view of the structure and content of the General ADSR and the subsequent tables describe the schemas defined in
Appendix A2.
productInformation General product information. This record describes some key characteristics of the product, the input data productInformationType 1
and the acquisition platform.
downlinkInformationList Downlink information list. This element contains a list of downlinkInformation records which contain downlinkInformationListType 1
information extracted and calculated from the input data.
orbitList List of orbit information used by the IPF during processing. This list contains sets of orbit state vectors that orbitListType 1
are updated along azimuth. The values represent the interpolated values used by the IPF and are derived
from the sub-commutated ancillary data from the ISPs or from an input auxiliary orbit file.
pass Direction of the orbit (ascending, descending) for the oldest image data in the product (the start of the passDirectionType 1
product).
timelinessCategory Timeliness category under which the product was produced, i.e. time frame from the data acquisition (for the string 1
near real time categories) or from the satellite tasking to the product delivery to the end user.
platformHeading Platform heading relative to North [degrees]. double 1
count Number of downlink information records within the list. unsignedInt required
downlinkInformation Downlink information. This record contains information about the data extracted/calculated from the input downlinkInformationType 1 .. 750
data, including values extracted from the ISP and data error counters. For individual scene and slice products
there is one downlinkInformation record, except in the case of IW/EW GRD products, where there will be
one record per swath. For assembled products the list contains all the downlinkInformation records for each
slice included in the assembled product. For a minimum output slice length of 10s, a maximum segment
length of 25 minutes and a maximum 5 swaths, the maximum number of records in the list is 750.
swath Swath from which this downlink information data was extracted. swathType 1
azimuthTime Zero Doppler azimuth time at which this set of downlink information applies [UTC]. timeType 1
numErrDataTakeId Number of errors detected in the data take identifier field. uint32 1
numErrEccNumber Number of errors detected in the Event Control Code (ECC) number field. uint32 1
numErrInstrumentConfigId Number of errors detected in the instrument configuration identifier field. uint32 1
numErrPacketCount Number of errors detected in the space packet count field. uint32 1
numErrPriCount Number of errors detected in the Pulse Repetition Interval (PRI) count field. uint32 1
numErrSsbErrorFlag Number of packets in which the SSB Error Flag is set to true. uint32 1
numErrBaqMode Number of errors detected in the Block Adaptive Quantisation (BAQ) mode field. uint32 1
numErrBaqBlockLength Number of errors detected in the BAQ block length field. uint32 1
numErrTxPulseStartFrequency Number of errors detected in the Tx pulse start frequency field. uint32 1
numErrSwst Number of errors detected in the sampling window start time (SWST) field. uint32 1
numErrSwl Number of errors detected in the sampling window length (SWL) field. uint32 1
numErrElevationBeamAddress Number of errors detected in the elevation beam address field. uint32 1
numErrAzimuthBeamAddress Number of errors detected in the azimuth beam address field. uint32 1
numErrSasTestMode Number of errors detected in the SAR Antenna Sub-system (SAS) test mode field. uint32 1
numErrCalType Number of errors detected in the calibration operation type field. uint32 1
numErrCalibrationBeamAddress Number of errors detected in the calibration beam address field. uint32 1
rank The number of PRI between transmitted pulse and return echo. uint16 1
dataFormat Data format for instrument samples. There is one element corresponding to the data format for each packet dataFormatType 1
type in the segment.
rangeDecimation Decimation of the SAR data in the sampling window according to the needed mode bandwidth. rangeDecimationType 1
rxGain Applied value of the commandable Rx attenuation in the receiver channel of the SES. double 1
txPulseRampRate The linear FM rate at which the frequency changes over the pulse duration [Hz/s]. double 1
meanBitRate The calculated mean FDBAQ bit rate code for echo packets over the entire segment. This field applies only double 1
when the echoFormat is FDBAQ.
decimationFilterBandwidth Filter bandwidth used to decimate the SAR signal data [Hz]. double 1
samplingFrequencyAfterDecimation Sampling frequency of the SAR signal data after decimation [Hz]. This frequency is equivalent to the to double 1
the sampling frequency before decimation multiplied by the decimation ratio.
filterLength Length of the decimation filter [samples] uint32 1
swl Sampling window length record. This record holds the SWL for the given zero Doppler azimuth time. For a swstType 1 .. 200
SWL update rate of approximately 8s and a maximum segment length of 25 minutes, the maximum number
of records in the list is 200.
azimuthTime Zero Doppler azimuth time of sampling window length change [UTC]. timeType 1
swst SWST record. This record holds the SWST for the given zero Doppler azimuth time. For a SWST update swstType 1 .. 200
rate of approximately 8s and a maximum segment length of 25 minutes, the maximum number of records in
the list is 200.
azimuthTime Zero Doppler azimuth time of sampling window start change [UTC]. timeType 1
value Sampling window start time for first range sample [s]. double 1
count Number of pointing status records within the list. unsignedInt required
azimuthTime Zero Doppler azimuth time of the pointing status change [UTC]. timeType 1
rollErrorFlag Roll error status. Set to false when the roll axis is fine pointed and set to true when the roll axis is degraded. bool 1
pitchErrorFlag Pitch error status. Set to false when the pitch axis is fine pointed and set to true when the pitch axis is bool 1
degraded.
yawErrorFlag Yaw error status. Set to false when the yaw axis is fine pointed and set to true when the yaw axis is degraded. bool 1
orbit Orbit state vector record. This record contains a position vector and a velocity vector which together describe orbitType 1 .. 1500
the orbit state of the platform at the annotated time. With a minimum orbit/attitude update rate of 1s and a
maximum product length of 25 minutes, the maximum size of this list is 1500 elements.
position Position vector record. This record contains the platform position data with respect to the Earth-fixed positionType 1
reference frame.
Note: The Earth fixed reference frame in use is the IERS Terrestrial Reference Frame (ITRF). The zero
longitude or IERS Reference Meridian (IRM), as well as the IERS Reference Pole (IRP), are maintained by
the International Earth Rotation Service (IERS), based on a large number of observing stations, and define
the IERS Terrestrial Reference Frame (ITRF). More details can be found in Earth Observation Mission CFI
Software documentation or at https://en.wikipedia.org/wiki/ECEF.
velocity Velocity vector record. This record contains the platform velocity data with respect to the Earth-fixed velocityType 1
reference frame.
attitude Attitude data record. This record contains the attitude quaternions and an angular velocity vector which attitudeType 1 .. 1500
together describe the attitude state of the platform at the annotated time. With a minimum orbit/attitude
update rate of 1s and a maximum product length of 25 minutes, the maximum size of this list is 1500
elements.
wx X component of angular velocity vector as extracted from ancillary attitude data [degrees/s]. double 1
wy Y component of angular velocity vector as extracted from ancillary attitude data [degrees/s]. double 1
roll Platform roll calculated from ancillary attitude data [degrees]. double 1
pitch Platform pitch calculated from ancillary attitude data [degrees]. double 1
yaw Platform yaw calculated from ancillary attitude data [degrees]. double 1
rawDataAnalysis Raw data analysis information. This record contains data statistics collected from sampling a subset of the rawDataAnalysisType 1 .. 750
raw input data. It contains the values calculated for both the I and Q channels. For individual scene and slice
products there is one rawDataAnalysis record except in the case of IW/EW GRD products, where there will
be one record per swath. For assembled products the list contains all the downlinkInformation records for
each slice included in the assembled product. For a minimum output slice length of 10s, a maximum segment
length of 25 minutes and a maximum 5 swaths, the maximum number of records in the list is 750.
azimuthTime Zero Doppler azimuth time at which this set of raw data analysis values apply [UTC]. timeType 1
iBiasUsedForCorrection I channel bias used for correction (may be different from the calculated bias). double 1
qBiasUsedForCorrection Q channel bias used for correction (may be different from the calculated bias). double 1
iqGainImbalanceUsedForCorrection I/Q gain imbalance used for correction (may be different from the calculated gain). double 1
iqQuadratureDepartureUsedForCorrec I/Q quadrature departure used for correction (may be different from the calculated quadrature double 1
tion departure).
replicaInformation Replica information. This record contains information about the reference and reconstructed replicas. There replicaInformationType 1 .. 5
will be one replica information record per ADS, except for IW/EW GRD products which will contain one
per swath.
referenceReplica Reference replica record. This record contains information about the reference imaging replica that was used referenceReplicaType 1
by the IPF during processing. When the extracted replica is used for processing the information in this record
comes from the calibration pulses at the nominal imaging bandwidth. When the nominal replica is used for
processing the information in this record comes directly from the AUX_INS data.
replicaList Replica list. This element contains a list of the reconstructed replicas created from the PG calibration pulses replicaListType 1
at 100 MHz bandwidth extracted from the downlink. The list contains an entry for each complete calibration
sequence.
azimuthTime Zero Doppler azimuth time of the middle of the calibration sequence that the reference replica was created timeType 1
from [UTC].
chirpSource Source of the reference replica: Nominal or Extracted. chirpSourceType 1
amplitudeCoefficients Reference replica amplitude coefficients. This element contains the count attribute number of single floatCoefficientArray 1
precision floating point values separated by spaces.
phaseCoefficients Reference replica phase coefficients. This element contains the count attribute number of single precision floatCoefficientArray 1
floating point values separated by spaces.
timeDelay Internal time delay [s] representing the average deviation of the replica location from the location of the float 1
transmitted pulse. If the pgSource is Model, then this value is filled with the timeDelay parameter from the
AUX_INS file. If the pgSource is Extracted, then this value is filled with the average internal time delay
calculated across all valid extracted PG replicas reconstructed from the calibration pulses at 100 MHz
bandwidth.
gain Complex gain to be applied to the range match filter to compensate for the amplitude and phase differences complex 1
between the two channels in dual polarisation data.
replica PG chirp replica parameters derived from the calibration pulses at 100 MHz bandwidth, With an average replicaType 0 .. 300
calibration cycle interval of 5s and a maximum product length of 25 minutes, the maximum size of this list is
300 elements.
azimuthTime Zero Doppler azimuth time in azimuth at which replica applies [UTC]. timeType 1
modelPgProductPhase PG product phase value from the input PG product model [radians]. float 1
relativePgProductValidFlag Indicates if the amplitude and phase of the PG product passed relative validation. Set to true if bool 1
|pgProductAmplitude – meanPgProductAmplitude| < pgAmpStdFractionThreshold *
stdDevPgProductAmplitude and |pgProductPhase – meanPgProductPhase| < pgPhaseStdFractionThreshold *
stdDevPgProductPhase; or, false otherwise.
Where pgAmpStdFractionThreshold and pgPhaseStdFractionThreshold are configured threshold values.
PG product values can only be calculated and validated for products that have at least one valid extracted
reconstructed replica. If no valid extracted reconstructed replica exists within the product then this flag will
be set to false for every replica record.
absolutePgProductValidFlag Indicates if the amplitude and phase of the PG product passed the absolute validation. Set to true if bool 1
|pgProductAmplitude – modelPgProductAmplitude| < maxPgAmpErrorThreshold and |pgProductPhase –
modelPgProductPhase| < maxPgPhaseErrorThreshold; or, false otherwise.
Where maxPgAmpErrorThreshold and maxPgPhaseErrorThreshold are configured threshold values and
modelPgProductPhase are values obtained from the PG product model.
PG product values can only be calculated and validated for products that have at least one valid extracted
reconstructed replica. If no valid extracted reconstructed replica exists within the product then this flag will
be set to false for every replica record.
noise Noise parameters derived from noise packets. There are a maximum of two sets of noise parameters per noiseType 0 .. 1500
swath.
azimuthTime Zero Doppler azimuth time of the noise measurement [UTC]. timeType 1
numberOfNoiseLines Number of noise lines used to calculate noise correction factor. uint32 1
count Number of terrain height records within the list. unsignedInt Required
azimuthTime Zero Doppler azimuth time of terrain height measurement [UTC]. timeType 1
value Average terrain height above ocean surface [m]. The value is the average height in the range direction for the double 1
given zero Doppler azimuth time.
azimuthFmRate Azimuth FM rate = c0 + c1(tSR - t0) + c2(tSR - t0)^2. Where tSR = two way slant range time. With a azimuthFmRateType 1 .. 750
minimum azimuth processing block length of approximately 2s and a maximum product length of 25
minutes, the maximum size of this list is 750 elements.
t0 Two way slant range time origin used for azimuth FM rate calculation [s]. double 1
azimuthFmRatePolynomial Azimuth FM rate coefficients array in order of c0 [Hz/s] c1 [Hz/s^2] c2 [Hz/s^3]. doubleCoefficientArray 1
Image annotation data set record. This DSR contains information describing the properties
of the image MDS (such as data type and image dimensions) and the key
parameters/options used during the processing of the image.
Figure 6-16 presents a graphical view of the structure and content of the image ADSR and
the subsequent tables describe the schemas defined in Appendix A2.
imageInformation Image information. This record contains the elements that describe the properties and characteristics of the imageInformationType 1
image MDS.
processingInformation Processing information. This record contains information describing the key options and parameters used by processingInformationType 1
the IPF during image processing.
productFirstLineUtcTime Zero Doppler azimuth time to the mid-slant range of the first line of the image [UTC]. When bi-static timeType 1
correction is performed (bistaticDelayCorrectionApplied set to true) during processing the time annotated is
the time of the imaging of the ground. When bi-static correction is not performed the time annotated is the
time of the reception of the echo.
productLastLineUtcTime Zero Doppler azimuth time to the mid-slant range of the last line of the image [UTC]. When bi-static timeType 1
correction is performed (bistaticDelayCorrectionApplied set to true) during processing the time annotated is
the time of the imaging of the ground. When bi-static correction is not performed the time annotated is the
time of the reception of the echo.
ascendingNodeTime Time of the Ascending Node Crossing (ANX) prior to the start of the image [UTC]. timeType 1
anchorTime Zero Doppler reference time used for processing [UTC]. If the product is a slice product, this time is at the timeType 1
time of the first slice within a segment and all slices within the segment report the same time value.
Otherwise, this time is the same as the productFirstLineUtcTime.
productComposition Product composition indicator, where the valid values are: "Individual", to indicate a full non-sliced product; productCompositionType 1
"Slice", to indicate that this is a single slice of a larger product; and "Assembled", to indicate that this is a
product that has been created by combining multiple slices.
pixelValue Interpretation of the image pixels within the image MDS [Detected or Complex]. pixelValueType 1
outputPixels Data type of output pixels within the image MDS. outputPixelsType 1
azimuthTimeInterval Time spacing between azimuth lines of the output image [s]. double 1
azimuthFrequency Azimuth line frequency of the output image [Hz]. This is the inverse of the azimuthTimeInterval. double 1
numberOfSamples Total number of samples in the output image (image width). uint32 1
numberOfLines Total number of lines in the output image (image length). uint32 1
zeroDopMinusAcqTime Time difference between zero Doppler time and acquisition time of output image lines [s]. double 1
imageStatistics Mean and standard deviation statistics for the image. If the pixelValue field is set to Complex, both the real imageStatisticsType 1
and imaginary parts of the statistics are reported. If the pixelValue field is set to Detected, only the real parts
of the statistics are reported
slice Slice record describing a single slice within a multi-slice segment. sliceType 0 .. 150
sliceNumber Slice number of the slice to which the information in this record applies. uint32 1
rawDataAnalysisUsed False if correction was done using default parameters, true if correction was done using raw data analysis. bool 1
orbitDataFileUsed True if the orbit data used for processing came from an external file, false if the orbit data used for bool 1
processing came from the downlink.
antennaElevationPatternApplied False if antenna elevation pattern correction was not applied, true if antenna elevation pattern correction bool 1
was applied.
antennaAzimuthPatternApplied False if antenna azimuth pattern correction was not applied, true if antenna azimuth pattern correction was bool 1
applied.
antennaAzimuthElementPattern False if antenna azimuth element pattern correction was not applied, true if antenna azimuth element pattern bool 1
Applied correction was applied.
dcMethod Doppler centroid estimation method used during processing. Both the DC calculated from orbit geometry dcMethodType 1
and the DC estimated from the raw data are annotated within the Doppler data set; however, this parameter
describes the actual DC method used during image processing.
dcInputData Type of input data used for Doppler centroid estimation. dcInputDataType 1
rangeSpreadingLossCompensation False if range spreading loss compensation was not performed, true if range spreading loss compensation bool 1
Applied was performed.
srgrConversionApplied False if slant range to ground range conversion has not been performed, true if slant range to ground range bool 1
conversion has been performed.
detectionPerformed False if detection has not been performed, true if detection has been performed. bool 1
thermalNoiseCorrectionPerformed False if thermal noise correction has not been performed, true if thermal noise correction has been bool 1
performed.
chirpSource Chirp source used for range compression. chirpSourceType 1
inputDimensionsList Input dimensions list. This element contains a list of inputDimensions records which describe the number inputDimensionsListType 1
of input samples and lines.
referenceRange Range spreading loss reference slant range [m]. The range spreading loss is compensated by amplitude double 1
scaling each range sample by 1/Grsl(R) where: Grsl(R) = (rRef/R) 1/3; and, R = slant range of sample.
ellipsoidName Name of the reference ellipsoid used when processing this product. string 1
bistaticDelayCorrectionApplied False if bi-static delay correction was not applied, true if bi-static delay correction was applied. bool 1
topsFilterConvention Name of the TOPS filter convention used during processing. This field describes how the TOPS topsFilterConventionType 1
ramping/de-ramping filters are defined. If set to "Only Echo Lines" then the filter is defined using only the
echo lines in a burst; otherwise, if set to "All Lines" then the filter is defined using all the lines in a burst.
orbitSource Source of the orbit data used during processing. Set to “Extracted” if the orbit information extracted from orbitAttitudeSourceType 1
the sub-commutated acillary data in the source packet headers is used during processing. Set to “Auxiliary”
if the orbit information from an input auxiliary file is used during processing.
attitudeSource Source of the attitude data used during processing. Set to “Extracted” if the attitude information extracted orbitAttitudeSourceType 1
from the sub-commutated acillary data in the source packet headers is used during processing. Set to
“Auxiliary” if the attitude information from an input auxiliary file is used during processing.
swath Input swath to which the processing parameters were applied. swathType 1
rangeProcessing Range processing information. This record describes the parameters used by the IPF during range processingParametersType 1
processing.
azimuthProcessing Azimuth processing information. This record describes the parameters used by the IPF during azimuth processingParametersType 1
processing.
processorScalingFactor Processor scaling factor. This value includes the input scaling factor and the range and azimuth oversampling float 1
factors from the auxiliary input and is applied multiplicatively to the image data during processing. This is
the value referred to as kproc in [R-14]
windowType Name of the weighting window type used during processing. weightingWindowType 1
windowCoefficient Value of the weighting window coefficient used during processing. double 1
lookBandwidth Bandwidth for each look used during processing [Hz]. double 1
inputDimensions Input dimensions. This record contains the dimensions of the input data in terms of number of input samples inputDimensionsType 1 .. 750
and lines. For individual scene and slice products there is one inputDimensions record, except in the case of
IW/EW GRD products which contain one record per swath. For assembled products the list contains all the
inputDimensions records for each slice included in the assembled product. For a minimum output slice length
of 10s, a maximum segment length of 25 minutes and a maximum of 5 swaths, the maximum number of
records in the list is 750.
azimuthTime Zero Doppler azimuth time to which this set of dimensions applies [UTC]. timeType 1
Doppler centroid data set record. This DSR contains information about the Doppler centroid values estimated and used during image processing.
Figure 6-17 presents a graphical view of the structure and content of the image ADSR and the subsequent tables describe the schemas defined in
Appendix A2.
dcEstimateList List of Doppler centroid estimates that have been calculated by the IPF during image processing. The list dcEstimateListType 1
contains an entry for each Doppler centroid estimate made along azimuth.
dcEstimate Doppler centroid estimate record which contains the Doppler centroid calculated from geometry and dcEstimateType 1 .. 1500
estimated from the data, associated signal-to-noise ratio values and indicates which DCE method was used
by the IPF during image processing. With a minimum Doppler centroid update rate of 1s (for IW and EW
where the Doppler is recalculated for every burst cycle) and a maximum product length of 25 minutes, the
maximum size of this list is 1500 elements.
azimuthTime Zero Doppler azimuth time of this Doppler centroid estimate [UTC]. This time represents the centre of the timeType 1
block used to calculate the fune DC estimates used to derive the data DC polynomial.
t0 Two-way slant range time origin for Doppler centroid estimate [s]. double 1
geometryDcPolynomial Doppler centroid estimated from orbit, expressed as the following polynomial (assuming 5 coefficients): floatCoefficientArray 1
DopplerCentroid = d 0 + d1 (t SR − t0 ) + d 2 (t SR − t0 ) + d 3 (t SR − t0 ) + d 4 (t SR − t0 )
2 3 4
DopplerCentroid = d 0 + d1 (t SR − t0 ) + d 2 (t SR − t0 ) + d 3 (t SR − t0 ) + d 4 (t SR − t0 )
2 3 4
fineDceAzimuthStopTime Last zero Doppler azimuth time of the block of signal data used for the fine DC estimates [UTC]. timeType 1
fineDceList List of the fine Doppler centroid estimates for this block. This element is a list of fineDce records which fineDceListType 1
contain the fine Doppler centroid frequencies that were used for fitting the data polynomial for this block.
fineDce Fine Doppler centroid estimate. Each estimate represents the Doppler frequency at the given slant range fineDceType 0 .. 100
time within the current block. Approximately 20 estimates are performed per swath so for 5 swaths, the
maximum number of estimates in this list is 100.
slantRangeTime Two way slant range time to Doppler centroid frequency estimate [s]. double 1
Antenna elevation pattern (AEP) data set record. This DSR contains information describing the elevation antenna pattern and how it was applied by
the IPF during image processing.
Figure 6-18 presents a graphical view of the structure and content of the Antenna Pattern ADSR and the subsequent tables describe the schemas
defined in Appendix A2.
antennaPatternList Antenna pattern list. This element is a list of antennaPattern records that describe the antenna elevation antennaPatternListType 1
pattern as it is updated in azimuth. The list contains an entry for each AEP update made along azimuth.
count Number of antenna pattern records within the list. unsignedInt required
azimuthTime Zero Doppler azimuth time at which antenna pattern applies [UTC]. timeType 1
slantRangeTime Two-way slant range time array for this antenna pattern [s]. This array contains the count attribute number doubleArray 1
of double floating point values (i.e. one value per point in the antenna pattern), separated by spaces.
elevationAngle Corresponding elevation angle for this antenna pattern [degrees]. This array contains the count attribute floatArray 1
number of floating point values (i.e. one value per point in the antenna pattern), separated by spaces. This
array contains the same number of values as the slantRangeTime array.
elevationPattern Corresponding two-way antenna elevation pattern value for this point. This array contains the count complexArray 1
attribute number of complex floating point values (i.e. one value per point in the antenna pattern),
separated by spaces in the order I Q I Q I Q ... This array contains the same number of values as the
slantRangeTime array.
incidenceAngle Corresponding incidence angle value for this point. This array contains the count attribute number of floatArray 1
floating point values (i.e. one value per point in the antenna pattern), separated by spaces [degrees]. This
array contains the same number of values as the slantRangeTime array.
terrainHeight Average terrain height in range for this antenna pattern [m]. double 1
roll Estimated roll angle for this antenna pattern [degrees]. double 1
Swath timing data set record. This DSR contains the information about the bursts within the image MDS including the burst dimensions, burst
timing and burst location. This DSR is specific to IW and EW SLC products.
Figure 6-19 presents a graphical view of the structure and content of the Swath Timing ADSR and the subsequent tables describe the schemas
defined in Appendix A2.
linesPerBurst Number of range lines within each burst (constant for all bursts within the swath). uint32 1
samplesPerBurst Number of range samples within each burst (constant for all bursts within the swath). uint32 1
burstList Burst list. This element contains a time ordered list of all the bursts within this swath. The list contains a burstListType 1
burst record for each burst within this swath. This list is only applicable to IW and EW SLC products and
has a length of zero for all others.
burst Burst table entry. This record contains the information for a single burst entry including the dimensions of burstType 0 .. 1500
the burst, the timing of the burst and where it is located within the image MDS. With an approximate burst
cycle time of 1s and a maximum product length of 25 minutes, the maximum size of this list is 1500
elements.
azimuthTime Zero Doppler azimuth time of the first line of this burst [UTC]. timeType 1
azimuthAnxTime Zero Doppler azimuth time of the first line of this burst relative to the Ascending Node Crossing (ANX) double 1
time. [s].
sensingTime Sensing time of the first input line of this burst [UTC]. timeType 1
byteOffset Byte offset of this burst within the image MDS. uint64 1
Geo-location grid data set record. This DSR describes the geodetic position (latitude and longitude) of line/pixel combinations within the image
MDS.
Figure 6-20 presents a graphical view of the structure and content of the Geo-location Grid ADSR and the subsequent tables describe the schemas
defined in Appendix A2.
geolocationGridPointList Geolocation grid. This element is a list of geolocationGridPoint records which contains grid point entries geolocationGridPointListType 1
for each line/pixel combination based on a configured resolution. The list contains an entry for each update
made along azimuth.
count Number of geolocation grid point records within the list. unsignedInt required
geolocationGridPoint Geolocation grid point. This record describes geolocation information for a single point (line/pixel geolocationGridPointType 1 ..16500
combination) within the image MDS. For 11 geolocation grid points across range and a new set of points
calculated every 1s in azimuth, for a maximum product length of 25 minutes, the maximum size of this list
is 16500 elements.
azimuthTime Zero Doppler azimuth time to which grid point applies [UTC]. timeType 1
slantRangeTime Two way slant range time to grid point [s]. double 1
line Reference image MDS line to which this geolocation grid point applies. uint32 1
pixel Reference image MDS sample to which this geolocation grid point applies. uint32 1
Coordinate conversion data set record. This DSR contains the annotations required to convert pixels within the image MDS between the slant range
and ground range coordinate systems.
Figure 6-21 presents a graphical view of the structure and content of the Coordinate Conversion ADSR and the subsequent tables describe the
schemas defined in Appendix A2.
coordinateConversionList Coordinate conversion list. This element is a list of coordinateConversion records that describe conversion coordinateConversionListType 1
between the slant range and ground range coordinate systems. The list contains an entry for each update
made along azimuth. This list applies to and is filled in only for GRD products and therefore has a length
of zero for SLC products.
coordinateConversion The polynomial used to convert image pixels between slant range and ground range. The polynomials are coordinateConversionType 0 .. 1500
time-stamped with the zero Doppler azimuth and two way slant range times to which they apply. The
coefficients used on range lines between updates are found by linear interpolation between the updated and
previous values. For a minimum spacing of 1s between coordinateConversion record updates and a
maximum acquisition length of 25 minutes, the maximum number of records in the list is 1500.
azimuthTime Zero Doppler azimuth time at which parameters apply [UTC]. timeType 1
slantRangeTime Two way slant range time to first range sample [s]. double 1
sr0 Slant range origin used for ground range calculation [m]. double 1
srgrCoefficients Polynomial to convert from slant range to ground range. The order of polynomial n is given by the count doubleCoefficientArray 1
attribute -1.
The generic polynomial expression is
GroundRange = g 0 + g1 (sr − sr0 ) + g 2 (sr − sr0 ) + ... + g n−1 (sr − sr0 )
2 n −1
grsrCoefficients Polynomial to convert from ground range to slant range coefficients. The order of polynomial n is given by doubleCoefficientArray 1
the count attribute -1.
The generic polynomial expression is
Swath merging data set record. This DSR contains the annotations for interpreting the way in which IW or EW swaths were merged during GRD
processing. The purpose of this DSR is to provide the information necessary to unambiguously identify the boundaries of each swath within the
image MDS.
Figure 6-22 presents a graphical view of the structure and content of the Swath Merging ADSR and the subsequent tables describe the schemas
defined in Appendix A2. At the end of this section, Figure 6-23 illustrates what the swath merging annotations may look like for two possible
scenarios. The simple case is one in which the optimal range cut line is constant for all swaths and does not change over the azimuth extent of the
image and the more complex case is one in which the optimal range cut line varies for all swaths and is updated multiple times over the azimuth
extent of the image.
swathMergeList Merge information for IW and EW GRD products. This list contains one record per swath. swathMergeListType 1
swathMerge This record contains the information needed to identify where each burst of the given swath was merged swathMergeType 0 .. 5
within the image MDS.
swathBoundsList This list contains the information needed to identify where the current swath has been merged into the swathBoundsListType 1
image MDS. Each swathBounds record represents a rectangular area that may include several burst merged
in azimuth. These records do not describe where individual bursts were merged in azimuth, within a swath.
count Number of swath bounds records within the list. unsignedInt required
swathBounds Swath boundary record. This record contains the information needed to identify the position of the swath swathBoundsType 1 .. 1500
within the image. The swath boundary is identified by a rectangular area defined by the points
(firstRangeSample,firstAzimuthLine) and (lastRangeSample,lastAzimuthLine). The optimal range cut line
can vary in azimuth and so a new record is included for each swath boundary update in azimuth. It is
important to note that the information on the azimuth cut line is lost and not represented by these
annotations. Although a line in azimuth is implicitly created by each bounding box, this does not
necessarily represent the azimuth cut line used during swath merging. For an average spacing of 1s
between swath bound updates and a maximum acquisition length of 25 minutes, the maximum number of
records in the list is 1500.
firstAzimuthLine First azimuth line of the swath boundary [lines]. This point represents the azimuth origin of the swath uint32 1
boundary.
firstRangeSample First range sample of the swath boundary [samples]. This point represents the range origin of the swath uint32 1
boundary.
lastAzimuthLine Last azimuth line of the swath boundary [lines]. Relative to the firstAzimuthLine, this point represents the uint32 1
azimuth extent of the swath boundary.
lastRangeSample Last range sample of the swath boundary [samples]. Relative to the firstRangeSample, this point represents uint32 1
the range extent of the swath boundary.
The annotations for the simple case in the graph below contain a single swathBoundsType entry for each swath that represents a bounding box
covering the entire azimuth extent of the image. The annotations in the complex case contain multiple swathBoundsType entries for each swath –
4, 6 and 3 for IW1, IW2 and IW3 respectively – that collectively describe the location of the swaths within the image. To identify the applicable set
x
of annotations for each bounding box the notation iwM ( n) y is used where M is the swath number – 1, 2 or 3, n is the index of the
swathBoundsType annotation increasing as the optimal range cut line changes in azimuth and the superscript/subscript pair x/y describes a point in
the image defined by (firstRangeSample,firstAzimuthLine) or (lastRangeSample,lastAzimuthLine).
Simple Case: Constant Optimal Range Cut Line Complex Case: Varying Optimal Range Cut Line
iw1(3)lastRangeS ample
lastAzimuthLine
iw1(3) firstRangeSample
firstAzimuthLine
iw1(0)lastRangeS ample
lastAzimuthLine
iw1(2)lastRangeS ample
lastAzimuthLine
lastRangeSample
iw3(0) lastAzimuthLine
iw1(2) firstRangeSample
firstAzimuthLine
iw1(1) firstRangeSample
iw2(0) firstRangeSample
firstAzimuthLine
firstAzimuthLine
iw1(0) firstRangeSample
firstAzimuthLine
iw1(0)lastRangeS ample
lastAzimuthLine
A
z
i iw1(0) firstRangeSample
Rng firstAzimuthLine
The L1 Calibration ADS provides four calibration LUTs with every product. Applying any of these tables undoes the application output scaling
introduced by the processor and scales the image to achieve the desired type of absolute calibration, notably:
Three of these LUTs allow one to convert the digital numbers in the image MDS into 0 , 0 or radiometrically calibrated imagery – depending
on which LUT is used – by applying a range dependent gain (and a constant offset in the GRD case) to the image data. Note that in order to achieve
the desired calibration the absolute calibration constant Kabs (absoluteCalibrationConstant), has also been built into these tables. The fourth LUT,
the dn LUT allows one to recover the original DN value that the image had before the scaling by the application LUT (therefore the dn LUT does
not include the external calibration factor Kabs).
In order to convert the DN of a given range pixel i in a Sentinel-1 SAR image to a calibrated value or the original DN, the user has to apply one of
the following formulae:
2
DN i
value(i) = 2
Ai
For any pixel i that falls between points in the LUT the value is found by bilinear interpolation.
Figure 6-24 presents a graphical view of the structure and content of the L1 Calibration LUT Data Set and the subsequent tables describe the
schemas defined in Appendix A3.
adsHeader ADS header data set record. This DSR contains information that applies to the entire data set. adsHeaderType 1
calibrationInformation Calibration information. This DSR holds parameters applicable to the image calibration. calibrationInformationType 1
calibrationVectorList Calibration vector list. This element is a list of calibrationVector records that contain the absolute calibrationVectorListType 1
calibration vectors required to derive radiometrically calibrated imagery from the image MDS. The list
contains an entry for each update made along azimuth.
absoluteCalibrationConstant Swath dependent absolute calibration constant (Kabs). This value comes from the auxiliary input and is double 1
built in to the absolute calibration vectors sigmaNought, betaNought and gamma.
calibrationVector Calibration vector record. This record holds the calibration vectors and associated fields required to derive calibrationVectorType 0 .. 1500
radiometrically calibrated imagery from the image MDS. With a minimum calibration vector update rate of
1s and a maximum product length of 25 minutes, the maximum size of this list is 1500 elements. The
azimuth spacing used will be different for different modes and product types.
azimuthTime Zero Doppler azimuth time at which calibration vector applies. timeType 1
pixel Image pixel at which the calibration vector applies. This array contains the count attribute number of intArray 1
integer values (i.e. one value per point in the calibration vectors), separated by spaces. The maximum
length of this array will be one value for every pixel in an image line, however in general the vectors will
be subsampled.
sigmaNought Sigma nought calibration vector. This array contains the count attribute number of floating point values floatArray 1
separated by spaces. The values in this vector are aligned with the pixel vector.
betaNought Beta nought calibration vector. This array contains the count attribute number of floating point values floatArray 1
separated by spaces. The values in this vector are aligned with the pixel vector.
gamma Gamma calibration vector. This array contains the count attribute number of floating point values floatArray 1
separated by spaces. The values in this vector are aligned with the pixel vector.
dn Digital number calibration vector. This array contains the count attribute number of floating point values floatArray 1
separated by spaces. The values in this vector are aligned with the pixel vector.
The L1 Noise ADS provides a LUT – with values provided in linear power – that can be used to derive calibrated noise profiles which match the
calibrated GRD data.
More specifically, in order to convert the values provided in the noise LUT to 0 , 0 or calibrated noise or to the noise estimated by the IPF
during SLC processing, the noise LUT must be scaled by the corresponding calibration LUT ( 0 , 0 or or dn , respectively):
i
noise(i ) =
Ai ²
i = noiseLut(i)
Once the calibrated noise profile has been obtained as above, the noise can be removed from the GRD data by subtraction.
It is also possible to obtain calibrated data and remove the estimated noise in one step by considering the subtraction of the noise in the formula
described in 6.3.2 as follows:
( DN i − i )
2
value(i ) = 2
Ai
For any pixel i that falls between points in the LUT the value is found by bilinear interpolation.
Figure 6-25 presents a graphical view of the structure and content of the L1 Noise LUT Data Set and the subsequent tables describe the schemas
defined in Appendix A4.
adsHeader ADS header data set record. This DSR contains information that applies to the entire data set. adsHeaderType 1
noiseRangeVectorList Range noise vector list. This element is a list of noiseRangeVector records that contain the range thermal noiseRangeVectorListType 1
noise estimation for the image MDS. The list contains an entry for each update made along azimuth.
noiseAzimuthVectorList Azimuth noise vector list. This annotation divides the image in blocks providing a list of azimuth noise noiseAzimuthVectorListType
vector records that contain the thermal noise estimation for the block. The block belongs to a (sub-)swath
(i.e. it can't cross by design two swaths) and it is delimited by firstAzimuthLine, lastAzimuthLine,
firstRangeSample, lastRangeSample.
noiseRangeVector Noise range vector. This record contains the thermal noise estimation annotations which can be used to noiseRangeVectorType 0 .. 1500
remove thermal noise from the image. With a minimum noise vector update rate of 1s and a maximum
product length of 25 minutes, the maximum size of this list is 1500 elements. The azimuth spacing used
will be different for different modes and product types.
Note: the noise removal can create negative values that requires to be clipped. The clipping is made such
that it is not possible to recover the original pixel values if one want to re-instate the noise vector.
azimuthTime Zero Doppler azimuth time at which noise vector applies. timeType 1
noiseAzimuthVector Noise azimuth vector. This record contains the thermal noise estimation annotations which can be used to noiseAzimuthVectorType 0 .. 1500
remove thermal noise from the image.
Note: the noise removal can create negative values that requires to be clipped. The clipping is made such
that it is not possible to recover the original pixel values if one want to re-instate the noise vector.
line Image line at which the noise vector applies. This array contains the count attribute number of integer intArray 1
values (i.e. one value per point in the noise vector), separated by spaces. The maximum length of this array
will be one value for every line in an image pixel, however in general the vectors will be subsampled.
noiseAzimuthLut Azimuth thermal noise correction vector power values. This array contains the count attribute number of floatArray 1
floating point values separated by spaces.
The map overlay data set is a Keyhole Markup Language (KML) file [R-10] that
describes the product coverage area and is suitable for viewing in any application
that supports KML. Figure 6-26 shows a graphical example of the map overlay in
which the composite Quick-look image from Section 6.2.2 is geo-referenced and
displayed as an overlay in Google Earth.
The map overlay data set contains the KML elements required to select the product’s
Quick-look image, position it on the map and display it. Figure 6-27 presents a
graphical view of the XML structure of the map overlay data set and the content and
structure are presented in the subsequent tables. Note that data types in the
following tables that are prefixed with “kml:” are part of the KML specification [R-
10] and types prefixed with “gx:” are part of the Google extensions to KML [R-13].
name A descriptive name for the map overlay. This will string 1
typically be set to the name of the product folder.
icon This structure describes the image file used on the kml:LinkType 0 .. 1
map overlay.
gx:LatLonQuad Contains the latitude and longitude coordinates used gx:LatLonQuadType 1
to position the image overlay on the map.
The Product Preview is a Hypertext Markup Language (HTML) file that presents a
graphical overview of the product through use of the Quick-look MDS and provides
access to the data sets within the product through a simple user interface of HTML
hyperlinks to the product files on the local file system. The Product Preview ADS is
formatted using an XML style sheet which may be modified to refine the look of the
HTML page, and so the ADS may evolve over time. Figure 6-28 shows an example
of what the Product Preview might look like and Table 6-113 lists the content
included in the product preview ADS.
Header Graphic The Product Preview ADS should include a header graphic. This Optional
element is an image that is meaningful to or identifies the
organisation that created the product or for which the product was
created. The graphic may include any generally relevant imagery
and more specific items such as company logos and copyright
notices.
Product Name The Product Preview ADS shall include a field which identifies the Mandatory
name of the product to which this ADS applies
Manifest The Product Preview ADS shall include an accessible link to the Mandatory
product manifest file on the local file system.
A XML SCHEMAS
Defines the primitive data types used by the Sentinel-1 product schemas