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_top_temperature

float

{time}

[K]

atmospheric temperature at cloud top level 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

cloud_type

int8

{time}

phase of the retrieved cloud; enumeration values: clear_sky (0), liquid_water_clouds (1), ice_clouds (2)

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_top_temperature

available

optional

condition

processor version >= 02.00.00

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_top_temperature[]

cloud_optical_depth

path

/PRODUCT/cloud_optical_thickness[]

cloud_optical_depth_uncertainty

path

/PRODUCT/cloud_optical_thickness_precision[]

cloud_type

available

optional

condition

processor version >= 02.00.00

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_phase[]

description

values are mapped to signed values, so 255 (undefined cloud phase) becomes -1

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