# S5P_L2_O3_TCL

## Variables

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

field name | type | dimensions | unit | description
--- | --- | --- | --- | ---
datetime_start | double | {time} | [seconds since 2000-01-01] | coverage start time
datetime_stop | double | {time} | [seconds since 2000-01-01] | coverage stop time
latitude | float | {latitude} | [degree_north] | grid center latitudes
longitude | float | {longitude} | [degree_east] | grid center longitudes
tropospheric_O3_column_volume_mixing_ratio_dry_air | float | {time, latitude, longitude} | [ppv] | tropospheric ozone mixing ratio
tropospheric_O3_column_volume_mixing_ratio_dry_air_uncertainty | float | {time, latitude, longitude} | [ppv] | uncertainty of the tropospheric ozone mixing ratio
tropospheric_O3_column_volume_mixing_ratio_dry_air_validity | int32 | {time, latitude, longitude} |  | validity of the tropospheric ozone mixing ratio
tropospheric_O3_column_volume_mixing_ratio_dry_air_count | int32 | {time, latitude, longitude} |  | number of data used in the tropospheric ozone mixing ratio
tropospheric_O3_column_number_density | float | {time, latitude, longitude} | [mol/m2] | average tropospheric ozone column number density
tropospheric_O3_column_number_density_uncertainty | float | {time, latitude, longitude} | [mol/m2] | uncertainty of the average tropospheric ozone column number density
stratospheric_O3_column_number_density | float | {time, latitude, longitude} | [mol/m2] | average stratospheric ozone column number density
stratospheric_O3_column_number_density_uncertainty | float | {time, latitude, longitude} | [mol/m2] | uncertainty of the average stratospheric ozone column number density
O3_column_number_density | float | {time, latitude, longitude} | [mol/m2] | average total ozone column number density
O3_column_number_density_uncertainty | float | {time, latitude, longitude} | [mol/m2] | uncertainty of the average total ozone column number density
surface_albedo | float | {time, latitude, longitude} | [] | averaged surface albedo
surface_altitude | float | {time, latitude, longitude} | [m] | averaged surface height above mean sea level
surface_pressure | float | {time, latitude, longitude} | [Pa] | surface pressure
pressure_bounds | float | {time, latitude, longitude, 2} | [Pa] | pressure range of the retrieved ozone
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_O3_TCL` products.

option name | legal values | description
--- | --- | ---
o3 | ccd, csa | whether to ingest the tropical tropospheric ozone column with the Convective Cloud Differential (CCD) method (o3=ccd, default) or with the Cloud Slicing Algorithm (CSA) (o3=csa)
o3_strat | reference | whether to ingest the ozone_stratospheric_vertical_column (default), or ozone_stratospheric_vertical_column_reference (o3_strat=reference); this option only applies if CCD data is ingested

## Mapping description

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

field name | mapping description
--- | ---
datetime_start | path | /@time_coverage_start
datetime_stop | path | /@time_coverage_end
latitude | condition | (o3=ccd or o3 unset) and processor version < 01.01.00
path | /PRODUCT/latitude[]
condition | (o3=ccd or o3 unset) and processor version >= 01.01.00
path | /PRODUCT/latitude_ccd[]
condition | o3=csa and processor version < 01.01.00
path | /PRODUCT/lat[]
condition | o3=csa and processor version >= 01.01.00
path | /PRODUCT/latitude_csa[]
longitude | condition | (o3=ccd or o3 unset) and processor version < 01.01.00
path | /PRODUCT/longitude[]
condition | (o3=ccd or o3 unset) and processor version >= 01.01.00
path | /PRODUCT/longitude_ccd[]
condition | o3=csa and processor version < 01.01.00
path | /PRODUCT/lon[]
condition | o3=csa and processor version >= 01.01.00
path | /PRODUCT/longitude_csa[]
tropospheric_O3_column_volume_mixing_ratio_dry_air | condition | o3=ccd or o3 unset
path | /PRODUCT/ozone_tropospheric_mixing_ratio[]
condition | o3=csa
path | /PRODUCT/ozone_upper_tropospheric_mixing_ratio[]
tropospheric_O3_column_volume_mixing_ratio_dry_air_uncertainty | condition | o3=ccd or o3 unset
path | /PRODUCT/ozone_tropospheric_mixing_ratio_precision[]
condition | o3=csa
path | /PRODUCT/ozone_upper_tropospheric_mixing_ratio_precision[]
tropospheric_O3_column_volume_mixing_ratio_dry_air_validity | available | optional
condition | (o3=ccd or o3 unset) and processor version >= 01.00.00
path | /PRODUCT/qa_value[]
condition | o3=csa
path | /PRODUCT/ozone_upper_tropospheric_mixing_ratio_flag[]
tropospheric_O3_column_volume_mixing_ratio_dry_air_count | available | optional
condition | o3=csa
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/number_of_observations_ozone_upper_tropospheric_mixing_ratio[]
tropospheric_O3_column_number_density | available | optional
condition | o3=ccd or o3 unset
path | /PRODUCT/ozone_tropospheric_vertical_column[]
tropospheric_O3_column_number_density_uncertainty | available | optional
condition | o3=ccd or o3 unset
path | /PRODUCT/ozone_tropospheric_vertical_column_precision[]
stratospheric_O3_column_number_density | available | optional
condition | (o3=ccd or o3 unset) and o3_strat unset
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/ozone_stratospheric_vertical_column[]
condition | (o3=ccd or o3 unset) and o3_strat=reference
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/ozone_stratospheric_vertical_column_reference[]
description | the data is replicated along the longitude axis
stratospheric_O3_column_number_density_uncertainty | available | optional
condition | (o3=ccd or o3 unset) and o3_strat unset
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/ozone_stratospheric_vertical_column_precision[]
condition | (o3=ccd or o3 unset) and o3_strat=reference
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/ozone_stratospheric_vertical_column_reference_precision[]
description | the data is replicated along the longitude axis
O3_column_number_density | available | optional
condition | o3=ccd or o3 unset
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/ozone_total_vertical_column[]
O3_column_number_density_uncertainty | available | optional
condition | o3=ccd or o3 unset
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/ozone_total_vertical_column_precision[]
surface_albedo | available | optional
condition | o3=ccd or o3 unset
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_albedo[]
surface_altitude | available | optional
condition | o3=ccd or o3 unset
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_altitude[]
surface_pressure | available | optional
condition | (o3=ccd or o3 unset) and processor version >= 02.00.00
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/surface_pressure[]
pressure_bounds | available | optional
condition | o3=csa
path | /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_top_pressure_max[], /PRODUCT/SUPPORT_DATA/DETAILED_RESULTS/cloud_top_pressure_min[]