S4-L2-CLD
Variables
The table below lists the variables that are present in the HARP product that results from an ingestion of S4-L2-CLD 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 |
cloud_base_height |
float |
{time} |
[m] |
cloud base height |
cloud_base_height_uncertainty |
float |
{time} |
[m] |
standard error of cloud base height |
cloud_base_pressure |
float |
{time} |
[Pa] |
cloud base pressure |
cloud_base_pressure_uncertainty |
float |
{time} |
[Pa] |
standard error of cloud base pressure |
cloud_fraction |
float |
{time} |
[] |
cloud fraction |
cloud_fraction_uncertainty |
float |
{time} |
[] |
standard error of cloud fraction; not available for model=CMA+OCA (falls back to the CAL value) |
cloud_optical_depth |
float |
{time} |
[] |
cloud optical thickness |
cloud_optical_depth_uncertainty |
float |
{time} |
[] |
standard error of cloud optical thickness |
cloud_top_height |
float |
{time} |
[m] |
cloud top height |
cloud_top_height_uncertainty |
float |
{time} |
[m] |
standard error of cloud top height |
cloud_top_pressure |
float |
{time} |
[Pa] |
cloud top pressure |
cloud_top_pressure_uncertainty |
float |
{time} |
[Pa] |
standard error of cloud top pressure |
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 |
surface_albedo |
float |
{time} |
[] |
surface albedo fitted from the CAL model |
surface_albedo_uncertainty |
float |
{time} |
[] |
standard error of the surface albedo fitted from the CAL model |
cloud_top_temperature |
float |
{time} |
[K] |
cloud top temperature |
cloud_type |
int8 |
{time} |
cloud phase; enumeration values: cloud_free (0), water_cloud (1), ice_cloud (2) |
|
cloud_fraction_validity |
int8 |
{time} |
continuous quality descriptor, varying between 0 (no data) and 100 (full quality data) |
|
validity |
int8 |
{time} |
processing error flag |
|
cloud_height_crb |
float |
{time} |
[m] |
atmospheric height at the level of cloud using the ROCINN CRB model |
cloud_height_crb_uncertainty |
float |
{time} |
[m] |
standard error of the atmospheric height at the level of cloud using the ROCINN CRB model |
cloud_albedo_crb |
float |
{time} |
[] |
albedo of cloud using the ROCINN CRB model |
cloud_albedo_crb_uncertainty |
float |
{time} |
[] |
standard error of the albedo of cloud using the ROCINN CRB model |
cloud_fraction_validity_crb |
int8 |
{time} |
continuous quality descriptor for the CRB model, varying between 0 (no data) and 100 (full quality data) |
|
surface_albedo_crb |
float |
{time} |
[] |
surface albedo fitted using the ROCINN CRB model |
surface_albedo_crb_uncertainty |
float |
{time} |
[] |
standard error of the surface albedo fitted using the ROCINN CRB model |
validity_crb |
int8 |
{time} |
processing error flag for the CRB model |
|
liquid_particle_optical_depth |
float |
{time} |
[] |
liquid cloud optical thickness |
liquid_particle_top_pressure |
float |
{time} |
[Pa] |
liquid cloud top pressure |
ice_particle_optical_depth |
float |
{time} |
[] |
ice cloud optical thickness |
ice_particle_top_pressure |
float |
{time} |
[Pa] |
ice cloud top pressure |
dust_aerosol_optical_depth |
float |
{time} |
[] |
desert dust optical thickness |
dust_aerosol_top_pressure |
float |
{time} |
[Pa] |
desert dust top pressure |
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 |
NIR |
ingest cloud properties in the UV/VIS (default) or NIR (band=NIR) |
model |
CRB, CMA+OCA |
cloud retrieval model to use: CAL (default), CRB (model=CRB), or CMA+OCA (model=CMA+OCA) |
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[] |
cloud_base_height |
condition |
band unset |
path |
/PRODUCT/cloud_base_height[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/cloud_base_height[] |
|
cloud_base_height_uncertainty |
condition |
band unset |
path |
/PRODUCT/cloud_base_height_precision[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/cloud_base_height_precision[] |
|
cloud_base_pressure |
condition |
band unset |
path |
/PRODUCT/cloud_base_pressure[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/cloud_base_pressure[] |
|
cloud_base_pressure_uncertainty |
condition |
band unset |
path |
/PRODUCT/cloud_base_pressure_precision[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/cloud_base_pressure_precision[] |
|
cloud_fraction |
condition |
band unset and model unset or model=CRB |
path |
/PRODUCT/cloud_fraction[] |
|
condition |
band=NIR and model unset or model=CRB |
|
path |
/PRODUCT_NIR/cloud_fraction[] |
|
condition |
band unset and model=CMA+OCA |
|
path |
/PRODUCT/SUPPORT_DATA/INPUT_DATA/cma_cloud_fraction_psf[] |
|
condition |
band=NIR and model=CMA+OCA |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/cma_cloud_fraction_psf[] |
|
cloud_fraction_uncertainty |
condition |
band unset and model unset |
path |
/PRODUCT/cloud_fraction_precision[] |
|
condition |
band=NIR and model unset |
|
path |
/PRODUCT_NIR/cloud_fraction_precision[] |
|
condition |
band unset and model=CRB |
|
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_crb_precision[] |
|
condition |
band=NIR and model=CRB |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_crb_precision[] |
|
cloud_optical_depth |
condition |
band unset and model unset or model=CRB |
path |
/PRODUCT/cloud_optical_thickness[] |
|
condition |
band=NIR and model unset or model=CRB |
|
path |
/PRODUCT_NIR/cloud_optical_thickness[] |
|
condition |
band unset and model=CMA+OCA |
|
path |
/PRODUCT/SUPPORT_DATA/INPUT_DATA/oca_total_cot_psf[] |
|
condition |
band=NIR and model=CMA+OCA |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/oca_total_cot_psf[] |
|
cloud_optical_depth_uncertainty |
condition |
band unset |
path |
/PRODUCT/cloud_optical_thickness_precision[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/cloud_optical_thickness_precision[] |
|
cloud_top_height |
condition |
band unset |
path |
/PRODUCT/cloud_top_height[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/cloud_top_height[] |
|
cloud_top_height_uncertainty |
condition |
band unset |
path |
/PRODUCT/cloud_top_height_precision[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/cloud_top_height_precision[] |
|
cloud_top_pressure |
condition |
band unset and model unset |
path |
/PRODUCT/cloud_top_pressure[] |
|
condition |
band=NIR and model unset |
|
path |
/PRODUCT_NIR/cloud_top_pressure[] |
|
condition |
band unset and model=CRB |
|
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_pressure_crb[] |
|
condition |
band=NIR and model=CRB |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_pressure_crb[] |
|
condition |
band unset and model=CMA+OCA |
|
path |
/PRODUCT/SUPPORT_DATA/INPUT_DATA/oca_total_ctp_psf[] |
|
condition |
band=NIR and model=CMA+OCA |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/oca_total_ctp_psf[] |
|
cloud_top_pressure_uncertainty |
condition |
band unset and model unset |
path |
/PRODUCT/cloud_top_pressure_precision[] |
|
condition |
band=NIR and model unset |
|
path |
/PRODUCT_NIR/cloud_top_pressure_precision[] |
|
condition |
band unset and model=CRB |
|
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_pressure_crb_precision[] |
|
condition |
band=NIR and model=CRB |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_pressure_crb_precision[] |
|
surface_altitude |
condition |
band unset |
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 |
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 |
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 |
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 |
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 |
path |
/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_temperature[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/surface_temperature[] |
|
surface_albedo |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo[] |
|
surface_albedo_uncertainty |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_precision[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_precision[] |
|
cloud_top_temperature |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_top_temperature[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_top_temperature[] |
|
cloud_type |
condition |
band unset |
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_validity |
condition |
band unset |
path |
/PRODUCT/qa_value[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/qa_value[] |
|
validity |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/processing_errors[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/processing_errors[] |
|
cloud_height_crb |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_height_crb[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_height_crb[] |
|
cloud_height_crb_uncertainty |
condition |
band unset |
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_albedo_crb |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_crb[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_crb[] |
|
cloud_albedo_crb_uncertainty |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_crb_precision[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/cloud_albedo_crb_precision[] |
|
cloud_fraction_validity_crb |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/qa_value_crb[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/qa_value_crb[] |
|
surface_albedo_crb |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_crb[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo_crb[] |
|
surface_albedo_crb_uncertainty |
condition |
band unset |
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_crb |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/processing_errors_crb[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/DETAILED_RESULTS/processing_errors_crb[] |
|
liquid_particle_optical_depth |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/INPUT_DATA/oca_liquid_cot_psf[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/oca_liquid_cot_psf[] |
|
liquid_particle_top_pressure |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/INPUT_DATA/oca_liquid_ctp_psf[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/oca_liquid_ctp_psf[] |
|
ice_particle_optical_depth |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/INPUT_DATA/oca_ice_cot_psf[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/oca_ice_cot_psf[] |
|
ice_particle_top_pressure |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/INPUT_DATA/oca_ice_ctp_psf[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/oca_ice_ctp_psf[] |
|
dust_aerosol_optical_depth |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/INPUT_DATA/oca_desert_dust_cot_psf[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/oca_desert_dust_cot_psf[] |
|
dust_aerosol_top_pressure |
condition |
band unset |
path |
/PRODUCT/SUPPORT_DATA/INPUT_DATA/oca_desert_dust_ctp_psf[] |
|
condition |
band=NIR |
|
path |
/PRODUCT_NIR/SUPPORT_DATA/INPUT_DATA/oca_desert_dust_ctp_psf[] |
|