# S5_L2_CLD

## Variables

The table below lists the variables that are present in the HARP product that results from an ingestion of `S5_L2_CLD` data.

field name | type | dimensions | unit | description
--- | --- | --- | --- | ---
datetime | double | {time} | [seconds since 2020-01-01] | time of the measurement
datetime_length | double |  | [s] | measurement duration
orbit_index | int32 |  |  | absolute orbit number
validity | int32 | {time} |  | processing quality flag
latitude | float | {time} | [degree_north] | latitude of the ground-pixel centre (WGS-84)
longitude | float | {time} | [degree_east] | longitude of the ground-pixel centre (WGS-84)
latitude_bounds | float | {time, 4} | [degree_north] | four latitude boundaries of each ground pixel
longitude_bounds | float | {time, 4} | [degree_east] | four longitude boundaries of each ground pixel
sensor_latitude | float | {time} | [degree_north] | sub-satellite latitude
sensor_longitude | float | {time} | [degree_east] | sub-satellite longitude
sensor_altitude | float | {time} | [m] | space-craft altitude (WGS-84)
sensor_orbit_phase | double | {time} | [] | relative orbital phase (0 … 1)
solar_zenith_angle | float | {time} | [degree] | solar zenith angle
solar_azimuth_angle | float | {time} | [degree] | Solar azimuth angle.
sensor_zenith_angle | float | {time} | [degree] | space-craft zenith angle
sensor_azimuth_angle | float | {time} | [degree] | space-craft azimuth angle
surface_altitude | float | {time} | [m] | height of the surface above the WGS-84 ellipsoid averaged over the Sentinel-5 ground pixel.
surface_altitude_uncertainty | float | {time} | [m] | 1-sigma uncertainty of the surface altitude
surface_pressure | float | {time} | [Pa] | surface pressure from ECMWF, adjusted for surface elevation
snow_ice_type | int32 | {time} |  | surface condition (snow/ice); enumeration values: snow_free_land (0), sea_ice (1), permanent_ice (2), snow (3), ocean (4)
sea_ice_fraction | float | {time} | [] | sea-ice concentration (as a fraction)
cloud_fraction | float | {time} | [] | effective cloud fraction
cloud_fraction_uncertainty | float | {time} | [] | effective cloud fraction precision
cloud_pressure | float | {time} | [Pa] | cloud pressure
cloud_pressure_precision | float | {time} | [Pa] | cloud pressure precision
cloud_height | float | {time} | [m] | cloud height above sea-level
cloud_height_precision | float | {time} | [m] | cloud height above sea-level precision
cloud_fraction_validity | int32 | {time} | [] | quality assurance value describing the quality of the product
scene_albedo | float | {time} | [] | scene albedo
scene_albedo_uncertainty | float | {time} | [] | scene albedo precision
scene_pressure | float | {time} | [Pa] | scene pressure
scene_pressure_uncertainty | float | {time} | [Pa] | scene pressure precision
scene_height | float | {time} | [m] | scene height above sea-level
scene_height_uncertainty | float | {time} | [m] | scene height above sea-level precision
cloud_albedo | float | {time} | [] | cloud albedo
cloud_albedo_uncertainty | float | {time} | [] | cloud albedo precision
index | int32 | {time} |  | zero-based index of the sample within the source product

## Ingestion options

The table below lists the available ingestion options for `S5_L2_CLD` products.

option name | legal values | description
--- | --- | ---
band | band3a, band3c | which CLD band values to ingest: band3a (default) or band3c

## Mapping description

The table below details where and how each variable was retrieved from the input product.

