# S5P_L2_O22CLD

## Variables

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

field name | type | dimensions | unit | description
--- | --- | --- | --- | ---
scan_subindex | int16 | {time} |  | pixel index (0-based) within the scanline
datetime_start | double | {time} | [seconds since 2010-01-01] | start time of the measurement
datetime_length | double |  | [s] | duration of the measurement
orbit_index | int32 |  |  | absolute orbit number
validity | int32 | {time} |  | processing quality flag
latitude | float | {time} | [degree_north] | latitude of the ground pixel center (WGS84)
longitude | float | {time} | [degree_east] | longitude of the ground pixel center (WGS84)
latitude_bounds | float | {time, 4} | [degree_north] | latitudes of the ground pixel corners (WGS84)
longitude_bounds | float | {time, 4} | [degree_east] | longitudes of the ground pixel corners (WGS84)
sensor_latitude | float | {time} | [degree_north] | latitude of the geodetic sub-satellite point (WGS84)
sensor_longitude | float | {time} | [degree_east] | longitude of the goedetic sub-satellite point (WGS84)
sensor_altitude | float | {time} | [m] | altitude of the satellite with respect to the geodetic sub-satellite point (WGS84)
solar_zenith_angle | float | {time} | [degree] | zenith angle of the Sun at the ground pixel location (WGS84); angle measured away from the vertical
solar_azimuth_angle | float | {time} | [degree] | azimuth angle of the Sun at the ground pixel location (WGS84); angle measured East-of-North
sensor_zenith_angle | float | {time} | [degree] | zenith angle of the satellite at the ground pixel location (WGS84); angle measured away from the vertical
sensor_azimuth_angle | float | {time} | [degree] | azimuth angle of the satellite at the ground pixel location (WGS84); angle measured East-of-North
cloud_fraction | float | {time} | [] | effective cloud fraction retrieved from the O2–O2 absorption
cloud_fraction_uncertainty | float | {time} | [] | uncertainty of the effective cloud fraction retrieved from the O2–O2 absorption
cloud_pressure | float | {time} | [Pa] | cloud pressure derived from the O2–O2 absorption at 477nm
cloud_pressure_uncertainty | float | {time} | [Pa] | error of the cloud pressure derived from the O2–O2 absorption at 477nm
cloud_height | float | {time} | [m] | retrieved cloud height from the O22CLD algorithm
cloud_height_uncertainty | float | {time} | [m] | error of the retrieved cloud height from the O22CLD algorithm
cloud_albedo | float | {time} | [] | cloud albedo parameter
surface_albedo | float | {time} | [] | assumed surface albedo at 475 nm
index | int32 | {time} |  | zero-based index of the sample within the source product

## Ingestion options

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

option name | legal values | description
--- | --- | ---
data | o22cld | whether to ingest the NO2 data (default) or the O2-O2 cloud data (data=o22cld)
total_column | summed, total | whether to use nitrogendioxide_total_column (which is derived from the total slant column divided by the total amf) or nitrogendioxide_summed_total_column (which is the sum of the retrieved tropospheric and stratospheric columns); option values are ‘summed’ (default) and ‘total’
cloud_fraction | radiance | whether to ingest the cloud fraction (default) or the radiance cloud fraction (cloud_fraction=radiance) for the NO2 data

This definition is only applicable when: data=o22cld

## Mapping description

If processor version < 02.02.00 then an empty product is returned.

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

field name | mapping description
--- | ---
scan_subindex | description | the scanline and pixel dimensions are collapsed into a temporal dimension; the index of the pixel within the scanline is computed as the index on the temporal dimension modulo the number of scanlines
datetime_start | path | /PRODUCT/time, /PRODUCT/delta_time[]
description | time converted from milliseconds since a reference time (given as seconds since 2010-01-01) to seconds since 2010-01-01 (using 86400 seconds per day); the time associated with a scanline is repeated for each pixel in the scanline
datetime_length | path | /@time_coverage_resolution
description | the measurement length is parsed assuming the ISO 8601 ‘PT%(interval_seconds)fS’ format
orbit_index | path | /@orbit
validity | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/processing_quality_flags[]
description | the uint32 data is cast to int32
latitude | path | /PRODUCT/latitude[]
longitude | path | /PRODUCT/longitude[]
latitude_bounds | path | /PRODUCT/SUPPORT_DATA/GEOLOCATIONS/latitude_bounds[]
longitude_bounds | path | /PRODUCT/SUPPORT_DATA/GEOLOCATIONS/longitude_bounds[]
sensor_latitude | path | /PRODUCT/SUPPORT_DATA/GEOLOCATIONS/satellite_latitude[]
description | the satellite latitude associated with a scanline is repeated for each pixel in the scanline
sensor_longitude | path | /PRODUCT/SUPPORT_DATA/GEOLOCATIONS/satellite_longitude[]
description | the satellite longitude associated with a scanline is repeated for each pixel in the scanline
sensor_altitude | path | /PRODUCT/SUPPORT_DATA/GEOLOCATIONS/satellite_altitude[]
description | the satellite altitude associated with a scanline is repeated for each pixel in the scanline
solar_zenith_angle | path | /PRODUCT/SUPPORT_DATA/GEOLOCATIONS/solar_zenith_angle[]
solar_azimuth_angle | path | /PRODUCT/SUPPORT_DATA/GEOLOCATIONS/solar_azimuth_angle[]
sensor_zenith_angle | path | /PRODUCT/SUPPORT_DATA/GEOLOCATIONS/viewing_zenith_angle[]
sensor_azimuth_angle | path | /PRODUCT/SUPPORT_DATA/GEOLOCATIONS/viewing_azimuth_angle[]
cloud_fraction | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/O22CLD/o22cld_cloud_fraction_crb[]
cloud_fraction_uncertainty | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/O22CLD/o22cld_cloud_fraction_crb_precision[]
cloud_pressure | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/O22CLD/o22cld_cloud_pressure_crb[]
cloud_pressure_uncertainty | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/O22CLD/o22cld_cloud_pressure_crb_precision[]
cloud_height | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/O22CLD/o22cld_cloud_height_crb[]
cloud_height_uncertainty | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/O22CLD/o22cld_cloud_height_crb_precision[]
cloud_albedo | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/O22CLD/o22cld_cloud_albedo_crb[]
surface_albedo | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/O22CLD/o22cld_surface_albedo[]