S5P_L2_CLOUD_CRB

Variables

The table below lists the variables that are present in the HARP product that results from an ingestion of S5P_L2_CLOUD_CRB 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 effective radiometric cloud fraction using the OCRA/ROCINN CRB model

cloud_fraction_uncertainty

float

{time}

[]

uncertainty of the retrieved effective radiometric cloud fraction using the OCRA/ROCINN CRB 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_pressure

float

{time}

[Pa]

retrieved atmospheric pressure at the level of cloud using the OCRA/ROCINN CRB model

cloud_pressure_uncertainty

float

{time}

[Pa]

error of the retrieved atmospheric pressure at the level of cloud using the OCRA/ROCINN CRB model

cloud_height

float

{time}

[m]

retrieved altitude at the level of cloud using the OCRA/ROCINN CRB model

cloud_height_uncertainty

float

{time}

[m]

error of the retrieved altitude at the level of cloud using the OCRA/ROCINN CRB model

cloud_type

int8

{time}

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

cloud_albedo

float

{time}

[]

albedo of cloud using the OCRA/ROCINN CRB model

cloud_albedo_uncertainty

float

{time}

[]

uncertainty of the albedo of cloud using the OCRA/ROCINN CRB model

surface_albedo

float

{time}

[]

surface albedo fitted using the OCRA/ROCINN CRB model

surface_albedo_uncertainty

float

{time}

[]

uncertainty of the surface albedo fitted using the OCRA/ROCINN CRB 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’

band

UVVIS, NIR

whether to retrieve the cloud properties on the spatial grid of the TROPOMI UVVIS bands (default) or the spatial grid of the NIR band

This definition is only applicable when: model=CRB, band=UVVIS or band 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/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_crb[]

cloud_fraction_uncertainty

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_crb_precision[]

cloud_fraction_validity

available

optional

condition

processor version >= 01.00.00

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/qa_value_crb

cloud_fraction_apriori

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_apriori[]

cloud_pressure

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_pressure_crb[]

cloud_pressure_uncertainty

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_pressure_crb_precision[]

cloud_height

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_height_crb[]

cloud_height_uncertainty

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_height_crb_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

cloud_albedo

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_crb[]

cloud_albedo_uncertainty

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_crb_precision[]

surface_albedo

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_fitted_crb[]

surface_albedo_uncertainty

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_fitted_crb_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/INPUT_DATA/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/INPUT_DATA/snow_ice_flag_nise[]

description

if 1 <= snow_ice_flag <= 100 then snow_ice_flag/100.0 else 0.0