.. # define a hard line break for HTML .. |br| raw:: html
.. _files: .. index:: files ====================================================================== Files produced ====================================================================== .. contents:: Contents: :local: :depth: 3 .. _final-products: Final products -------------- .. _full-S2-tiles: .. index:: S2 tiles Orthorectified S2 tiles +++++++++++++++++++++++ :Content: Complete final product: concatenated orthorectified S1 images on S2 grid :Footprint: Sentinel-2 MGRS tile. :Directory: :ref:`%(output) `:samp:`/{{tilename}}/` by default :Directory format: :samp:`{{out_dir}}/{{tile_name}}`, see :ref:`[Processing].dname_fmt.tiled ` :File name: - :samp:`s1{{a|b|c}}_{{tilename}}_{{polarity}}_{{orbitdirection}}_{{orbitnumber}}_{{YYYYMMDD}}txxxxxx.tif` when the tile has been assembled from the concatenation of two S1 images - :samp:`s1{{a|b|c}}_{{tilename}}_{{polarity}}_{{orbitdirection}}_{{orbitnumber}}_{{YYYYMMDD}}t{{hhmmss}}.tif` when the tile has been produced from a single S1 image .. note:: :math:`σ^0_{T}` calibrated files will have their name end in :file:`_NormLim.tif` :math:`γ^0_{T}` RTC files will have their name end in :file:`_GammaNaughtRTC.tif` :File name format: - :samp:`{{flying_unit_code}}_{{tile_name}}_{{polarisation}}_{{orbit_direction}}_{{orbit}}_{{acquisition_stamp}}.tif`, see :ref:`[Processing].fname_fmt.concatenation ` - or, :samp:`{{flying_unit_code}}_{{tile_name}}_{{polarisation}}_{{orbit_direction}}_{{orbit}}_{{acquisition_stamp}}_NormLim.tif`, see :ref:`[Processing].fname_fmt.lia_corrected ` - or, :samp:`{{flying_unit_code}}_{{tile_name}}_{{polarisation}}_{{orbit_direction}}_{{orbit}}_{{acquisition_stamp}}_GammaNaughtRTC.tif`, see :ref:`[Processing].fname_fmt.gamma_area_corrected ` :Product encoding: - defaults to Float32 GeoTIFF, deflate compressed - defined in :ref:`[Processing].creation_options.tiled ` :Metadata: GeoTIFF metadata will contain: the metadata coming from the input S1 GRD products, the extra ones specified in :ref:`[Metadata] ` configuration section, plus the following ones: .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - 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`` - :ref:`chosen calibration option ` * - ``DEM_INFO`` - Key to identify which DEM has been used. |br| Comes from :ref:`[Paths].dem_info ` or :ref:`basename([Paths].dem_dir) `. * - ``DEM_INFO`` - Key to identify which DEM has been used. |br| Comes from :ref:`[Paths].dem_info ` or :ref:`basename([Paths].dem_dir) `. * - ``FLYING_UNIT_CODE`` - :samp:`s1{{a|b|c}}` * - ``IMAGE_TYPE`` - :samp:`BACKSCATTERING` * - ``INPUT_S1_IMAGES`` - List of the input Sentinel-1 images used to generate this product * - ``LIA_FILE`` - (when applies) name of the :ref:`LIA map file ` used for Normlim calibration * - ``GAMMA_AREA_FILE`` - (when applies) name of the :ref:`γ area map file ` used for :math:`γ^0_{T}` RTC calibration * - ``NOISE_REMOVED`` - :ref:`chosen noise removal option ` * - ``ORBIT_NUMBER`` - :samp:`{{orbitNumber}}` * - ``ORBIT_DIRECTION`` - :samp:`{{orbitDirection}}` * - ``ORTHORECTIFICATION_INTERPOLATOR`` - :ref:`chosen orthorectification interpolation method option ` * - ``ORTHORECTIFIED`` - :samp:`true` * - ``POLARIZATION`` - :samp:`{{polarisation}}` * - ``RELATIVE_ORBIT_NUMBER`` - :samp:`{{relativeOrbitNumber}}` * - ``S2_TILE_CORRESPONDING_CODE`` - :samp:`{{tilename}}` * - ``SPATIAL_RESOLUTION`` - :ref:`chosen output spatial resolution option ` * - ``TIFFTAG_DATETIME`` - is updated with the time when the tile has been generated by S1 Tiling. * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`{{calibration}} calibrated orthorectified Sentinel-1{{A|B|C}} IW GRD on S2 tile` * - ``TIFFTAG_SOFTWARE`` - :samp:`S1 Tiling v{{version}}` -- |version| currently .. _mask-files: .. index:: Mask files Mask files ++++++++++ :Content: Binary image containing mask on valid data. It is a mask on no-data pixels. :Footprint: Sentinel-2 MGRS tile. :Directory: :ref:`%(output) `:samp:`/{{tilename}}/` by default :Directory format: :samp:`{{out_dir}}/{{tile_name}}`, see :ref:`[Processing].dname_fmt.mask ` :File name: the same as the one from :ref:`the S2 tiles `, with `_BorderMask` appended :Product encoding: - defaults to Byte GeoTIFF, deflate compressed - defined in :ref:`[Processing].creation_options.mask ` :Metadata: This file contains the same metadata as the one from :ref:`the S2 tile product ` it has been generated from, with the following as the only difference: .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``IMAGE_TYPE`` - :samp:`MASK` * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`Orthorectified Sentinel-1{{A|B|C}} IW GRD smoothed border mask S2 tile` .. _filtered-files: .. index:: Filtered files Filtered files ++++++++++++++ :Content: Complete final product, after applying the speckle filtering if option is activated :Footprint: Sentinel-2 MGRS tile. :Directory: :ref:`%(output) `:samp:`/filtered/{{tilename}}/` by default :Directory format: :samp:`{{out_dir}}/filtered/{{tile_name}}`, see :ref:`[Processing].dname_fmt.filtered ` :File name: the same as the one from :ref:`the S2 tiles `, with `_filtered` appended :File name format: - :samp:`{{flying_unit_code}}_{{tile_name}}_{{polarisation}}_{{orbit_direction}}_{{orbit}}_{{acquisition_stamp}}_filtered.tif`, see :ref:`[Processing].fname_fmt.filtered ` - or, :samp:`{{flying_unit_code}}_{{tile_name}}_{{polarisation}}_{{orbit_direction}}_{{orbit}}_{{acquisition_stamp}}_NormLim_filtered.tif` - or, :samp:`{{flying_unit_code}}_{{tile_name}}_{{polarisation}}_{{orbit_direction}}_{{orbit}}_{{acquisition_stamp}}_GammaNaughtRTC_filtered.tif` :Product encoding: - defaults to Float32 GeoTIFF, deflate compressed - defined in :ref:`[Processing].creation_options.filtered ` :Metadata: This file contains the same metadata as the one from :ref:`the S2 tile product ` it has been generated from, with the following as the only difference: .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``FILTERED`` - :samp:`true` * - ``FILTERING_METHOD`` - The method used: :samp:`Lee`/:samp:`Frost`/:samp:`gammamap`/:samp:`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) .. _lia-files: .. index:: Local Incidence Angle map files 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 Θ\ :sub:`LIM` between the ground normal projected in range plane :math:`\overrightarrow{n}` (plane defined by S, T, and Earth's centre) and :math:`\overrightarrow{TS}`. The values have been computed directly on the Sentinel-2 tile from the S2 tile footprint, and a matching :ref:`precise orbit file (EOF) ` of the chosen relative orbit. :Footprint: Sentinel-2 MGRS tile. :Directory: :ref:`%(output_lia)/ ` by default :Directory format: :samp:`{{lia_dir}}`, see :ref:`[Processing].dname_fmt.lia_product ` :File names: - :samp:`sin_LIA_s1{{a|b|c}}_{{tilename}}_{{orbitnumber}}.tif` -- :math:`sin(Θ_{LIM})` - :samp:`LIA_s1{{a|b|c}}_{{tilename}}_{{orbitnumber}}.tif` -- :math:`100 * Θ°_{LIM}` :File name format: :samp:`{{LIA_kind}}_{{flying_unit_code}}_{{tile_name}}_{{orbit}}.tif`, see :ref:`[Processing].fname_fmt.lia_product ` :Product encoding: - defaults to Float32 (/Uint16) GeoTIFF, deflate compressed - defined in :ref:`[Processing].creation_options.lia_sin ` (/:ref:`[Processing].creation_options.lia_deg `) :Metadata: GeoTIFF metadata will contain the extra metadata specified in :ref:`[Metadata] ` configuration section, plus the following ones: .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``DATA_TYPE`` - :samp:`100 * degrees(LIA)` / :samp:`sin(LIA)` * - ``DEM_INFO`` - Key to identify which DEM has been used. |br| Comes from :ref:`[Paths].dem_info ` or :ref:`basename([Paths].dem_dir) `. * - ``DEM_LIST`` - List of DEM tiles used to generate the file * - ``DEM_RESAMPLING_METHOD`` - :ref:`chosen DEM resampling method option ` * - ``EOF_FILE`` - Precise orbit file used to generate the file * - ``FLYING_UNIT_CODE`` - :samp:`s1{{a|b|c}}` * - ``GEOID_ORTHORECTIFICATION_INTERPOLATOR`` - :ref:`chosen orthorectification interpolation_method option ` * - ``IMAGE_TYPE`` - :samp:`LIA` * - ``RELATIVE_ORBIT_NUMBER`` - :samp:`{{orbitnumber}}` * - ``ORTHORECTIFIED`` - :samp:`true` * - ``S2_TILE_CORRESPONDING_CODE`` - :samp:`{{tilename}}` * - ``SPATIAL_RESOLUTION`` - :ref:`chosen output spatial resolution option ` * - ``TIFFTAG_DATETIME`` - is updated with the time when the tile has been generated by S1 Tiling. * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`sin(LIA)/100 * degress(LIA) on S2 grid` * - ``TIFFTAG_SOFTWARE`` - :samp:`S1 Tiling v{{version}}` -- |version| currently .. _ia-files: .. index:: Incidence Angle map files Incidence Angle map files +++++++++++++++++++++++++ Different Incidence Angle maps may be produced depending on :ref:`[Processing.ia_maps_to_produce] `. These files can be used to convert :ref:`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 Θ\ :sub:`E` between the ellipsoid surface normal projected in range plane :math:`\overrightarrow{n}` (plane defined by S, E, and Earth's centre) and :math:`\overrightarrow{ES}`. :Footprint: Sentinel-2 MGRS tile. :Directory: :ref:`%(output_ia)/ ` by default :Directory format: :samp:`{{ia_dir}}`, see :ref:`[Processing].dname_fmt.ia_product ` :File names: - :samp:`IA_s1{{a|b|c}}_{{tilename}}_{{orbitnumber}}.tif` -- :math:`100 * Θ_{E}` - :samp:`cos_IA_s1{{a|b|c}}_{{tilename}}_{{orbitnumber}}.tif` -- :math:`cos(Θ_{E})` - :samp:`sin_IA_s1{{a|b|c}}_{{tilename}}_{{orbitnumber}}.tif` -- :math:`sin(Θ_{E})` - :samp:`tan_IA_s1{{a|b|c}}_{{tilename}}_{{orbitnumber}}.tif` -- :math:`tan(Θ_{E})` :File name format: :samp:`{{IA_kind}}_{{flying_unit_code}}_{{tile_name}}_{{orbit}}.tif`, see :ref:`[Processing].fname_fmt.ia_product ` :Product encoding: - defaults to Float32 (/Uint16) GeoTIFF, deflate compressed - defined in :ref:`[Processing].creation_options.ia_sin ` (/:ref:`[Processing].creation_options.ia_deg `) :Metadata: GeoTIFF metadata will contain the extra metadata specified in :ref:`[Metadata] ` configuration section, plus the following ones: .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``DATA_TYPE`` - :samp:`100 * degrees(IA)` / :samp:`cos(IA)` / :samp:`sin(IA)` / :samp:`tan(IA)` * - ``EOF_FILE`` - Precise orbit file used to generate the file * - ``FLYING_UNIT_CODE`` - :samp:`s1{{a|b|c}}` * - ``IMAGE_TYPE`` - :samp:`IA` * - ``ORTHORECTIFIED`` - :samp:`true` * - ``RELATIVE_ORBIT_NUMBER`` - :samp:`{{orbitnumber}}` * - ``S2_TILE_CORRESPONDING_CODE`` - :samp:`{{tilename}}` * - ``SPATIAL_RESOLUTION`` - :ref:`chosen output spatial resolution option ` * - ``TIFFTAG_DATETIME`` - is updated with the time when the tile has been generated by S1 Tiling. * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`100 * degrees(IA)/cos(IA)/sin(IA)/tan(IA) on S2 grid` * - ``TIFFTAG_SOFTWARE`` - :samp:`S1 Tiling v{{version}}` -- |version| currently .. _gamma_area_s2-files: .. index:: Gamma Area map file 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 :ref:`GAMMA_AREA maps computed on S1 images `. :Footprint: Sentinel-2 MGRS tile. :Directory: :ref:`%(output_gamma_area)/ ` by default :Directory format: :samp:`{{gamma_area_dir}}`, see :ref:`[Processing].dname_fmt.gamma_area_product ` :File names: - :samp:`GAMMA_AREA_s1{{a|b|c}}_{{tilename}}_{{orbitdirection}}_{{orbitnumber}}.tif` :File name format: :samp:`GAMMA_AREA_{{flying_unit_code}}_{{tile_name}}_{{orbit_direction}}_{{orbit}}.tif`, see :ref:`[Processing].fname_fmt.gamma_area_product ` :Product encoding: - defaults to Float32 (/Uint16) GeoTIFF, deflate compressed - defined in :ref:`[Processing].creation_options.gamma_area ` :Metadata: The following metadata is added to the origin S1 images .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - 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`` - :samp:`GAMMA_AREA` * - ``FLYING_UNIT_CODE`` - :samp:`s1{{a|b|c}}` * - ``IMAGE_TYPE`` - :samp:`GRD` * - ``INPUT_S1_IMAGES`` - List of the input Sentinel-1 images used to generate this product * - ``ORBIT`` - :samp:`{{orbitnumber}}` * - ``ORBIT_DIRECTION`` - :samp:`{{orbitdirection}}` * - ``ORTHORECTIFIED`` - :samp:`true` * - ``S2_TILE_CORRESPONDING_CODE`` - :samp:`{{tilename}}` * - ``SPATIAL_RESOLUTION`` - :ref:`chosen output spatial resolution option ` * - ``TIFFTAG_DATETIME`` - is updated with the time when the tile has been generated by S1 Tiling. * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`Orthorectified GAMMA_AREA Sentinel-1A IW GRD` * - ``TIFFTAG_SOFTWARE`` - :samp:`S1 Tiling v{{version}}` -- |version| currently .. _temporary-files: .. index:: Temporary files Temporary files --------------- Before generating the final products, S1 Tiling produces temporary files. Some are removed automatically, others are :ref:`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. .. _orthoready-files: Cut and calibrated S1 images ready for orthorectification +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ :Content: S1 images :ref:`calibrated ` and :ref:`cut `. :Footprint: Sentinel-1 input image :Directory: :ref:`%(tmp) `:samp:`/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: .. code-block:: none 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`` = :samp:`{{rootname}}_{{calibration_type}}_OrthoReady.tiff` :Product encoding: Float32 GeoTIFF, uncompressed. :Metadata: The following metadata are added at this step: .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``ACQUISITION_DATETIME`` - time of the input S1 image (in UTC format since v1.1) * - ``CALIBRATION`` - :ref:`chosen calibration option ` * - ``FLYING_UNIT_CODE`` - :samp:`s1{{a|b|c}}` * - ``IMAGE_TYPE`` - :samp:`GRD` * - ``INPUT_S1_IMAGES`` - Name of the input Sentinel-1 image used to generate this product * - ``NOISE_REMOVED`` - :ref:`chosen noise removal option ` * - ``ORBIT`` - :samp:`{{orbitnumber}}` * - ``ORBIT_DIRECTION`` - :samp:`{{orbitdirection}}` * - ``POLARIZATION`` - :samp:`{{polarisation}}` * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`{{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 :ref:`S1Processor` is executed with :option:`--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-files: Orthorectified S1 images ++++++++++++++++++++++++ :Content: Single concatenated orthorectified S1 image on S2 grid :Footprint: Sentinel-2 MGRS tile. :Directory: :ref:`%(tmp) `:samp:`/S2/{{tilename}}/` :File name: :samp:`s1{{a|b|c}}_{{tilename}}_{{polarity}}_{{orbitdirection}}_{{orbitnumber}}_{{YYYYMMDD}}t{{hhmmss}}_{{calibration}}.tif` :File name format: ``fname_fmt.orthorectification`` = :samp:`{{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 :ref:`the S2 tile product ` are actually produced at this step. :Clean-up: These files are removed automatically .. _dem_vrt_on_s2-files: 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: :ref:`%(tmp) `:samp:`/{{random}}/` :File name: :samp:`DEM_{tilename}.vrt` :File name format: ``fname_fmt.dem_s2_agglomeration`` = :samp:`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_on_S2-files: DEM data projected on S2 tile +++++++++++++++++++++++++++++ :Content: DEM information projected on S2 tile according to :ref:`project_dem_to_s2-proc` :Footprint: Sentinel-2 MGRS tile. :Directory: :ref:`%(tmp) `:samp:`/S2/` :File name: :samp:`DEM_projected_on_{{tilename}}.tiff` :File name format: ``fname_fmt.dem_on_s2`` = :samp:`DEM_projected_on_{{tile_name}}.tiff` :Product encoding: Float32 GeoTIFF, uncompressed. :Metadata: The following metadata are added at this step: .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``DEM_INFO`` - Key to identify which DEM has been used. |br| Comes from :ref:`[Paths].dem_info ` or :ref:`basename([Paths].dem_dir) `. * - ``DEM_LIST`` - List of DEM tiles used to generate the file * - ``DEM_RESAMPLING_METHOD`` - :ref:`chosen DEM resampling method option ` * - ``ORTHORECTIFIED`` - :samp:`true` * - ``S2_TILE_CORRESPONDING_CODE`` - :samp:`{{tilename}}` * - ``SPATIAL_RESOLUTION`` - :ref:`chosen output spatial resolution option ` * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`Warped DEM to S2 tile` :Clean-up: These files are removed automatically. .. _height_on_S2-files: Height (DEM+Geoid) projected on S2 tile +++++++++++++++++++++++++++++++++++++++ :Content: Height information (DEM + Geoid combined) projected on S2 tile according to :ref:`project_geoid_to_s2-proc` and :ref:`Sum DEM + Geoid `. :Footprint: Sentinel-2 MGRS tile. :Directory: :ref:`%(tmp) `:samp:`/S2/` :File name: :samp:`DEM+GEOID_projected_on_{{tilename}}.tiff` :File name format: ``fname_fmt.height_on_s2`` = :samp:`DEM+GEOID_projected_on_{{tile_name}}.tiff` :Product encoding: Float32 GeoTIFF, uncompressed. :Metadata: The following metadata change from the :ref:`DEM projected on S2 tile ` .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``GEOID_ORTHORECTIFICATION_INTERPOLATOR`` - :ref:`chosen orthorectification interpolation_method option ` * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`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_sat_S2-files: Ground and sensor position in XYZ ECEF coordinates ++++++++++++++++++++++++++++++++++++++++++++++++++ These XYZ ECEF are produced starting from S1Tiling 1.2 from :ref:`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: :ref:`%(tmp) `:samp:`/S2/` :File name: :samp:`XYZ_projected_on_{{tile_name}}_{{orbitnumber}}.tif` :File name format: ``fname_fmt.ground_and_sat_s2`` = :samp:`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 :ref:`DEM+GEOID projected on S2 tile ` .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``DEM_INFO`` - Key to identify which DEM has been used. |br| Comes from :ref:`[Paths].dem_info ` or :ref:`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`` - :samp:`s1{{a|b|c}}` * - ``IMAGE_TYPE`` - :samp:`XYZ` * - ``ORTHORECTIFIED`` - :samp:`true` * - ``RELATIVE_ORBIT_NUMBER`` - :samp:`{{orbitnumber}}` * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`XYZ ground and satellite positions on S2 tile` :Clean-up: These files are removed automatically. .. _wgs84_surface_and_sat_S2-files: 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: :ref:`%(tmp) `:samp:`/S2/` :File name: :samp:`XYZ_projected_on_ellipsoid_{{tile_name}}_{{orbitnumber}}.tif` :File name format: ``fname_fmt.ground_and_sat_s2_ellipsoid`` = :samp:`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 .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - 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`` - :samp:`s1{{a|b|c}}` * - ``IMAGE_TYPE`` - :samp:`XYZ` * - ``ORTHORECTIFIED`` - :samp:`true` * - ``RELATIVE_ORBIT_NUMBER`` - :samp:`{{orbitnumber}}` * - ``S2_TILE_CORRESPONDING_CODE`` - :samp:`{{tilename}}` * - ``SPATIAL_RESOLUTION`` - :ref:`chosen output spatial resolution option ` * - ``TIFFTAG_DATETIME`` - is updated with the time when the tile has been generated by S1 Tiling. * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`XYZ ground and satellite positions on S2 tile on ellipsoid` * - ``TIFFTAG_SOFTWARE`` - :samp:`S1 Tiling v{{version}}` -- |version| currently :Clean-up: These files are removed automatically. .. _dem_vrt_on_s1-files: 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: :ref:`%(tmp) `:samp:`/S1/` :File name: :samp:`DEM_s1{{a|b|c}}-iw-grd-{{start_stamp}}-{{end_stamp}}-{{nr1}}-{{nr2}}.vrt` :File name format: ``fname_fmt.dem_s1_agglomeration`` = :samp:`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-files: 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: :ref:`%(tmp) `:samp:`/S1/` :File name: :samp:`RESAMPLED_DEM_s1{{a|b|c}}-iw-grd-{{start_stamp}}-{{end_stamp}}-{{nr1}}-{{nr2}}.tiff` :File name format: ``fname_fmt.resampled_dem`` = :samp:`RESAMPLED_DEM_{{polarless_basename}}` :Product encoding: Float32 GeoTIFF, uncompressed. :Metadata: The following metadata change from the :ref:`DEM vrt intersecting S1 image ` .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - No-data value - `NaN` * - ``DEM_RESAMPLING_METHOD`` - :samp:`X*{{factor_x}}, Y*{{factor_y}}` :Clean-up: These files are removed automatically .. _height_on_DEM-files: 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 :ref:`project_geoid_4rtc-proc` and :ref:`Sum DEM + Geoid `. :Footprint: Outer bounding box of all the DEM that intersect the Sentinel-1 reference image. :Directory: :ref:`%(tmp) `:samp:`/S1/` :File name: :samp:`DEM+GEOID_s1{{a|b|c}}-iw-grd-{{start_stamp}}-{{end_stamp}}-{{nr1}}-{{nr2}}.tiff` :File name format: ``fname_fmt.height_4rtc`` = :samp:`DEM+GEOID_{{polarless_basename}}` :Product encoding: Float32 GeoTIFF, uncompressed. :Metadata: The following metadata change from the :ref:`DEM vrt intersecting S1 image `, or the :ref:`Resampled DEM image `. .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``GEOID_ORTHORECTIFICATION_INTERPOLATOR`` - :ref:`chosen orthorectification interpolation_method option ` * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`DEM + GEOID height info projected on S2 tile` :Clean-up: These files are removed automatically .. _S1_on_dem-files: S1 coordinates projected on DEM geometry ++++++++++++++++++++++++++++++++++++++++ :Content: Pixels are in the :ref:`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: :ref:`%(tmp) `:samp:`/S1/` :File name: :samp:`S1_on_DEM-s1{{a|b|c}}-iw-grd-{{start_stamp}}-{{end_stamp}}-{{nr1}}-{{nr2}}.tif` :File name format: ``fname_fmt.s1_on_dem`` = :samp:`S1_on_DEM_{{polarless_basename}}` :Product encoding: Float32 GeoTIFF, deflate compressed, and tiled by default. But float64 precision is recommended when possible. |br| 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 .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - 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. |br| Comes from :ref:`[Paths].dem_info ` or :ref:`basename([Paths].dem_dir) `. * - ``DEM_LIST`` - List of DEM tiles used to generate the file * - ``FLYING_UNIT_CODE`` - :samp:`s1{{a|b|c}}` * - ``IMAGE_TYPE`` - :samp:`GRD` * - ``INPUT_S1_IMAGES`` - List of the input Sentinel-1 images used to generate this product * - ``ORBIT`` - :samp:`{{orbitnumber}}` * - ``ORBIT_DIRECTION`` - :samp:`{{orbitdirection}}` * - ``PRJ.DIRECTIONTOSCANDEMC`` - Range direction for DEM scan. * - ``PRJ.DIRECTIONTOSCANDEML`` - Azimuth direction for DEM scan. * - ``PRJ.GAIN`` - Gain value * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`SARDEM projection onto DEM list` :Clean-up: These files are removed automatically .. _gamma_area_s1-files: γ 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: :ref:`%(tmp) `:samp:`/S1/` :File name: :samp:`GAMMA_AREA-s1{{a|b|c}}-iw-grd-{{start_stamp}}-{{end_stamp}}-{{nr1}}-{{nr2}}.tif` :File name format: ``fname_fmt.gamma_area`` = :samp:`GAMMA_AREA_{{polarless_basename}}` :Product encoding: Float32 GeoTIFF, 2 bands: γ area and no_data. :Metadata: The following metadata changed from the :ref:`SARDEMProjected images ` .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``PRJ.DIRECTIONTOSCANDEMC`` - **Discarded** * - ``PRJ.DIRECTIONTOSCANDEML`` - **Discarded** * - ``PRJ.GAIN`` - **Discarded** * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`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. .. _gamma_area-s2-half-files: Half γ area map files -- pre-concatenation ++++++++++++++++++++++++++++++++++++++++++ :Content: Map of γ areas (GAMMA_AREA) These files directly match the :ref:`γ area maps computed on S1 images `, after orthorectification to the Sentinel-2 tile, and before their concatenation in the :ref:`final γ area maps in S2 geometry `. :Footprint: Sentinel-2 MGRS tile. :Directory: :ref:`%(tmp) `:samp:`/S2/` :File names: :samp:`GAMMA_AREA_s1{{a|b|c}}_{{tilename}}_{{orbitdirection}}_{{orbitnumber}}_{{start_stamp}}.tif` :File name format: ``fname_fmt.gamma_area_orthorectification`` = :samp:`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 :ref:`un-orthorectified γ area maps ` .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``DATA_TYPE`` - :samp:`GAMMA_AREA` * - ``ORTHORECTIFIED`` - :samp:`true` * - ``S2_TILE_CORRESPONDING_CODE`` - :samp:`{{tilename}}` * - ``SPATIAL_RESOLUTION`` - :ref:`chosen output spatial resolution option ` * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`Orthorectified GAMMA_AREA Sentinel-1A IW GRD` :Clean-up: These files are removed automatically Deprecated temporary files -------------------------- .. _xyz-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: :ref:`%(tmp) `:samp:`/S1/` :File name: :samp:`XYZ-s1{{a|b|c}}-iw-grd-{{start_stamp}}-{{end_stamp}}-{{nr1}}-{{nr2}}.tif` :File name format: ``fname_fmt.xyz`` = :samp:`XYZ_{{polarless_basename}}` :Product encoding: Float32 GeoTIFF, 4 bands: XCartesian, YCartesian, ZCartesian, and ??? :Metadata: The following metadata changed from the :ref:`SARDEMProjected images ` .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``PRJ.DIRECTIONTOSCANDEMC`` - **Discarded** * - ``PRJ.DIRECTIONTOSCANDEML`` - **Discarded** * - ``PRJ.GAIN`` - **Discarded** * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`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. .. _lia-s1-files: 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 Θ\ :sub:`LIM` between the ground normal projected in range plane :math:`\overrightarrow{n}` (plane defined by S, T, and Earth's centre) and :math:`\overrightarrow{TS}`. Unlike the :ref:`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: :ref:`%(tmp) `:samp:`/S1/` :File name: - :samp:`LIA-s1{{a|b|c}}-iw-grd-{{start_stamp}}-{{end_stamp}}-{{nr1}}-{{nr2}}.tif` - :samp:`sin-LIA-s1{{a|b|c}}-iw-grd-{{start_stamp}}-{{end_stamp}}-{{nr1}}-{{nr2}}.tif` :File name format: - ``fname_fmt.s1_lia`` = :samp:`LIA_{{polarless_basename}}` - ``fname_fmt.s1_sin_lia`` = :samp:`sin_LIA_{{polarless_basename}}` :Product encoding: Float32 GeoTIFF :Metadata: The following metadata is changed the :ref:`XYZ estimated coordinates ` .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`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. .. _lia-s2-half-files: 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 :ref:`LIA maps computed on S1 images `, after orthorectification to the Sentinel-2 tile, and before their concatenation in the :ref:`final LIA maps in S2 geometry `. :Footprint: Sentinel-1 input image :Directory: :ref:`%(tmp) `:samp:`/S2/` :File names: - :samp:`sin_LIA_s1{{a|b|c}}_{{tilename}}_{{orbitdirection}}_{{orbitnumber}}_{{start_stamp}}.tif` -- :math:`sin(Θ_{LIM})` - :samp:`LIA_s1{{a|b|c}}_{{tilename}}_{{orbitdirection}}_{{orbitnumber}}_{{start_stamp}}.tif` -- :math:`100 * Θ°_{LIM}` :File name format: ``fname_fmt.lia_orthorectification`` = :samp:`{{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 :ref:`un-orthorectified LIA maps ` .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - Metadata - Value * - ``DATA_TYPE`` - :samp:`100 * degrees(LIA)` / :samp:`SIN(LIA)` * - ``ORTHORECTIFIED`` - :samp:`true` * - ``S2_TILE_CORRESPONDING_CODE`` - :samp:`{{tilename}}` * - ``SPATIAL_RESOLUTION`` - :ref:`chosen output spatial resolution option ` * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`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_sat_S2-files_v1_1: 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: :ref:`%(tmp) `:samp:`/S2/` :File name: :samp:`XYZ_projected_on_{{tile_name}}_{{orbitdirection}}_{{orbitnumber}}.tif` :File name format: ``fname_fmt.ground_and_sat_s2`` = :samp:`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 :ref:`DEM+GEOID projected on S2 tile ` .. list-table:: :widths: auto :header-rows: 1 :stub-columns: 1 * - 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. |br| Comes from :ref:`[Paths].dem_info ` or :ref:`basename([Paths].dem_dir) `. * - ``DEM_LIST`` - List of DEM tiles used to generate the file * - ``FLYING_UNIT_CODE`` - :samp:`s1{{a|b|c}}` * - ``IMAGE_TYPE`` - :samp:`GRD` * - ``INPUT_S1_IMAGES`` - List of the input Sentinel-1 images used to generate this product * - ``ORBIT`` - :samp:`{{orbitnumber}}` * - ``ORBIT_DIRECTION`` - :samp:`{{orbitdirection}}` * - ``PRJ.DIRECTIONTOSCANDEMC`` - Range direction for DEM scan. * - ``PRJ.DIRECTIONTOSCANDEML`` - Azimuth direction for DEM scan. * - ``PRJ.GAIN`` - Gain value * - ``TIFFTAG_IMAGEDESCRIPTION`` - :samp:`XYZ ground and satellite positions on S2 tile` :Clean-up: These files are removed automatically.