S5P_L2_SO2

Variables

The table below lists the variables that are present in the HARP product that results from an ingestion of S5P_L2_SO2 data.

field name

type

dimensions

unit

description

scan_subindex

int16

{time}

pixel index (0-based) within the scanline

datetime_start

double

{time}

[seconds since 2010-01-01]

start time of the measurement

datetime_length

double

[s]

duration of the measurement

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]

latitudes of the ground pixel corners (WGS84)

longitude_bounds

float

{time, 4}

[degree_east]

longitudes of the ground pixel corners (WGS84)

sensor_latitude

float

{time}

[degree_north]

latitude of the geodetic sub-satellite point (WGS84)

sensor_longitude

float

{time}

[degree_east]

longitude of the goedetic sub-satellite point (WGS84)

sensor_altitude

float

{time}

[m]

altitude of the satellite with respect to the geodetic sub-satellite point (WGS84)

solar_zenith_angle

float

{time}

[degree]

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

solar_azimuth_angle

float

{time}

[degree]

azimuth angle of the Sun at the ground pixel location (WGS84); angle measured East-of-North

sensor_zenith_angle

float

{time}

[degree]

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

sensor_azimuth_angle

float

{time}

[degree]

azimuth angle of the satellite at the ground pixel location (WGS84); angle measured East-of-North

pressure

double

{time, vertical}

[Pa]

pressure

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 component of the uncertainty of the SO2 vertical column density

SO2_column_number_density_uncertainty_systematic

float

{time}

[mol/m^2]

systematic component of the uncertainty of the SO2 vertical column density

SO2_column_number_density_validity

int8

{time}

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

SO2_column_number_density_amf

float

{time}

[]

total air mass factor

SO2_column_number_density_amf_uncertainty_random

float

{time}

[]

random component of the uncertainty of the total air mass factor

SO2_column_number_density_amf_uncertainty_systematic

float

{time}

[]

systematic component of the uncertainty of the total air mass factor

SO2_column_number_density_avk

float

{time, vertical}

[]

averaging kernel for the SO2 vertical column density

SO2_volume_mixing_ratio_dry_air_apriori

float

{time, vertical}

[ppv]

SO2 apriori profile in volume mixing ratios

SO2_slant_column_number_density

float

{time}

[mol/m^2]

SO2 slant column density

SO2_type

int8

{time}

type of SO2 detected; enumeration values: no_detection (0), so2_detected (1), volcanic_detection (2), detection_near_anthropogenic_source (3), detection_at_high_sza (4)

SO2_layer_height

float

{time}

[m]

SO2 layer height

SO2_layer_height_uncertainty

float

{time}

[m]

SO2 layer height uncertainty

SO2_layer_height_validity

int8

{time}

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

SO2_layer_pressure

float

{time}

[Pa]

SO2 layer pressure

O3_column_number_density

float

{time}

[mol/m^2]

O3 vertical column density

O3_column_number_density_uncertainty

float

{time}

[mol/m^2]

random component of the uncertainty of the O3 vertical column density

absorbing_aerosol_index

float

{time}

[]

aerosol index

cloud_albedo

float

{time}

[]

cloud albedo

cloud_albedo_uncertainty

float

{time}

[]

uncertainty of the cloud albedo

cloud_fraction

float

{time}

[]

cloud fraction

cloud_fraction_uncertainty

float

{time}

[]

uncertainty of the cloud fraction

cloud_height

float

{time}

[km]

cloud height

cloud_height_uncertainty

float

{time}

[km]

uncertainty of the cloud height

cloud_pressure

float

{time}

[Pa]

cloud pressure

cloud_pressure_uncertainty

float

{time}

[Pa]

uncertainty of the cloud pressure

surface_albedo

float

{time}

[]

surface albedo

surface_altitude

float

{time}

[m]

surface altitude

surface_altitude_uncertainty

float

{time}

[m]

surface altitude precision

surface_pressure

float

{time}

[Pa]

surface pressure

surface_meridional_wind_velocity

float

{time}

[m/s]

northward wind

surface_zonal_wind_velocity

float

{time}

[m/s]

eastward wind

tropopause_pressure

double

{time}

[Pa]

tropopause 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 S5P_L2_SO2 products.

option name

legal values

description

so2_column

1km, 7km, 15km, lh

