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_uncertainty_validity | int8 | {time} | continuous quality descriptor, varying between 0 (no data) and 1 (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_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 |
| 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_altitude | float | {time} | [km] | cloud altitude |
| cloud_altitude_uncertainty | float | {time} | [km] | uncertainty of the cloud altitude |
| 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 |
| 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 | whether to ingest the SO2 column derived from the TM5 profile (default), from the 1km box profile (so2_column=1km), from the 7km box profile (so2_column=7km), or from the 15km box profile (so2_column=15km); providing this option will only work for NRTI data (otherwise an empty product is returned) |
| 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 | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_1km[] | |
| condition | so2_column=7km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_7km[] | |
| condition | so2_column=15km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_15km[] | |
| SO2_column_number_density_uncertainty_random | available | optional |
| condition | so2_column unset and NRTI | |
| path | /PRODUCT/sulfurdioxide_total_vertical_column_precision[] | |
| condition | so2_column=1km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_1km_precision[] | |
| condition | so2_column=7km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_7km_precision[] | |
| condition | so2_column=15km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_15km_precision[] | |
| SO2_column_number_density_uncertainty_systematic | available | optional |
| condition | so2_column unset and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_trueness[] | |
| condition | so2_column=1km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_1km_trueness[] | |
| condition | so2_column=7km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_7km_trueness[] | |
| condition | so2_column=15km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_vertical_column_15km_trueness[] | |
| SO2_column_number_density_uncertainty_validity | 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 | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_1km[] | |
| condition | so2_column=7km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_7km[] | |
| condition | so2_column=15km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_15km[] | |
| SO2_column_number_density_amf_uncertainty_random | available | optional |
| condition | so2_column unset and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_polluted_precision[] | |
| condition | so2_column=1km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_1km_precision[] | |
| condition | so2_column=7km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_7km_precision[] | |
| condition | so2_column=15km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_15km_precision[] | |
| SO2_column_number_density_amf_uncertainty_systematic | available | optional |
| condition | so2_column unset and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_polluted_trueness[] | |
| condition | so2_column=1km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_1km_trueness[] | |
| condition | so2_column=7km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_7km_trueness[] | |
| condition | so2_column=15km and NRTI | |
| path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/sulfurdioxide_total_air_mass_factor_15km_trueness[] | |
| SO2_column_number_density_avk | path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/averaging_kernel[] |
| SO2_volume_mixing_ratio_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[] |
| 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_altitude | path | /PRODUCT/SUPPORT_DATA/INPUT_DATA/cloud_height_crb |
| cloud_altitude_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[] |