Files produced

Final products 

Orthorectified S2 tiles 

Content:

Complete final product: concatenated orthorectified S1 images on S2 grid

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(output)/{tilename}/ by default

Directory format:

{out_dir}/{tile_name}, see [Processing].dname_fmt.tiled

File name:

s1{a|b|c}_{tilename}_{polarity}_{orbitdirection}_{orbitnumber}_{YYYYMMDD}txxxxxx.tif when the tile has been assembled from the concatenation of two S1 images
s1{a|b|c}_{tilename}_{polarity}_{orbitdirection}_{orbitnumber}_{YYYYMMDD}t{hhmmss}.tif when the tile has been produced from a single S1 image

Note

\(σ^0_{T}\) calibrated files will have their name end in _NormLim.tif

\(γ^0_{T}\) RTC files will have their name end in _GammaNaughtRTC.tif

File name format:

{flying_unit_code}_{tile_name}_{polarisation}_{orbit_direction}_{orbit}_{acquisition_stamp}.tif, see [Processing].fname_fmt.concatenation
or, {flying_unit_code}_{tile_name}_{polarisation}_{orbit_direction}_{orbit}_{acquisition_stamp}_NormLim.tif, see [Processing].fname_fmt.lia_corrected
or, {flying_unit_code}_{tile_name}_{polarisation}_{orbit_direction}_{orbit}_{acquisition_stamp}_GammaNaughtRTC.tif, see [Processing].fname_fmt.gamma_area_corrected

Product encoding:

defaults to Float32 GeoTIFF, deflate compressed
defined in [Processing].creation_options.tiled

Metadata:

GeoTIFF metadata will contain: the metadata coming from the input S1 GRD products, the extra ones specified in [Metadata] configuration section, plus the following ones:

Metadata	Value
`ACQUISITION_DATETIME`	time of the first S1 image (in UTC format since v1.1)
`ACQUISITION_DATETIME_1`	time of the first S1 image (in UTC format since v1.1)
`ACQUISITION_DATETIME_2`	time of the second S1 image (in UTC format since v1.1)
`CALIBRATION`	chosen calibration option
`DEM_INFO`	Key to identify which DEM has been used. Comes from [Paths].dem_info or basename([Paths].dem_dir).
`DEM_INFO`	Key to identify which DEM has been used. Comes from [Paths].dem_info or basename([Paths].dem_dir).
`FLYING_UNIT_CODE`	`s1{a\|b\|c}`
`IMAGE_TYPE`	`BACKSCATTERING`
`INPUT_S1_IMAGES`	List of the input Sentinel-1 images used to generate this product
`LIA_FILE`	(when applies) name of the LIA map file used for Normlim calibration
`GAMMA_AREA_FILE`	(when applies) name of the γ area map file used for \(γ^0_{T}\) RTC calibration
`NOISE_REMOVED`	chosen noise removal option
`ORBIT_NUMBER`	`{orbitNumber}`
`ORBIT_DIRECTION`	`{orbitDirection}`
`ORTHORECTIFICATION_INTERPOLATOR`	chosen orthorectification interpolation method option
`ORTHORECTIFIED`	`true`
`POLARIZATION`	`{polarisation}`
`RELATIVE_ORBIT_NUMBER`	`{relativeOrbitNumber}`
`S2_TILE_CORRESPONDING_CODE`	`{tilename}`
`SPATIAL_RESOLUTION`	chosen output spatial resolution option
`TIFFTAG_DATETIME`	is updated with the time when the tile has been generated by S1 Tiling.
`TIFFTAG_IMAGEDESCRIPTION`	`{calibration} calibrated orthorectified Sentinel-1{A\|B\|C} IW GRD on S2 tile`
`TIFFTAG_SOFTWARE`	`S1 Tiling v{version}` – develop currently

Mask files 

Content:

Binary image containing mask on valid data. It is a mask on no-data pixels.

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(output)/{tilename}/ by default

Directory format:

{out_dir}/{tile_name}, see [Processing].dname_fmt.mask

File name:

the same as the one from the S2 tiles, with _BorderMask appended

Product encoding:

defaults to Byte GeoTIFF, deflate compressed
defined in [Processing].creation_options.mask

Metadata:

This file contains the same metadata as the one from the S2 tile product it has been generated from, with the following as the only difference:

