Files produced

Final products 

Orthorectified S2 tiles 

Content:

Complete final product: concatenated orthorectified S1 images on S2 grid

Directory:

%(output)/{tilename}/ by default

Directory format:

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

File name:

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

Note

\(σ^0_{RTC}\) calibrated files will have their name end in _NormLim.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

Product encoding:

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

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)
`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
`FLYING_UNIT_CODE`	`s1{a\|b}`
`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 file used for Normlim calibration
`NOISE_REMOVED`	chosen noise removal option
`ORBIT_NUMBER`	`{orbitNumber}`
`ORBIT_DIRECTION`	`{orbitDirection}`
`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} IW GRD on S2 tile`
`TIFFTAG_SOFTWARE`	`S1 Tiling v{version}` – 1.2.0alpha1 currently

Mask files 

Content:

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

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-1A IW GRD smoothed border mask S2 tile`

Filtered files 

Content:

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

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

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 degree 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 center) and \(\overrightarrow{TS}\).

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

Directory:

%(output_lia)/ by default

Directory format:

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

File names:

sin_LIA_s1{a|b}_{tilename}_{orbitnumber}.tif – \(sin(Θ_{LIM})\)
LIA_s1{a|b}_{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:

The following image metadata is set:

Metadata	Value
`DATA_TYPE`	`100 * degrees(LIA)` / `sin(LIA)`
`DEM_LIST`	List of DEM (SRTM currently) tiles used to generate the file
`EOF_FILE`	Precise orbit file used to generate the file
`FLYING_UNIT_CODE`	`s1{a\|b}`
`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}` – 1.2.0alpha1 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.

Note

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.

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}`
`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} IW GRD`

Note

These files can be kept as a same calibrated and cut S1 image can be orthorectified for producing several 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
Directory:: %(tmp)/S2/{tilename}/
File name:: s1{a|b}_{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.

Note

These files are automatically cleaned up.

DEM VRT files 

Content:

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

Directory:

%(tmp)/S1/

File name:

DEM-s1tilename.tif
or deprecated: DEM-s1{a|b}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.tif

File name format:

fname_fmt.dem_s2_agglomeration = DEM_{tile_name}.vrt
or deprecated: fname_fmt.dem_s1_agglomeration = DEM_{polarless_rootname}.vrt

Product encoding:

VRT

Metadata:

No metadata is added by S1Tiling to these files.

Cleanup:

These files are cleaned automatically (since new workflow from v1.1).

DEM data projected on S2 tile 

Content:

DEM information projected on S2 tile according to Project DEM on S2 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
`S2_TILE_CORRESPONDING_CODE`	`{tilename}`
`SPATIAL_RESOLUTION`	chosen output spatial resolution option
`DEM_LIST`	List of DEM (SRTM currently) tiles used to generate the file
`ORTHORECTIFIED`	`true`
`TIFFTAG_IMAGEDESCRIPTION`	`Warped DEM to S2 tile`

Cleanup:

These files are cleaned 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.

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
`TIFFTAG_IMAGEDESCRIPTION`	`DEM + GEOID height info projected on S2 tile`

Cleanup:

Warning

These files still need to be cleaned manually. This should change eventually, or it may be conditionned 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. The image footprint matches the associated S2 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_LIST`	List of DEM (SRTM currently) tiles used to generate the file
`EOF_FILE`	Precise orbit file used to generate the file
`FLYING_UNIT_CODE`	`s1{a\|b}`
`IMAGE_TYPE`	`XYZ`
`ORTHORECTIFIED`	`true`
`RELATIVE_ORBIT_NUMBER`	`{orbitnumber}`
`TIFFTAG_IMAGEDESCRIPTION`	`XYZ ground and satellite positions on S2 tile`

Cleanup:

These files are cleaned automatically.

Deprecated temporary files 

Files of S1 coordinates projected on DEM geometry (deprecated)

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 DiapOTB SARDEMProjection application.

Directory:

%(tmp)/S1/

File name:

S1_on_DEM-s1{a|b}-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, 7 bands: C (colunm into SAR image), L (line into SAR image), Z and Y, XCartesian, YCartesian, ZCartesian.

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_LIST`	List of DEM (SRTM currently) tiles used to generate the file
`FLYING_UNIT_CODE`	`s1{a\|b}`
`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`

Cleanup:

Warning

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

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.

Directory:

%(tmp)/S1/

File name:

XYZ-s1{a|b}-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`	Removed
`PRJ.DIRECTIONTOSCANDEML`	Removed
`PRJ.GAIN`	Removed
`TIFFTAG_IMAGEDESCRIPTION`	`Cartesian XYZ coordinates estimation`

Cleanup:

Warning

These files still need to be cleaned manually. This should change eventually, or it may be conditionned 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 degree 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 center) 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.

Directory:

%(tmp)/S1/

File name:

LIA-s1{a|b}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.tif
sin-LIA-s1{a|b}-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-1A IW GRD`

Cleanup:

Warning

These files still need to be cleaned manually. This should change eventually, or it may be conditionned 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 degree 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.

Directory:

%(tmp)/S2/

File names:

sin_LIA_s1{a|b}_{tilename}_{orbitdirection}_{orbitnumber}_{start_stamp}.tif – \(sin(Θ_{LIM})\)
LIA_s1{a|b}_{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 * degree(LIA)` / `SIN(LIA)`
`ORTHORECTIFIED`	`true`
`S2_TILE_CORRESPONDING_CODE`	`{tilename}`
`SPATIAL_RESOLUTION`	chosen output spatial resolution option
`TIFFTAG_IMAGEDESCRIPTION`	`Orthorectified LIA Sentinel-1A IW GRD`

Cleanup:

Warning

These files still need to be cleaned manually. This should change eventually, or it may be conditionned 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. The image footprint matches the associated S2 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_LIST`	List of DEM (SRTM currently) tiles used to generate the file
`FLYING_UNIT_CODE`	`s1{a\|b}`
`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`

Cleanup:

These files are cleaned automatically.