Files produced¶

Contents:

Final products
Temporary files

Final products ¶

Orthorectified S2 tiles ¶

Content:

Complete final product: concatenated orthorectified S1 images on S2 grid

Directory:

%(output)/{tilename}/

File name:

s1{a|b}_{tilename}_{polarity}_{orbitdirection}_{orbitnumber}_{YYYYMMDD}txxxxxx.tif when the tile has been assembled from the concatenation of several 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

Format:

Float32 GeoTIFF, deflate compressed

Metadata:

The following metadata is added to the origin S1 images

Metadata	Value
`ACQUISITION_DATETIME`	time of the first S1 image
`ACQUISITION_DATETIME_1`	time of the first S1 image
`ACQUISITION_DATETIME_2`	time of the second S1 image
`CALIBRATION`	chosen calibration option
`FLYING_UNIT_CODE`	`s1{a\|b}`
`IMAGE_TYPE`	`GRD`
`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`	`{orbitnumber}`
`ORBIT_DIRECTION`	`{orbitdirection}`
`ORTHORECTIFIED`	`true`
`POLARIZATION`	`{polarisation}`
`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.0.0 currently

Mask files ¶

Content:

Todo

Thierry?

Directory:

%(output)/{tilename}/

File name:

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

Format:

Byte GeoTIFF, deflate compressed

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

Filtered files ¶

Content:

Todo

Thierry?

Directory:

%(output)/filtered/{tilename}/

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

Format:

Float32 GeoTIFF, deflate compressed

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)/

File names:

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

File name format:

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

Format:

Float32 (and Int16) GeoTIFF, deflate compressed

Metadata:

The following metadata is added to the origin S1 images

Metadata	Value
`ACQUISITION_DATETIME`	time of the first S1 image
`ACQUISITION_DATETIME_1`	time of the first S1 image
`ACQUISITION_DATETIME_2`	time of the second S1 image
`DATA_TYPE`	`100 * degree(LIA)` / `SIN(LIA)`
`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}`
`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 LIA/sin_LIA Sentinel-1A IW GRD`
`TIFFTAG_SOFTWARE`	`S1 Tiling v{version}` – 1.0.0 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 is also generated.

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

Format:

Float32 GeoTIFF, uncompressed.

Metadata:

The following metadata are added at this step:

Metadata	Value
`ACQUISITION_DATETIME`	time of the input S1 image
`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 ¶

File name format:
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`
	`fname_fmt.orthorectification` = `{flying_unit_code}_{tile_name}_{polarisation}_{orbit_direction}_{orbit}_{acquisition_time}_{calibration_type}.tif`
Format:	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 ¶

File name format:
Content:	Virtual aggregate of all the SRTM files that fully cover the associated input S1 images (in both polarities).
Directory:	%(tmp)`/S1/`
File name:	`DEM-s1{a\|b}-iw-grd-{start_stamp}-{end_stamp}-{nr1}-{nr2}.tif`
	`fname_fmt.dem_s1_agglomeration` = `DEM_{polarless_rootname}.vrt`
Format:	VRT
Metadata:	No metadata is added by S1Tiling to these files.
Cleanup:	Warning These files still need to be cleaned manually. This should change eventually, or it may be conditionned to an option.

Files of 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 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}

Format:

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
`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 ¶

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}

Format:

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 ¶

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}

Format:

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.¶

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

Format:

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.