field name | mapping description
--- | ---
datetime | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/time, /data/PRODUCT_BAND3A/delta_time[]
description | time converted from days since 2020-01-01 to seconds since 2020-01-01 (using 86400 seconds per day) and delta_time added; the time associated with a scanline is repeated for each pixel in the scanline
condition | band=band3c
path | /data/PRODUCT_BAND3C/time, /data/PRODUCT_BAND3C/delta_time[]
description | time converted from days since 2020-01-01 to seconds since 2020-01-01 (using 86400 seconds per day) and delta_time added; the time associated with a scanline is repeated for each pixel in the scanline
datetime_length | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/delta_time[]
description | delta_time[1] - delta_time[0]
condition | band=band3c
path | /data/PRODUCT_BAND3C/delta_time[]
description | delta_time[1] - delta_time[0]
orbit_index | path | /@orbit_start
validity | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/processing_quality_flags[]
description | the uint64 data is cast to int32
condition | band=band3c
path | /data/PRODUCT_BAND3C/processing_quality_flags[]
description | the uint64 data is cast to int32
latitude | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/latitude[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/latitude[]
longitude | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/longitude[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/longitude[]
latitude_bounds | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/latitude_bounds[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/latitude_bounds[]
longitude_bounds | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/longitude_bounds[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/longitude_bounds[]
sensor_latitude | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/satellite_latitude[]
description | value for each scanline is repeated for every pixel
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/satellite_latitude[]
description | value for each scanline is repeated for every pixel
sensor_longitude | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/satellite_longitude[]
description | value for each scanline is repeated for every pixel
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/satellite_longitude[]
description | value for each scanline is repeated for every pixel
sensor_altitude | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/satellite_altitude[]
description | value for each scanline is repeated for every pixel
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/satellite_altitude[]
description | value for each scanline is repeated for every pixel
sensor_orbit_phase | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/satellite_orbit_phase[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/satellite_orbit_phase[]
solar_zenith_angle | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/solar_zenith_angle[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/solar_zenith_angle[]
solar_azimuth_angle | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/solar_azimuth_angle[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/solar_azimuth_angle[]
sensor_zenith_angle | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/viewing_zenith_angle[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/viewing_zenith_angle[]
sensor_azimuth_angle | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/GEOLOCATIONS/viewing_azimuth_angle[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/GEOLOCATIONS/viewing_azimuth_angle[]
surface_altitude | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/INPUT_DATA/surface_altitude[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/INPUT_DATA/surface_altitude[]
surface_altitude_uncertainty | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/INPUT_DATA/surface_altitude_precision[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/INPUT_DATA/surface_altitude_precision[]
surface_pressure | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/INPUT_DATA/surface_pressure[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/INPUT_DATA/surface_pressure[]
snow_ice_type | path | data/PRODUCT/SUPPORT_DATA/INPUT_DATA/snow_ice_flag[]
description | 0: snow_free_land (0), 1-100: sea_ice (1), 101: permanent_ice (2), 103: snow (3), 255: ocean (4), other values map to -1
sea_ice_fraction | path | data/PRODUCT/SUPPORT_DATA/INPUT_DATA/snow_ice_flag[]
description | if 1 <= snow_ice_flag <= 100 then snow_ice_flag/100.0 else 0.0
cloud_fraction | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/effective_cloud_fraction[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/effective_cloud_fraction[]
cloud_fraction_uncertainty | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/effective_cloud_fraction_precision[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/effective_cloud_fraction_precision[]
cloud_pressure | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/cloud_pressure[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/cloud_pressure[]
cloud_pressure_precision | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/cloud_pressure_precision[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/cloud_pressure_precision[]
cloud_height | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/cloud_height[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/cloud_height[]
cloud_height_precision | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/cloud_height_precision[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/cloud_height_precision[]
cloud_fraction_validity | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/qa_value[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/qa_value[]
scene_albedo | condition | band=band3a or band unset
path | data/PRODUCT_BAND3A/SUPPORT_DATA/DETAILED_RESULTS/scene_albedo[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/DETAILED_RESULTS/scene_albedo[]
scene_albedo_uncertainty | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/DETAILED_RESULTS/scene_albedo_precision[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/DETAILED_RESULTS/scene_albedo_precision[]
scene_pressure | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/DETAILED_RESULTS/scene_pressure[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/DETAILED_RESULTS/scene_pressure[]
scene_pressure_uncertainty | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/DETAILED_RESULTS/scene_pressure_precision[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/DETAILED_RESULTS/scene_pressure_precision[]
scene_height | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/DETAILED_RESULTS/scene_height[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/sSUPPORT_DATA/DETAILED_RESULTS/cene_height[]
scene_height_uncertainty | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/DETAILED_RESULTS/scene_height_precision[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/DETAILED_RESULTS/scene_height_precision[]
cloud_albedo | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo[]
cloud_albedo_uncertainty | condition | band=band3a or band unset
path | /data/PRODUCT_BAND3A/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_precision[]
condition | band=band3c
path | /data/PRODUCT_BAND3C/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_precision[]