Metadata	Value
`IMAGE_TYPE`	`MASK`
`TIFFTAG_IMAGEDESCRIPTION`	`Orthorectified Sentinel-1{A\|B\|C} IW GRD smoothed border mask S2 tile`

Filtered files 

Content:

Complete final product, after applying the speckle filtering if option is activated

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(output)/filtered/{tilename}/ by default

Directory format:

{out_dir}/filtered/{tile_name}, see [Processing].dname_fmt.filtered

File name:

the same as the one from the S2 tiles, with _filtered appended

File name format:

{flying_unit_code}_{tile_name}_{polarisation}_{orbit_direction}_{orbit}_{acquisition_stamp}_filtered.tif, see [Processing].fname_fmt.filtered
or, {flying_unit_code}_{tile_name}_{polarisation}_{orbit_direction}_{orbit}_{acquisition_stamp}_NormLim_filtered.tif
or, {flying_unit_code}_{tile_name}_{polarisation}_{orbit_direction}_{orbit}_{acquisition_stamp}_GammaNaughtRTC_filtered.tif

Product encoding:

defaults to Float32 GeoTIFF, deflate compressed
defined in [Processing].creation_options.filtered

Metadata:

This file contains the same metadata as the one from the S2 tile product it has been generated from, with the following as the only difference:

Metadata	Value
`FILTERED`	`true`
`FILTERING_METHOD`	The method used: `Lee`/`Frost`/`gammamap`/`Kuan`
`FILTERING_WINDOW_RADIUS`	The window radius used.
`FILTERING_DERAMP`	The deramp factor used (only for Frost method)
`FILTERING_NBLOOKS`	The number of looks used (only for Lee, Gammamap and Kuan methods)

Local Incidence Angle map files 

Content:

Map of sines of Local Incidence Angle (LIA),
and optionally of LIA expressed in degrees and scaled by a factor of 100.

Given T, the target point on Earth’s surface, and S the SAR sensor position, the LIA is the angle Θ_LIM between the ground normal projected in range plane \(\overrightarrow{n}\) (plane defined by S, T, and Earth’s centre) and \(\overrightarrow{TS}\).

The values have been computed directly on the Sentinel-2 tile from the S2 tile footprint, and a matching precise orbit file (EOF) of the chosen relative orbit.

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(output_lia)/ by default

Directory format:

{lia_dir}, see [Processing].dname_fmt.lia_product

File names:

sin_LIA_s1{a|b|c}_{tilename}_{orbitnumber}.tif – \(sin(Θ_{LIM})\)
LIA_s1{a|b|c}_{tilename}_{orbitnumber}.tif – \(100 * Θ°_{LIM}\)

File name format:

{LIA_kind}_{flying_unit_code}_{tile_name}_{orbit}.tif, see [Processing].fname_fmt.lia_product

Product encoding:

defaults to Float32 (/Uint16) GeoTIFF, deflate compressed
defined in [Processing].creation_options.lia_sin (/[Processing].creation_options.lia_deg)

Metadata:

GeoTIFF metadata will contain the extra metadata specified in [Metadata] configuration section, plus the following ones:

Metadata	Value
`DATA_TYPE`	`100 * degrees(LIA)` / `sin(LIA)`
`DEM_INFO`	Key to identify which DEM has been used. Comes from [Paths].dem_info or basename([Paths].dem_dir).
`DEM_LIST`	List of DEM tiles used to generate the file
`DEM_RESAMPLING_METHOD`	chosen DEM resampling method option
`EOF_FILE`	Precise orbit file used to generate the file
`FLYING_UNIT_CODE`	`s1{a\|b\|c}`
`GEOID_ORTHORECTIFICATION_INTERPOLATOR`	chosen orthorectification interpolation_method option
`IMAGE_TYPE`	`LIA`
`RELATIVE_ORBIT_NUMBER`	`{orbitnumber}`
`ORTHORECTIFIED`	`true`
`S2_TILE_CORRESPONDING_CODE`	`{tilename}`
`SPATIAL_RESOLUTION`	chosen output spatial resolution option
`TIFFTAG_DATETIME`	is updated with the time when the tile has been generated by S1 Tiling.
`TIFFTAG_IMAGEDESCRIPTION`	`sin(LIA)/100 * degress(LIA) on S2 grid`
`TIFFTAG_SOFTWARE`	`S1 Tiling v{version}` – develop currently

Incidence Angle map files 

