S4-L2-CLD-CRB

Variables

The table below lists the variables that are present in the HARP product that results from an ingestion of S4-L2-CLD-CRB data.

field name

type

dimensions

unit

description

scan_subindex

int16

{time}

pixel index (0-based) within the scanline

cycle_index

int32

repeat cycle number within the day

datetime

double

{time}

[seconds since 2000-01-01]

time of the measurement

datetime_length

double

[s]

measurement duration

latitude

float

{time}

[degree_north]

pixel center latitude

longitude

float

{time}

[degree_east]

pixel center longitude

latitude_bounds

float

{time, 4}

[degree_north]

latitudes of pixel boundary

longitude_bounds

float

{time, 4}

[degree_east]

longitudes of pixel boundary

solar_zenith_angle

float

{time}

[degree]

zenith angle of the Sun at the ground pixel location; angle measured away from the vertical

solar_azimuth_angle

float

{time}

[degree]

azimuth angle of the Sun at the ground pixel location; angle measured clockwise from North

viewing_zenith_angle

float

{time}

[degree]

zenith angle of the satellite at the ground pixel location; angle measured away from the vertical

viewing_azimuth_angle

float

{time}

[degree]

azimuth angle of the satellite at the ground pixel location; angle measured clockwise from North

surface_altitude

float

{time}

[m]

surface altitude

surface_altitude_uncertainty

float

{time}

[m]

standard error of surface altitude

surface_pressure

float

{time}

[Pa]

surface pressure

surface_type

int32

{time}

surface type classification

snow_ice_type

int8

{time}

surface snow/ice type; enumeration values: snow_free_land (0), snow_ice (1)

surface_temperature

float

{time}

[K]

surface temperature

cloud_type

int8

{time}

cloud phase; enumeration values: cloud_free (0), water_cloud (1), ice_cloud (2)

cloud_fraction

float

{time}

[]

effective radiometric cloud fraction using the OCRA CRB model

cloud_fraction_uncertainty

float

{time}

[]

standard error of the effective radiometric cloud fraction using the OCRA CRB model

cloud_fraction_validity

int8

{time}

continuous quality descriptor, varying between 0 (no data) and 100 (full quality data)

cloud_height

float

{time}

[m]

atmospheric height at the level of cloud using the ROCINN CRB model

cloud_height_uncertainty

float

{time}

[m]

standard error of the atmospheric height at the level of cloud using the ROCINN CRB model

cloud_pressure

float

{time}

[Pa]

pressure at the cloud optical centroid using the ROCINN CRB model

cloud_pressure_uncertainty

float

{time}

[Pa]

standard error of the pressure at the cloud optical centroid using the ROCINN CRB model

cloud_albedo

float

{time}

[]

albedo of cloud using the ROCINN CRB model

cloud_albedo_uncertainty

float

{time}

[]

standard error of the albedo of cloud using the ROCINN CRB model

surface_albedo

float

{time}

[]

surface albedo fitted using the ROCINN CRB model

surface_albedo_uncertainty

float

{time}

[]

standard error of the surface albedo fitted using the ROCINN CRB model

validity

int8

{time}

processing error flag

index

int32

{time}

zero-based index of the sample within the source product

Ingestion options

The table below lists the available ingestion options for S4-L2-CLD products.

option name

legal values

description

band

UVVIS, NIR

ingest cloud properties in the UV/VIS (default, or explicitly band=UVVIS) or NIR (band=NIR)

model

CAL, CRB, CMA+OCA

cloud retrieval model to use: CAL (default, or explicitly model=CAL), CRB (model=CRB), or CMA+OCA (model=CMA+OCA)

This definition is only applicable when: model=CRB

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 ground_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 pixels per scanline

cycle_index

path

/@repeat_cycle_in_day[0]

description

parsed from the string attribute repeat_cycle_in_day

datetime

path

/@time_reference_days_since_1950, /PRODUCT/delta_time[]

description

time reference converted from days since 1950-01-01 to seconds since 2000-01-01 (using 86400 seconds per day) and delta_time added

datetime_length

path

/PRODUCT/delta_time[]

description

delta_time[num_ground_pixels] - delta_time[0]

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[]

solar_zenith_angle

path

/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/solar_zenith_angle[]

solar_azimuth_angle

path

/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/solar_azimuth_angle[]

viewing_zenith_angle

path

/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/viewing_zenith_angle[]

viewing_azimuth_angle

path

/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/viewing_azimuth_angle[]

surface_altitude

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_altitude[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/surface_altitude[]

surface_altitude_uncertainty

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_altitude_precision[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/surface_altitude_precision[]

surface_pressure

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_pressure[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/surface_pressure[]

surface_type

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_classification[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/surface_classification[]

snow_ice_type

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/snow_ice_flag[]

description

0: snow_free_land, 1: snow_ice

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/snow_ice_flag[]

description

0: snow_free_land, 1: snow_ice

surface_temperature

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_temperature[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/surface_temperature[]

cloud_type

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_phase[]

description

0: cloud_free, 1: water_cloud, 2: ice_cloud

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_phase[]

description

0: cloud_free, 1: water_cloud, 2: ice_cloud

cloud_fraction

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_crb[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_crb[]

cloud_fraction_uncertainty

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_crb_precision[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_crb_precision[]

cloud_fraction_validity

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/qa_value_crb[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/qa_value_crb[]

cloud_height

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_height_crb[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_height_crb[]

cloud_height_uncertainty

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_height_crb_precision[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_height_crb_precision[]

cloud_pressure

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_pressure_crb[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_pressure_crb[]

cloud_pressure_uncertainty

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_pressure_crb_precision[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_pressure_crb_precision[]

cloud_albedo

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_crb[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_crb[]

cloud_albedo_uncertainty

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_crb_precision[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_crb_precision[]

surface_albedo

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_crb[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_crb[]

surface_albedo_uncertainty

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_crb_precision[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_crb_precision[]

validity

condition

band unset or band=UVVIS

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/processing_errors_crb[]

condition

band=NIR

path

/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/processing_errors_crb[]