whether to ingest the anothropogenic SO2 column at the PBL (default), the SO2 column from the 1km box profile (so2_column=1km), from the 7km box profile (so2_column=7km), from the 15km box profile (so2_column=15km), or the SO2 column consistent with the SO2 layer height (so2_column=lh); providing this option will only work for NRTI data or for OFFL data with processor version >= 01.01.01 (otherwise an empty product is returned); layer height data is only available for processor version >= 02.05.00

cloud_fraction

radiance

whether to ingest the cloud fraction (default) or the radiance cloud fraction (cloud_fraction=radiance)

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_start

path

/PRODUCT/time, /PRODUCT/delta_time[]

description

time converted from milliseconds since a reference time (given as seconds since 2010-01-01) to seconds since 2010-01-01 (using 86400 seconds per day)

datetime_length

path

/@time_coverage_resolution

description

the measurement length is parsed assuming the ISO 8601 ‘PT%(interval_seconds)fS’ format

orbit_index

path

/@orbit

validity

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/processing_quality_flags[]

description

the uint32 data is cast to int32

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

sensor_latitude

path

/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

/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

/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/satellite_altitude[]

description

the satellite altitude associated with a scanline is repeated for each pixel in the scanline

solar_zenith_angle

path

/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/solar_zenith_angle[]

solar_azimuth_angle

path

/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/solar_azimuth_angle[]

sensor_zenith_angle

path

/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/viewing_zenith_angle[]

sensor_azimuth_angle

path

/PRODUCT/SUPPORT_DATA/GEOLOCATIONS/viewing_azimuth_angle[]

pressure

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/tm5_constant_a[], /PRODUCT/SUPPORT_DATA/INPUT_DATA/tm5_constant_b[], /PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_pressure[]

description

pressure in Pa at layer k is derived from surface pressure in Pa as: tm5_constant_a[k] + tm5_constant_b[k] * surface_pressure[]

SO2_column_number_density

condition

so2_column unset

path

/PRODUCT/sulfurdioxide_total_vertical_column[]

condition

so2_column=1km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_1km[]

condition

so2_column=7km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_7km[]

condition

so2_column=15km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_15km[]

condition

so2_column=lh and processor version >= 02.05.00

path

/PRODUCT/SO2_LAYER_HEIGHT/sulfurdioxide_total_vertical_column_layer_height[]

SO2_column_number_density_uncertainty_random

condition

so2_column unset

path

/PRODUCT/sulfurdioxide_total_vertical_column_precision[]

condition

so2_column=1km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_1km_precision[]

condition

so2_column=7km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_7km_precision[]

condition

so2_column=15km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_15km_precision[]

condition

so2_column=lh and processor version >= 02.05.00

path

/PRODUCT/SO2_LAYER_HEIGHT/sulfurdioxide_total_vertical_column_layer_height_precision[]

SO2_column_number_density_uncertainty_systematic

available

optional

condition

so2_column unset and (NRTI or processor version >= 01.00.00)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_trueness[]

condition

so2_column=1km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_1km_trueness[]

condition

so2_column=7km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_7km_trueness[]

condition

so2_column=15km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_15km_trueness[]

condition

so2_column=lh and processor version >= 02.05.00

path

/PRODUCT/SO2_LAYER_HEIGHT/sulfurdioxide_total_vertical_column_layer_height_trueness[]

SO2_column_number_density_validity

available

optional

condition

so2_column!=lh

path

/PRODUCT/qa_value

SO2_column_number_density_amf

condition

so2_column unset

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_polluted[]

condition

so2_column=1km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_1km[]

condition

so2_column=7km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_7km[]

condition

so2_column=15km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_15km[]

condition

so2_column=lh and processor version >= 02.05.00

path

/PRODUCT/SO2_LAYER_HEIGHT/sulfurdioxide_total_air_mass_factor_layer_height[]

SO2_column_number_density_amf_uncertainty_random

available

optional

condition

so2_column unset and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_polluted_precision[]

condition

so2_column=1km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_1km_precision[]

condition

so2_column=7km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_7km_precision[]

condition

so2_column=15km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_15km_precision[]

condition

so2_column=lh and processor version >= 02.05.00

path

/PRODUCT/SO2_LAYER_HEIGHT/sulfurdioxide_total_air_mass_factor_layer_height_precision[]

SO2_column_number_density_amf_uncertainty_systematic

available

optional

condition

so2_column unset and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_polluted_trueness[]

condition

so2_column=1km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_1km_trueness[]

condition

so2_column=7km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_7km_trueness[]

condition