Different Incidence Angle maps may be produced depending on [Processing.ia_maps_to_produce].

These files can be used to convert S1Tiling products on MGRS sentinel-2 tile from one calibration (β°, σ°, γ°) to another.

Content:

Incidence Angle (IA) on the WGS84 ellipsoid expressed in degrees and scaled by a factor of 100.
Map of cosines of IA,
Map of sines of IA,
Map of tangent of IA,

Given E, the target point on ellipsoid’s surface, and S the SAR sensor position, the IA is the angle Θ_E between the ellipsoid surface normal projected in range plane \(\overrightarrow{n}\) (plane defined by S, E, and Earth’s centre) and \(\overrightarrow{ES}\).

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(output_ia)/ by default

Directory format:

{ia_dir}, see [Processing].dname_fmt.ia_product

File names:

IA_s1{a|b|c}_{tilename}_{orbitnumber}.tif – \(100 * Θ_{E}\)
cos_IA_s1{a|b|c}_{tilename}_{orbitnumber}.tif – \(cos(Θ_{E})\)
sin_IA_s1{a|b|c}_{tilename}_{orbitnumber}.tif – \(sin(Θ_{E})\)
tan_IA_s1{a|b|c}_{tilename}_{orbitnumber}.tif – \(tan(Θ_{E})\)

File name format:

{IA_kind}_{flying_unit_code}_{tile_name}_{orbit}.tif, see [Processing].fname_fmt.ia_product

Product encoding:

defaults to Float32 (/Uint16) GeoTIFF, deflate compressed
defined in [Processing].creation_options.ia_sin (/[Processing].creation_options.ia_deg)

Metadata:

GeoTIFF metadata will contain the extra metadata specified in [Metadata] configuration section, plus the following ones:

Metadata	Value
`DATA_TYPE`	`100 * degrees(IA)` / `cos(IA)` / `sin(IA)` / `tan(IA)`
`EOF_FILE`	Precise orbit file used to generate the file
`FLYING_UNIT_CODE`	`s1{a\|b\|c}`
`IMAGE_TYPE`	`IA`
`ORTHORECTIFIED`	`true`
`RELATIVE_ORBIT_NUMBER`	`{orbitnumber}`
`S2_TILE_CORRESPONDING_CODE`	`{tilename}`
`SPATIAL_RESOLUTION`	chosen output spatial resolution option
`TIFFTAG_DATETIME`	is updated with the time when the tile has been generated by S1 Tiling.
`TIFFTAG_IMAGEDESCRIPTION`	`100 * degrees(IA)/cos(IA)/sin(IA)/tan(IA) on S2 grid`
`TIFFTAG_SOFTWARE`	`S1 Tiling v{version}` – develop currently

Gamma Area map file 

Content:

Map of γ area (GAMMA_AREA)

This is the reference γ area corresponding to DEM facet areas seen by each pixel in SAR Geometry. All the seen areas are summed by mean of integral.

The values have been orthorectified on the Sentinel-2 tile from a pair of GAMMA_AREA maps computed on S1 images.

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(output_gamma_area)/ by default

Directory format:

{gamma_area_dir}, see [Processing].dname_fmt.gamma_area_product

File names:

GAMMA_AREA_s1{a|b|c}_{tilename}_{orbitdirection}_{orbitnumber}.tif

File name format:

GAMMA_AREA_{flying_unit_code}_{tile_name}_{orbit_direction}_{orbit}.tif, see [Processing].fname_fmt.gamma_area_product

Product encoding:

defaults to Float32 (/Uint16) GeoTIFF, deflate compressed
defined in [Processing].creation_options.gamma_area

Metadata:

The following metadata is added to the origin S1 images

Metadata	Value
`ACQUISITION_DATETIME`	time of the first S1 image (in UTC format)
`ACQUISITION_DATETIME_1`	time of the first S1 image (in UTC format)
`ACQUISITION_DATETIME_2`	time of the second S1 image (in UTC format)
`DATA_TYPE`	`GAMMA_AREA`
`FLYING_UNIT_CODE`	`s1{a\|b\|c}`
`IMAGE_TYPE`	`GRD`
`INPUT_S1_IMAGES`	List of the input Sentinel-1 images used to generate this product
`ORBIT`	`{orbitnumber}`
`ORBIT_DIRECTION`	`{orbitdirection}`
`ORTHORECTIFIED`	`true`
`S2_TILE_CORRESPONDING_CODE`	`{tilename}`
`SPATIAL_RESOLUTION`	chosen output spatial resolution option
`TIFFTAG_DATETIME`	is updated with the time when the tile has been generated by S1 Tiling.
`TIFFTAG_IMAGEDESCRIPTION`	`Orthorectified GAMMA_AREA Sentinel-1A IW GRD`
`TIFFTAG_SOFTWARE`	`S1 Tiling v{version}` – develop currently

