# 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
--- | --- | --- | --- | ---
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_north] | latitudes of pixel boundary
validity | int8 | {time} |  | continuous quality descriptor, varying between 0 (no data) and 100 (full quality data)
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
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
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)

## Mapping description

The table below details where and how each variable was retrieved from the input product.

field name | mapping description
--- | ---
datetime | path | /@time_reference_days_since_1950, /PRODUCT/delta_time[]
description | time reference converted from days since 1950-01-01 to seconds since 2020-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[]
validity | path | /PRODUCT/qa_value
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
path | /PRODUCT/cloud_fraction[]
condition | band=NIR
path | /PRODUCT_NIR/cloud_fraction[]
cloud_fraction_uncertainty | condition | band unset
path | /PRODUCT/cloud_fraction_precision[]
condition | band=NIR
path | /PRODUCT_NIR/cloud_fraction_precision[]
cloud_optical_depth | condition | band unset
path | /PRODUCT/cloud_optical_thickness[]
condition | band=NIR
path | /PRODUCT_NIR/cloud_optical_thickness[]
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
path | /PRODUCT/cloud_top_pressure[]
condition | band=NIR
path | /PRODUCT_NIR/cloud_top_pressure[]
cloud_top_pressure_uncertainty | condition | band unset
path | /PRODUCT/cloud_top_pressure_precision[]
condition | band=NIR
path | /PRODUCT_NIR/cloud_top_pressure_precision[]