S5P_L2_CLOUD_CAL
Variables
The table below lists the variables that are present in the HARP product that results from an ingestion of S5P_L2_CLOUD_CAL 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} | [] | retrieved fraction of horizontal area occupied by clouds using the OCRA/ROCINN CAL model | 
| cloud_fraction_uncertainty | float | {time} | [] | uncertainty of the retrieved fraction of horizontal area occupied by clouds using the OCRA/ROCINN CAL model | 
| cloud_fraction_validity | int8 | {time} | continuous quality descriptor, varying between 0 (no data) and 100 (full quality data) | |
| cloud_fraction_apriori | float | {time} | [] | effective radiometric cloud fraction a priori | 
| cloud_base_pressure | float | {time} | [Pa] | cloud base pressure calculated using the OCRA/ROCINN CAL model | 
| cloud_base_pressure_uncertainty | float | {time} | [Pa] | error of the cloud base pressure calculated using the OCRA/ROCINN CAL model | 
| cloud_base_height | float | {time} | [m] | cloud base height calculated using the OCRA/ROCINN CAL model | 
| cloud_base_height_uncertainty | float | {time} | [m] | error of the cloud base height calculated using the OCRA/ROCINN CAL model | 
| cloud_top_pressure | float | {time} | [Pa] | retrieved atmospheric pressure at the level of cloud top using the OCRA/ROCINN CAL model | 
| cloud_top_pressure_uncertainty | float | {time} | [Pa] | uncertainty of the retrieved atmospheric pressure at the level of cloud top using the OCRA/ROCINN CAL model | 
| cloud_top_height | float | {time} | [m] | retrieved altitude of the cloud top using the OCRA/ROCINN CAL model | 
| cloud_top_height_uncertainty | float | {time} | [m] | uncertainty of the altitude of the cloud top using the OCRA/ROCINN CAL model | 
| cloud_optical_depth | float | {time} | [m] | retrieved cloud optical depth using the OCRA/ROCINN CAL model | 
| cloud_optical_depth_uncertainty | float | {time} | [m] | uncertainty of the retrieved cloud optical depth using the OCRA/ROCINN CAL model | 
| surface_albedo | float | {time} | [] | surface albedo fitted using the OCRA/ROCINN CAL model | 
| surface_albedo_uncertainty | float | {time} | [] | uncertainty of the surface albedo fitted using the OCRA/ROCINN CAL model | 
| surface_altitude | float | {time} | [m] | surface altitude | 
| surface_altitude_uncertainty | float | {time} | [m] | surface altitude precision | 
| surface_pressure | float | {time} | [Pa] | surface pressure | 
| surface_meridional_wind_velocity | float | {time} | [m/s] | northward wind | 
| surface_zonal_wind_velocity | float | {time} | [m/s] | eastward wind | 
| snow_ice_type | int8 | {time} | surface snow/ice type; 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) | 
| 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_CLOUD products.
| option name | legal values | description | 
|---|---|---|
| model | CAL, CRB | whether to retrieve the cloud properties from the CAL model or the CRB model; option values are ‘CAL’ (default) and ‘CRB’ | 
This definition is only applicable when: model=CAL or model unset
Mapping description
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) | |
| 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/cloud_fraction[] | 
| cloud_fraction_uncertainty | path | /PRODUCT/cloud_fraction_precision[] | 
| cloud_fraction_validity | path | /PRODUCT/qa_value | 
| cloud_fraction_apriori | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_apriori[] | 
| cloud_base_pressure | path | /PRODUCT/cloud_base_pressure[] | 
| cloud_base_pressure_uncertainty | path | /PRODUCT/cloud_base_pressure_precision[] | 
| cloud_base_height | path | /PRODUCT/cloud_base_height[] | 
| cloud_base_height_uncertainty | path | /PRODUCT/cloud_base_height_precision[] | 
| cloud_top_pressure | path | /PRODUCT/cloud_top_pressure[] | 
| cloud_top_pressure_uncertainty | path | /PRODUCT/cloud_top_pressure_precision[] | 
| cloud_top_height | path | /PRODUCT/cloud_top_height[] | 
| cloud_top_height_uncertainty | path | /PRODUCT/cloud_top_height_precision[] | 
| cloud_optical_depth | path | /PRODUCT/cloud_optical_thickness[] | 
| cloud_optical_depth_uncertainty | path | /PRODUCT/cloud_optical_thickness_precision[] | 
| surface_albedo | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_fitted[] | 
| surface_albedo_uncertainty | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_fitted_precision[] | 
| surface_altitude | path | /PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_altitude[] | 
| surface_altitude_uncertainty | path | /PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_altitude_precision[] | 
| surface_pressure | path | /PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_pressure[] | 
| surface_meridional_wind_velocity | available | optional | 
| condition | processor version >= 02.00.00 | |
| path | /PRODUCT/SUPPORT_DATA/INPUT_DATA/northward_wind[] | |
| surface_zonal_wind_velocity | available | optional | 
| condition | processor version >= 02.00.00 | |
| path | /PRODUCT/SUPPORT_DATA/INPUT_DATA/eastward_wind[] | |
| snow_ice_type | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/snow_ice_flag_nise[] | 
| 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 | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/snow_ice_flag_nise[] | 
| description | if 1 <= snow_ice_flag <= 100 then snow_ice_flag/100.0 else 0.0 | |