Temporary files 

Before generating the final products, S1 Tiling produces temporary files. Some are removed automatically, others are cached in between several runs to shorten processing times when resuming after an interruption.

Important

It’s up to you, end-user, to clean that directory regularly.

Cut and calibrated S1 images ready for orthorectification 

Content:

S1 images calibrated and cut.

Footprint:

Sentinel-1 input image

Directory:

%(tmp)/S1/

File name:

The same as the origin S1 file with _OrthoReady appended.

Note

An accompanying OTB .geom file was also generated with OTB 7.

Example:

s1a-iw-grd-vv-20200108t044150-20200108t044215-030704-038506-001_sigma_OrthoReady.tiff
s1a-iw-grd-vv-20200108t044150-20200108t044215-030704-038506-001_sigma_OrthoReady.geom

File name format:

fname_fmt.cut_borders = {rootname}_{calibration_type}_OrthoReady.tiff

Product encoding:

Float32 GeoTIFF, uncompressed.

Metadata:

The following metadata are added at this step:

Metadata	Value
`ACQUISITION_DATETIME`	time of the input S1 image (in UTC format since v1.1)
`CALIBRATION`	chosen calibration option
`FLYING_UNIT_CODE`	`s1{a\|b\|c}`
`IMAGE_TYPE`	`GRD`
`INPUT_S1_IMAGES`	Name of the input Sentinel-1 image used to generate this product
`NOISE_REMOVED`	chosen noise removal option
`ORBIT`	`{orbitnumber}`
`ORBIT_DIRECTION`	`{orbitdirection}`
`POLARIZATION`	`{polarisation}`
`TIFFTAG_IMAGEDESCRIPTION`	`{calibration} calibrated Sentinel-1{A\|B\|C} IW GRD`

Note

These files can be kept as a same calibrated and cut S1 image could be orthorectified several times for producing different intersecting S2 tiles.

Note

These temporary files will be produced only if S1Processor is executed with --cache-before-ortho option. In that case, the processing will no longer be done in memory and orthoready files will be produced. You would also have to explicitly clean these temporary files.

Orthorectified S1 images 

Content:: Single concatenated orthorectified S1 image on S2 grid
Footprint:: Sentinel-2 MGRS tile.
Directory:: %(tmp)/S2/{tilename}/
File name:: s1{a|b|c}_{tilename}_{polarity}_{orbitdirection}_{orbitnumber}_{YYYYMMDD}t{hhmmss}_{calibration}.tif
File name format:: fname_fmt.orthorectification = {flying_unit_code}_{tile_name}_{polarisation}_{orbit_direction}_{orbit}_{acquisition_time}_{calibration_type}.tif
Product encoding:: Float32 GeoTIFF, deflate compressed
Metadata:: The metadata listed for the S2 tile product are actually produced at this step.
Clean-up:: These files are removed automatically

DEM VRT on S2 files 

Content:: Virtual aggregate of all the DEM files that fully cover the target Sentinel-2 MRGS tile.
Footprint:: Sentinel-2 MGRS tile.
Directory:: %(tmp)/{random}/
File name:: DEM_tilename.vrt
File name format:: fname_fmt.dem_s2_agglomeration = DEM_{tile_name}.vrt
Product encoding:: VRT
Metadata:: No metadata is added by S1Tiling to these files.
Clean-up:: These files are removed automatically

DEM data projected on S2 tile 

Content:

DEM information projected on S2 tile according to Project DEM on S2 tile

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(tmp)/S2/

File name:

DEM_projected_on_{tilename}.tiff

File name format:

fname_fmt.dem_on_s2 = DEM_projected_on_{tile_name}.tiff

Product encoding:

Float32 GeoTIFF, uncompressed.

Metadata:

The following metadata are added at this step:

