S5_L2_FDY
Variables
The table below lists the variables that are present in the HARP product that results from an ingestion of S5_L2_FDY data.
field name |
type |
dimensions |
unit |
description |
|---|---|---|---|---|
scan_subindex |
int16 |
{time} |
pixel index (0-based) within the scanline |
|
datetime |
double |
{time} |
[seconds since 2020-01-01] |
time of the measurement |
datetime_length |
double |
[s] |
measurement duration |
|
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] |
the four latitude boundaries of each ground pixel |
longitude_bounds |
float |
{time, 4} |
[degree_east] |
the four longitude boundaries of each ground pixel |
sensor_latitude |
float |
{time} |
[degree_north] |
latitude of the spacecraft sub-satellite point on the WGS84 reference ellipsoid |
sensor_longitude |
float |
{time} |
[degree_east] |
longitude of the spacecraft sub-satellite point on the WGS84 reference ellipsoid |
sensor_altitude |
float |
{time} |
[m] |
altitude of the spacecraft relative to the WGS84 reference ellipsoid. |
sensor_orbit_phase |
double |
{time} |
[] |
relative offset (0.0 … 1.0) of the measurement in the orbit. |
solar_zenith_angle |
float |
{time} |
[degree] |
zenith angle of the sun measured from the ground pixel location on the WGS84 reference ellipsoid |
solar_azimuth_angle |
float |
{time} |
[degree] |
azimuth angle of the sun measured from the ground pixel location on the WGS84 ellipsoid |
sensor_zenith_angle |
float |
{time} |
[degree] |
zenith angle of the spacecraft measured from the ground pixel location on the WGS84 reference ellipsoid |
sensor_azimuth_angle |
float |
{time} |
[degree] |
azimuth angle of the spacecraft measured from the ground pixel WGS84 reference ellipsoid |
surface_altitude |
float |
{time} |
[m] |
height of the surface above MSL averaged over the S5 pixel |
surface_altitude_uncertainty |
float |
{time} |
[m] |
standard deviation of the height of the surface above MSL averaged over the S5 pixel |
surface_pressure |
float |
{time} |
[Pa] |
surface pressure; from ECMWF and adjusted for surface elevation |
surface_type |
int32 |
{time} |
surface classification |
|
snow_ice_type |
int32 |
{time} |
surface condition (snow/ice); 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) |
tropospheric_HCHO_column_number_density |
float |
{time} |
[mol/m^2] |
tropospheric HCHO column number density |
tropospheric_HCHO_column_number_density_uncertainty_random |
float |
{time} |
[mol/m^2] |
tropospheric HCHO vertical column density random uncertainty |
tropospheric_HCHO_column_number_density_uncertainty_systematic |
float |
{time} |
[mol/m^2] |
tropospheric HCHO vertical column density systematic uncertainty |
tropospheric_HCHO_column_number_density_amf |
float |
{time} |
[] |
tropospheric air mass factor |
tropospheric_HCHO_column_number_density_validity |
int32 |
{time} |
[] |
quality assurance value describing the quality of the product |
tropospheric_HCHO_column_number_density_amf_trueness |
float |
{time} |
[] |
systematic error of the tropospheric air mass factor |
tropospheric_HCHO_column_number_density_avk |
float |
{time, vertical} |
[] |
averaging kernel for the tropospheric HCHO column number density |
HCHO_slant_column_number_density |
float |
{time} |
[mol/m^2] |
HCHO slant column number density |
HCHO_slant_column_number_density_uncertainty |
float |
{time} |
[mol/m^2] |
uncertainty of the HCHO slant column number density |
cloud_radiance_fraction |
float |
{time} |
[] |
cloud radiance fraction |
HCHO_mass_mixing_ratio_apriori |
float |
{time, vertical} |
[kg/kg] |
HCHO apriori profile in mass mixing ratios |
surface_albedo |
float |
{time} |
[] |
surface albedo at 342 nm |
pressure_bounds |
double |
{time, vertical, 2} |
[Pa] |
pressure boundaries |
absorbing_aerosol_index |
float |
{time} |
[] |
aerosol absorbing index at 340 and 380 nm |
cloud_fraction |
float |
{time} |
[] |
cloud fraction |
cloud_albedo |
float |
{time} |
[] |
cloud albedo |
cloud_pressure |
float |
{time} |
[Pa] |
cloud 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 S5_L2_FDY products.
option name |
legal values |
description |
|---|---|---|
amf |
clear_sky |
whether to ingest the default amf, vertical column and avk (default) or the clear sky amf, scaled vertical column, and omit the avk (amf=clear_sky) |
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 |
path |
/data/PRODUCT/time, /data/PRODUCT/delta_time[] |
description |
time converted from days since 2020-01-01 to seconds since 2020-01-01 (using 86400 seconds per day) and delta_time added; the time associated with a scanline is repeated for each pixel in the scanline |
|
datetime_length |
path |
/data/PRODUCT/delta_time[] |
description |
delta_time[1] - delta_time[0] |
|
orbit_index |
path |
/@orbit_start |
validity |
path |
/data/PRODUCT/processing_quality_flags[] |
description |
the uint64 data is cast to int32 |
|
latitude |
path |
/data/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/latitude[] |
longitude |
path |
/data/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/longitude[] |
latitude_bounds |
path |
/data/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/latitude_bounds[] |
longitude_bounds |
path |
/data/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/longitude_bounds[] |
sensor_latitude |
path |
/data/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 |
/data/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 |
/data/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/satellite_altitude[] |
description |
the satellite altitude associated with a scanline is repeated for each pixel in the scanline |
|
sensor_orbit_phase |
path |
/data/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/satellite_orbit_phase[] |
solar_zenith_angle |
path |
/data/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/solar_zenith_angle[] |
solar_azimuth_angle |
path |
/data/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/solar_azimuth_angle[] |
sensor_zenith_angle |
path |
/data/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/viewing_zenith_angle[] |
sensor_azimuth_angle |
path |
/data/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/viewing_azimuth_angle[] |
surface_altitude |
path |
/data/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_altitude[] |
surface_altitude_uncertainty |
path |
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_altitude_precision[] |
surface_pressure |
path |
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_pressure[] |
surface_type |
path |
/data/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_classification[] |
snow_ice_type |
condition |
band=band3a or band unset |
path |
/data/PRODUCT_BAND3A/SUPPORT_DATA/INPUT_DATA/snow_ice_flag[] |
|
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 |
|
condition |
band=band3c |
|
path |
/data/PRODUCT_BAND3C/SUPPORT_DATA/INPUT_DATA/snow_ice_flag[] |
|
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 |
condition |
band=band3a or band unset |
path |
/data/PRODUCT_BAND3A/SUPPORT_DATA/INPUT_DATA/snow_ice_flag[] |
|
description |
if 1 <= snow_ice_flag <= 100 then snow_ice_flag/100.0 else 0.0 |
|
condition |
band=band3c |
|
path |
/data/PRODUCT_BAND3C/SUPPORT_DATA/INPUT_DATA/snow_ice_flag[] |
|
description |
if 1 <= snow_ice_flag <= 100 then snow_ice_flag/100.0 else 0.0 |
|
tropospheric_HCHO_column_number_density |
condition |
amf unset |
path |
data/PRODUCT/formaldehyde_tropospheric_column[] |
|
condition |
amf=clear_sky |
|
path |
data/PRODUCT/formaldehyde_tropospheric_column[], data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/formaldehyde_tropospheric_column_air_mass_factor[], data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/formaldehyde_tropospheric_column_clear_air_mass_factor[] |
|
description |
vertical_column = formaldehyde_tropospheric_column * formaldehyde_tropospheric_column_air_mass_factor / formaldehyde_tropospheric_column_clear_air_mass_factor |
|
tropospheric_HCHO_column_number_density_uncertainty_random |
condition |
amf unset |
path |
data/PRODUCT/formaldehyde_tropospheric_column_precision[] |
|
condition |
amf=clear_sky |
|
path |
data/PRODUCT/formaldehyde_tropospheric_column_precision[], data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/formaldehyde_tropospheric_column_air_mass_factor[], data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/formaldehyde_tropospheric_column_clear_air_mass_factor[] |
|
description |
uncertainty_random = formaldehyde_tropospheric_column_precision * formaldehyde_tropospheric_column_air_mass_factor / formaldehyde_tropospheric_column_clear_air_mass_factor |
|
tropospheric_HCHO_column_number_density_uncertainty_systematic |
path |
data/PRODUCT/formaldehyde_tropospheric_column_trueness[] |
tropospheric_HCHO_column_number_density_amf |
condition |
amf unset |
path |
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/formaldehyde_tropospheric_column_air_mass_factor[] |
|
condition |
amf=clear_sky |
|
path |
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/formaldehyde_tropospheric_column_clear_air_mass_factor[] |
|
description |
tropospheric clear-sky air mass factor |
|
tropospheric_HCHO_column_number_density_validity |
path |
data/PRODUCT/qa_value[] |
tropospheric_HCHO_column_number_density_amf_trueness |
path |
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/formaldehyde_tropospheric_column_air_mass_factor_trueness[] |
tropospheric_HCHO_column_number_density_avk |
path |
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/formaldehyde_tropospheric_column_averaging_kernel[] |
HCHO_slant_column_number_density |
path |
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/formaldehyde_corrected_slant_column[] |
HCHO_slant_column_number_density_uncertainty |
path |
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/formaldehyde_corrected_slant_column_trueness[] |
cloud_radiance_fraction |
path |
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_radiance_fraction[] |
HCHO_mass_mixing_ratio_apriori |
path |
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/formaldehyde_profile_apriori[] |
surface_albedo |
path |
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_albedo_342[] |
pressure_bounds |
path |
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/pressure_coefficient_a[], data/PRODUCT/SUPPORT_DATA/INPUT_DATA/pressure_coefficient_b[], data/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_pressure[] |
description |
pressure in Pa at level k is derived from surface pressure in Pa as: pressure_coefficient_a[k] + pressure_coefficient_b[k] * surface_pressure[]; the top of atmosphere pressure is clamped to 1e-3 Pa |
|
absorbing_aerosol_index |
path |
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/aerosol_index_340_380[] |
cloud_fraction |
path |
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/effective_cloud_fraction[] |
cloud_albedo |
path |
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_albedo[] |
cloud_pressure |
path |
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_pressure[] |