S5_L2_SO2
Variables
The table below lists the variables that are present in the HARP product that results from an ingestion of S5_L2_SO2 data.
field name  | 
type  | 
dimensions  | 
unit  | 
description  | 
|---|---|---|---|---|
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 WGS84 ellipsoid averaged over the S5 pixel  | 
surface_altitude_uncertainty  | 
float  | 
{time}  | 
[m]  | 
standard deviation of the height of the surface above WGS84 ellipsoid 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)  | 
SO2_column_number_density  | 
float  | 
{time}  | 
[mol/m^2]  | 
SO2 vertical column density  | 
SO2_column_number_density_uncertainty_random  | 
float  | 
{time}  | 
[mol/m^2]  | 
random uncertainty of SO2 column density  | 
SO2_column_number_density_uncertainty_systematic  | 
float  | 
{time}  | 
[mol/m^2]  | 
systematic uncertainty of SO2 column density  | 
SO2_layer_height  | 
float  | 
{time}  | 
[m]  | 
retrieved layer height of SO2 above sea level  | 
SO2_layer_height_uncertainty  | 
float  | 
{time}  | 
[m]  | 
uncertainty of the retrieved SO2 layer height  | 
SO2_layer_height_validity  | 
int8  | 
{time}  | 
flag associated with SO2 layer-height retrieval quality  | 
|
SO2_column_number_density_validity  | 
int8  | 
{time}  | 
quality-assurance value describing the quality of the product  | 
|
SO2_column_number_density_amf  | 
float  | 
{time}  | 
[]  | 
total air-mass factor of the SO2 column  | 
SO2_column_number_density_amf_uncertainty_random  | 
float  | 
{time}  | 
[]  | 
random uncertainty of SO2 air-mass factor  | 
SO2_column_number_density_amf_uncertainty_systematic  | 
float  | 
{time}  | 
[]  | 
systematic uncertainty of SO2 air-mass factor  | 
SO2_slant_column_number_density  | 
float  | 
{time}  | 
[mol/m^2]  | 
SO2 slant column density  | 
SO2_slant_column_number_density_uncertainty_random  | 
float  | 
{time}  | 
[mol/m^2]  | 
random component of the uncertainty of the SO2 slant column density  | 
SO2_slant_column_number_density_uncertainty_systematic  | 
float  | 
{time}  | 
[mol/m^2]  | 
systematic component of the uncertainty of the SO2 slant column density  | 
cloud_fraction  | 
float  | 
{time}  | 
[]  | 
cloud radiance fraction  | 
SO2_column_number_density_avk  | 
float  | 
{time, vertical}  | 
[]  | 
averaging kernel for the SO2 total column  | 
SO2_layer_pressure  | 
float  | 
{time}  | 
[Pa]  | 
retrieved layer pressure of SO2  | 
SO2_layer_pressure_uncertainty  | 
float  | 
{time}  | 
[Pa]  | 
total error on retrieved layer pressure of SO2  | 
surface_albedo  | 
float  | 
{time}  | 
[]  | 
surface albedo at 340 nm  | 
SO2_column_number_density_apriori  | 
float  | 
{time, vertical}  | 
[mol/m^2]  | 
a priori SO2 profile (CAMS)  | 
pressure_bounds  | 
double  | 
{time, vertical, 2}  | 
[Pa]  | 
pressure boundaries  | 
cloud_pressure  | 
float  | 
{time}  | 
[Pa]  | 
Cloud top pressure  | 
cloud_height  | 
float  | 
{time}  | 
[m]  | 
cloud centre height above the surface  | 
cloud_albedo  | 
float  | 
{time}  | 
[]  | 
cloud albedo  | 
absorbing_aerosol_index  | 
float  | 
{time}  | 
[]  | 
aerosol absorbing index 340/380 pair  | 
O3_column_number_density  | 
float  | 
{time}  | 
[mol/m^2]  | 
O3 total column  | 
scene_albedo  | 
float  | 
{time}  | 
[]  | 
effective scene albedo at 340 nm  | 
scene_pressure  | 
float  | 
{time}  | 
[Pa]  | 
effective scene pressure at 340 nm  | 
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_SO2 products.
option name  | 
legal values  | 
description  | 
|---|---|---|
so2_column  | 
1km, 7km, 15km  | 
select the SO2 column from the 1 km, 7 km, or 15 km box profile; if the option is omitted the polluted-boundary-layer column (PBL) is ingested  | 
Mapping description
The table below details where and how each variable was retrieved from the input product.
field name  | 
mapping description  | 
|
|---|---|---|
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  | 
|
SO2_column_number_density  | 
path  | 
/data/PRODUCT/sulfur_dioxide_total_column[]  | 
description  | 
profile dimension sliced according to so2_column option  | 
|
SO2_column_number_density_uncertainty_random  | 
path  | 
/data/PRODUCT/sulfur_dioxide_total_column_precision[]  | 
description  | 
profile dimension sliced according to so2_column option  | 
|
SO2_column_number_density_uncertainty_systematic  | 
path  | 
/data/PRODUCT/sulfur_dioxide_total_column_trueness[]  | 
description  | 
profile dimension sliced according to so2_column option  | 
|
SO2_layer_height  | 
path  | 
data/PRODUCT/sulfur_dioxide_layer_height[]  | 
SO2_layer_height_uncertainty  | 
path  | 
data/PRODUCT/sulfur_dioxide_layer_height_uncertainty[]  | 
SO2_layer_height_validity  | 
path  | 
data/PRODUCT/sulfur_dioxide_layer_height_flag[]  | 
SO2_column_number_density_validity  | 
path  | 
data/PRODUCT/qa_value[]  | 
SO2_column_number_density_amf  | 
path  | 
/data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfur_dioxide_total_column_air_mass_factor[]  | 
description  | 
profile dimension sliced according to so2_column option  | 
|
SO2_column_number_density_amf_uncertainty_random  | 
path  | 
/data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfur_dioxide_total_column_air_mass_factor_precision[]  | 
description  | 
profile dimension sliced according to so2_column option  | 
|
SO2_column_number_density_amf_uncertainty_systematic  | 
path  | 
/data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfur_dioxide_total_column_air_mass_factor_trueness[]  | 
description  | 
profile dimension sliced according to so2_column option  | 
|
SO2_slant_column_number_density  | 
path  | 
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfur_dioxide_slant_column_corrected[]  | 
SO2_slant_column_number_density_uncertainty_random  | 
path  | 
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfur_dioxide_slant_column_precision[]  | 
SO2_slant_column_number_density_uncertainty_systematic  | 
path  | 
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfur_dioxide_slant_column_trueness[]  | 
cloud_fraction  | 
path  | 
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_radiance_fraction[]  | 
SO2_column_number_density_avk  | 
path  | 
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfur_dioxide_total_column_averaging_kernel[]  | 
description  | 
the vertical grid is inverted to make it ascending  | 
|
SO2_layer_pressure  | 
path  | 
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfur_dioxide_layer_pressure[]  | 
SO2_layer_pressure_uncertainty  | 
path  | 
data/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfur_dioxide_layer_pressure_uncertainty[]  | 
surface_albedo  | 
path  | 
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_albedo[]  | 
SO2_column_number_density_apriori  | 
path  | 
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/sulfur_dioxide_profile_apriori[]  | 
description  | 
the vertical grid is inverted to make it ascending  | 
|
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  | 
|
cloud_pressure  | 
path  | 
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_pressure[]  | 
cloud_height  | 
path  | 
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_height[]  | 
cloud_albedo  | 
path  | 
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_albedo[]  | 
absorbing_aerosol_index  | 
path  | 
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/aerosol_index_340_380[]  | 
O3_column_number_density  | 
path  | 
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/ozone_total_column  | 
scene_albedo  | 
path  | 
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/scene_albedo[]  | 
scene_pressure  | 
path  | 
data/PRODUCT/SUPPORT_DATA/INPUT_DATA/scene_pressure[]  |