Metadata	Value
`DEM_INFO`	Key to identify which DEM has been used. Comes from [Paths].dem_info or basename([Paths].dem_dir).
`DEM_LIST`	List of DEM tiles used to generate the file
`DEM_RESAMPLING_METHOD`	chosen DEM resampling method option
`ORTHORECTIFIED`	`true`
`S2_TILE_CORRESPONDING_CODE`	`{tilename}`
`SPATIAL_RESOLUTION`	chosen output spatial resolution option
`TIFFTAG_IMAGEDESCRIPTION`	`Warped DEM to S2 tile`

Clean-up:

These files are removed automatically.

Height (DEM+Geoid) projected on S2 tile 

Content:

Height information (DEM + Geoid combined) projected on S2 tile according to Project GEOID on S2 tile and Sum DEM + Geoid.

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(tmp)/S2/

File name:

DEM+GEOID_projected_on_{tilename}.tiff

File name format:

fname_fmt.height_on_s2 = DEM+GEOID_projected_on_{tile_name}.tiff

Product encoding:

Float32 GeoTIFF, uncompressed.

Metadata:

The following metadata change from the DEM projected on S2 tile

Metadata	Value
`GEOID_ORTHORECTIFICATION_INTERPOLATOR`	chosen orthorectification interpolation_method option
`TIFFTAG_IMAGEDESCRIPTION`	`DEM + GEOID height info projected on S2 tile`

Clean-up:

Warning

These files still need to be removed manually. This should change eventually, or it may be conditioned to an option.

Ground and sensor position in XYZ ECEF coordinates 

These XYZ ECEF are produced starting from S1Tiling 1.2 from precise orbit files.

Content:

Six bands 64 bits float image that contains ground pixel coordinates and associated sensor position coordinates expressed as XYZ Cartesian pixels in ECEF spatial reference.

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(tmp)/S2/

File name:

XYZ_projected_on_{tile_name}_{orbitnumber}.tif

File name format:

fname_fmt.ground_and_sat_s2 = XYZ_projected_on_{tile_name}_{orbit}.tif

Product encoding:

Float64 GeoTIFF, 6 bands: XCartesian, YCartesian, ZCartesian. SensorXCartesian, SensorXCartesian, SensorZCartesian

Metadata:

The following metadata change from the DEM+GEOID projected on S2 tile

Metadata	Value
`DEM_INFO`	Key to identify which DEM has been used. Comes from [Paths].dem_info or basename([Paths].dem_dir).
`DEM_LIST`	List of DEM tiles used to generate the file
`EOF_FILE`	Precise orbit file used to generate the file
`FLYING_UNIT_CODE`	`s1{a\|b\|c}`
`IMAGE_TYPE`	`XYZ`
`ORTHORECTIFIED`	`true`
`RELATIVE_ORBIT_NUMBER`	`{orbitnumber}`
`TIFFTAG_IMAGEDESCRIPTION`	`XYZ ground and satellite positions on S2 tile`

Clean-up:

These files are removed automatically.

WGS84 Ellipsoid surface and sensor position in XYZ ECEF coordinates 

These XYZ ECEF are produced from precise orbit files.

Content:

Six bands 64 bits float image that contains ellipsoid surface pixel coordinates and associated sensor position coordinates expressed as XYZ Cartesian pixels in ECEF spatial reference.

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(tmp)/S2/

File name:

XYZ_projected_on_ellipsoid_{tile_name}_{orbitnumber}.tif

File name format:

fname_fmt.ground_and_sat_s2_ellipsoid = XYZ_projected_on_ellipsoid_{tile_name}_{orbit}.tif

Product encoding:

Float64 GeoTIFF, 6 bands: XCartesian, YCartesian, ZCartesian. SensorXCartesian, SensorXCartesian, SensorZCartesian

Metadata:

The following metadata is written in the product file

Metadata	Value
`band.XCart`, `band.YCart`, `band.ZCart`	Band numbers where X, Y and Z ellipsoid surface coordinates are stored
`band.XSatPos`, `band.YSatPos`, `band.ZSatPos`	Band numbers where satellite X, Y and Z coordinates are stored
`EOF_FILE`	Precise orbit file used to generate the file
`FLYING_UNIT_CODE`	`s1{a\|b\|c}`
`IMAGE_TYPE`	`XYZ`
`ORTHORECTIFIED`	`true`
`RELATIVE_ORBIT_NUMBER`	`{orbitnumber}`
`S2_TILE_CORRESPONDING_CODE`	`{tilename}`
`SPATIAL_RESOLUTION`	chosen output spatial resolution option
`TIFFTAG_DATETIME`	is updated with the time when the tile has been generated by S1 Tiling.
`TIFFTAG_IMAGEDESCRIPTION`	`XYZ ground and satellite positions on S2 tile on ellipsoid`
`TIFFTAG_SOFTWARE`	`S1 Tiling v{version}` – develop currently