so2_column=15km and (NRTI or processor version >= 01.01.01)

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_15km_trueness[]

condition

so2_column=lh and processor version >= 02.05.00

path

/PRODUCT/SO2_LAYER_HEIGHT/sulfurdioxide_total_air_mass_factor_layer_height_trueness[]

SO2_column_number_density_avk

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/averaging_kernel[]

condition

so2_column=1km

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/averaging_kernel[], /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_averaging_kernel_scaling_box_1km[]

description

the averaging kernel is multiplied by the scaling factor

condition

so2_column=7km

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/averaging_kernel[], /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_averaging_kernel_scaling_box_7km[]

description

the averaging kernel is multiplied by the scaling factor

condition

so2_column=15km

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/averaging_kernel[], /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_averaging_kernel_scaling_box_15km[]

description

the averaging kernel is multiplied by the scaling factor

condition

so2_column=lh and processor version >= 02.05.00

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/averaging_kernel[], /PRODUCT/SO2_LAYER_HEIGHT/sulfurdioxide_averaging_kernel_scaling_box_layer_height[]

description

the averaging kernel is multiplied by the scaling factor

SO2_volume_mixing_ratio_dry_air_apriori

available

optional

condition

so2_column unset

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_profile_apriori[]

SO2_slant_column_number_density

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_slant_column_corrected[]

SO2_type

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_detection_flag[]

SO2_layer_height

available

optional

condition

processor version >= 02.05.00

path

/PRODUCT/SO2_LAYER_HEIGHT/sulfurdioxide_layer_height[]

SO2_layer_height_uncertainty

available

optional

condition

processor version >= 02.05.00

path

/PRODUCT/SO2_LAYER_HEIGHT/sulfurdioxide_layer_height_precision[]

SO2_layer_height_validity

available

optional

condition

processor version >= 02.05.00

path

/PRODUCT/SO2_LAYER_HEIGHT/qa_value_layer_height

SO2_layer_pressure

available

optional

condition

processor version >= 02.05.00

path

/PRODUCT/SO2_LAYER_HEIGHT/sulfurdioxide_layer_pressure[]

O3_column_number_density

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/ozone_total_vertical_column[]

O3_column_number_density_uncertainty

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/ozone_total_vertical_column_precision[]

absorbing_aerosol_index

available

optional

condition

OFFL

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/aerosol_index_340_380

cloud_albedo

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_albedo_crb

cloud_albedo_uncertainty

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_albedo_crb_precision

cloud_fraction

condition

cloud_fraction unset

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_fraction_crb[]

condition

cloud_fraction=radiance

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_intensity_weighted[]

cloud_fraction_uncertainty

condition

cloud_fraction unset

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_fraction_crb_precision[]

condition

cloud_fraction=radiance

path

/PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_fraction_intensity_weighted_precision[]

cloud_height

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_height_crb

cloud_height_uncertainty

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_height_crb_precision

cloud_pressure

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_pressure_crb

cloud_pressure_uncertainty

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_pressure_crb_precision

surface_albedo

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_albedo_328nm, /PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_albedo_376nm, /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/selected_fitting_window_flag

description

if selected_fitting_window_flag is 1 or 2 then use surface_albedo_328, if selected_fitting_window_flag is 3 then use surface_albedo_376, else set to NaN

surface_altitude

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_altitude[]

surface_altitude_uncertainty

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_altitude_precision[]

surface_pressure

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_pressure[]

surface_meridional_wind_velocity

available

optional

condition

processor version >= 02.00.00

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/northward_wind[]

surface_zonal_wind_velocity

available

optional

condition

processor version >= 02.00.00

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/eastward_wind[]

tropopause_pressure

available

optional

condition

processor version >= 02.00.00

path

/PRODUCT/SUPPORT_DATA/INPUT_DATA/tm5_constant_a[], /PRODUCT/SUPPORT_DATA/INPUT_DATA/tm5_constant_b[], /PRODUCT/SUPPORT_DATA/INPUT_DATA/tm5_tropopause_layer_index[], /PRODUCT/SUPPORT_DATA/INPUT_DATA/surface_pressure[]

description

pressure in Pa at tropause is derived from the upper bound of the layer with tropopause layer index k: exp((log(tm5_constant_a[k] + tm5_constant_b[k] * surface_pressure[]) + log(tm5_constant_a[k + 1] + tm5_constant_b[k + 1] * surface_pressure[]))/2.0)