Clean-up:

These files are removed automatically.

DEM VRT on S1 files 

Content:: Virtual aggregate of all the DEM files that fully cover the associated input S1 image.
Footprint:: Outer bounding box of all the DEM that intersect the Sentinel-1 reference image.
Directory:: %(tmp)/S1/
File name:: DEM_s1{a|b|c}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.vrt
File name format:: fname_fmt.dem_s1_agglomeration = DEM_{polarless_rootname}.vrt
Product encoding:: VRT
Metadata:: No metadata is added by S1Tiling to these files.
Clean-up:: These files are removed automatically

Resampled DEM 

Content:

Resampled version of all the DEM files that fully cover the associated input S1 images (in both polarities).

Footprint:

Outer bounding box of all the DEM that intersect the Sentinel-1 reference image.

Directory:

%(tmp)/S1/

File name:

RESAMPLED_DEM_s1{a|b|c}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.tiff

File name format:

fname_fmt.resampled_dem = RESAMPLED_DEM_{polarless_basename}

Product encoding:

Float32 GeoTIFF, uncompressed.

Metadata:

The following metadata change from the DEM vrt intersecting S1 image

Metadata	Value
No-data value	NaN
`DEM_RESAMPLING_METHOD`	`X{factor_x}, Y{factor_y}`

Clean-up:

These files are removed automatically

Height (DEM+Geoid) on resampled DEM geometry 

Content:

Height information (DEM + Geoid combined) on the footprint of the DEM files that intersect the Sentinel-1 reference image according to Project GEOID on (/resampled) DEM and Sum DEM + Geoid.

Footprint:

Outer bounding box of all the DEM that intersect the Sentinel-1 reference image.

Directory:

%(tmp)/S1/

File name:

DEM+GEOID_s1{a|b|c}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.tiff

File name format:

fname_fmt.height_4rtc = DEM+GEOID_{polarless_basename}

Product encoding:

Float32 GeoTIFF, uncompressed.

Metadata:

The following metadata change from the DEM vrt intersecting S1 image, or the Resampled DEM image.

Metadata	Value
`GEOID_ORTHORECTIFICATION_INTERPOLATOR`	chosen orthorectification interpolation_method option
`TIFFTAG_IMAGEDESCRIPTION`	`DEM + GEOID height info projected on S2 tile`

Clean-up:

These files are removed automatically

S1 coordinates projected on DEM geometry 

Content:

Pixels are in the Virtual DEM geometry. Their values contain the XYZ Cartesian coordinates of the pixel and the position of the matching pixel in the original Sentinel-1 image. This file is produced with our fork of DiapOTB SARDEMProjection application.

Footprint:

Outer bounding box of all the DEM that intersect the Sentinel-1 reference image.

Directory:

%(tmp)/S1/

File name:

S1_on_DEM-s1{a|b|c}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.tif

File name format:

fname_fmt.s1_on_dem = S1_on_DEM_{polarless_basename}

Product encoding:

Float32 GeoTIFF, deflate compressed, and tiled by default. But float64 precision is recommended when possible.
7 bands: C (column into SAR image), L (line into SAR image), Z and Y, X-Cartesian, Y-Cartesian, Z-Cartesian.

Metadata:

The following metadata is added to the origin S1 images

Metadata	Value
`ACQUISITION_DATETIME`	time of the first S1 image (in UTC format since v1.1)
`DEM_INFO`	Key to identify which DEM has been used. Comes from [Paths].dem_info or basename([Paths].dem_dir).
`DEM_LIST`	List of DEM tiles used to generate the file
`FLYING_UNIT_CODE`	`s1{a\|b\|c}`
`IMAGE_TYPE`	`GRD`
`INPUT_S1_IMAGES`	List of the input Sentinel-1 images used to generate this product
`ORBIT`	`{orbitnumber}`
`ORBIT_DIRECTION`	`{orbitdirection}`
`PRJ.DIRECTIONTOSCANDEMC`	Range direction for DEM scan.
`PRJ.DIRECTIONTOSCANDEML`	Azimuth direction for DEM scan.
`PRJ.GAIN`	Gain value
`TIFFTAG_IMAGEDESCRIPTION`	`SARDEM projection onto DEM list`

Clean-up:

These files are removed automatically

γ area map in Sentinel-1 image geometry 

Content:

Pixels are in the original Sentinel-1 image geometry. Their values contain the γ-area of the pixel. This file is produced with SARGammaAreaImageEstimation application.

Footprint:

Sentinel-1 input image

Directory:

%(tmp)/S1/

File name:

GAMMA_AREA-s1{a|b|c}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.tif

File name format:

fname_fmt.gamma_area = GAMMA_AREA_{polarless_basename}

Product encoding:

Float32 GeoTIFF, 2 bands: γ area and no_data.

Metadata:

The following metadata changed from the SARDEMProjected images

Metadata	Value
`PRJ.DIRECTIONTOSCANDEMC`	Discarded
`PRJ.DIRECTIONTOSCANDEML`	Discarded
`PRJ.GAIN`	Discarded
`TIFFTAG_IMAGEDESCRIPTION`	`GAMMA_AREA value estimation`

Cleanup:

Warning

These files still need to be removed manually. This should change eventually, or it may be conditioned to an option.

Half γ area map files – pre-concatenation 

Content:

Map of γ areas (GAMMA_AREA)

These files directly match the γ area maps computed on S1 images, after orthorectification to the Sentinel-2 tile, and before their concatenation in the final γ area maps in S2 geometry.

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(tmp)/S2/

File names:

GAMMA_AREA_s1{a|b|c}_{tilename}_{orbitdirection}_{orbitnumber}_{start_stamp}.tif

File name format:

fname_fmt.gamma_area_orthorectification = GAMMA_AREA_{flying_unit_code}_{tile_name}_{orbit_direction}_{orbit}_{acquisition_time}.tif

Product encoding:

Float32 (and Int16) GeoTIFF, deflate compressed

Metadata:

The following metadata is changed from the un-orthorectified γ area maps

Metadata	Value
`DATA_TYPE`	`GAMMA_AREA`
`ORTHORECTIFIED`	`true`
`S2_TILE_CORRESPONDING_CODE`	`{tilename}`
`SPATIAL_RESOLUTION`	chosen output spatial resolution option
`TIFFTAG_IMAGEDESCRIPTION`	`Orthorectified GAMMA_AREA Sentinel-1A IW GRD`

Clean-up:

These files are removed automatically

Deprecated temporary files 

Files of XYZ Cartesian coordinates in S1 geometry (deprecated)

Content:

Pixels are in the original Sentinel-1 image geometry. Their values contain the XYZ Cartesian coordinates of the pixel. This file is produced with our patched version of DiapOTB SARCartesianMeanEstimation application.

Footprint:

Sentinel-1 input image

Directory:

%(tmp)/S1/

File name:

XYZ-s1{a|b|c}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.tif

File name format:

fname_fmt.xyz = XYZ_{polarless_basename}

Product encoding:

Float32 GeoTIFF, 4 bands: XCartesian, YCartesian, ZCartesian, and ???

Metadata:

The following metadata changed from the SARDEMProjected images

Metadata	Value
`PRJ.DIRECTIONTOSCANDEMC`	Discarded
`PRJ.DIRECTIONTOSCANDEML`	Discarded
`PRJ.GAIN`	Discarded
`TIFFTAG_IMAGEDESCRIPTION`	`Cartesian XYZ coordinates estimation`

Clean-up:

Warning

These files still need to be removed manually. This should change eventually, or it may be conditioned to an option.

Local Incidence Angle map files in S1 geometry (deprecated)

Content:

Map of sines of Local Incidence Angle (LIA),
and optionally of LIA expressed in degrees and scaled by a factor of 100.

Given T, the target point on Earth’s surface, and S the SAR sensor position, the LIA is the angle Θ_LIM between the ground normal projected in range plane \(\overrightarrow{n}\) (plane defined by S, T, and Earth’s centre) and \(\overrightarrow{TS}\).

Unlike the final LIA maps in S2 geometry, the LIA map is in the geometry of the original Sentinel-1 image used to produce it.

Footprint:

Sentinel-1 input image

Directory:

%(tmp)/S1/

File name:

LIA-s1{a|b|c}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.tif
sin-LIA-s1{a|b|c}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.tif

File name format:

fname_fmt.s1_lia = LIA_{polarless_basename}
fname_fmt.s1_sin_lia = sin_LIA_{polarless_basename}

Product encoding:

Float32 GeoTIFF

Metadata:

The following metadata is changed the XYZ estimated coordinates

Metadata	Value
`TIFFTAG_IMAGEDESCRIPTION`	`LIA on Sentinel-1{A\|B\|C} IW GRD`

Clean-up:

Warning

These files still need to be removed manually. This should change eventually, or it may be conditioned to an option.

Half Local Incidence Angle map files – pre-concatenation. (deprecated)

Content:

Map of sines of Local Incidence Angle (LIA),
and optionally of LIA expressed in degrees and scaled by a factor of 100.

These files directly match the LIA maps computed on S1 images, after orthorectification to the Sentinel-2 tile, and before their concatenation in the final LIA maps in S2 geometry.

Footprint:

Sentinel-1 input image

Directory:

%(tmp)/S2/

File names:

sin_LIA_s1{a|b|c}_{tilename}_{orbitdirection}_{orbitnumber}_{start_stamp}.tif – \(sin(Θ_{LIM})\)
LIA_s1{a|b|c}_{tilename}_{orbitdirection}_{orbitnumber}_{start_stamp}.tif – \(100 * Θ°_{LIM}\)

File name format:

fname_fmt.lia_orthorectification = {LIA_kind}_{flying_unit_code}_{tile_name}_{orbit_direction}_{orbit}_{acquisition_time}.tif

Product encoding:

Float32 (and Int16) GeoTIFF, deflate compressed

Metadata:

The following metadata is changed from the un-orthorectified LIA maps

Metadata	Value
`DATA_TYPE`	`100 * degrees(LIA)` / `SIN(LIA)`
`ORTHORECTIFIED`	`true`
`S2_TILE_CORRESPONDING_CODE`	`{tilename}`
`SPATIAL_RESOLUTION`	chosen output spatial resolution option
`TIFFTAG_IMAGEDESCRIPTION`	`Orthorectified LIA Sentinel-1{A\|B\|C} IW GRD`

Clean-up:

Warning

These files still need to be removed manually. This should change eventually, or it may be conditioned to an option.

Ground and sensor position in XYZ ECEF coordinates (deprecated)

These XYZ ECEF files were produced by S1Tiling v1.1 from orbit information present in Sentinel-1 SAR input products.

Content:

Six bands 64 bits float image that contains ground pixel coordinates and associated sensor position coordinates expressed as XYZ Cartesian pixels in ECEF spatial reference.

Footprint:

Sentinel-2 MGRS tile.

Directory:

%(tmp)/S2/

File name:

XYZ_projected_on_{tile_name}_{orbitdirection}_{orbitnumber}.tif

File name format:

fname_fmt.ground_and_sat_s2 = XYZ_projected_on_{tile_name}_{orbit_direction}_{orbit}.tif

Product encoding:

Float64 GeoTIFF, 6 bands: XCartesian, YCartesian, ZCartesian. SensorXCartesian, SensorXCartesian, SensorZCartesian

Metadata:

The following metadata change from the DEM+GEOID projected on S2 tile

Metadata	Value
`ACQUISITION_DATETIME`	time of the first S1 image (in UTC format since v1.1)
`DEM_INFO`	Key to identify which DEM has been used. Comes from [Paths].dem_info or basename([Paths].dem_dir).
`DEM_LIST`	List of DEM tiles used to generate the file
`FLYING_UNIT_CODE`	`s1{a\|b\|c}`
`IMAGE_TYPE`	`GRD`
`INPUT_S1_IMAGES`	List of the input Sentinel-1 images used to generate this product
`ORBIT`	`{orbitnumber}`
`ORBIT_DIRECTION`	`{orbitdirection}`
`PRJ.DIRECTIONTOSCANDEMC`	Range direction for DEM scan.
`PRJ.DIRECTIONTOSCANDEML`	Azimuth direction for DEM scan.
`PRJ.GAIN`	Gain value
`TIFFTAG_IMAGEDESCRIPTION`	`XYZ ground and satellite positions on S2 tile`

Clean-up:

These files are removed automatically.