# GEOMS-TE-UVVIS-DOAS-DIRECTSUN-GAS-005-SO2

## Variables

The table below lists the variables that are present in the HARP product that results from an ingestion of `GEOMS-TE-UVVIS-DOAS-DIRECTSUN-GAS-005-SO2` data.

field name | type | dimensions | unit | description
--- | --- | --- | --- | ---
sensor_name | string |  |  | name of the sensor
location_name | string |  |  | name of the site at which the sensor is located
datetime | double | {time} | [days since 2000-01-01] | mean time of the measurement
datetime_start | double | {time} | [days since 2000-01-01] | start time of the measurement
datetime_stop | double | {time} | [days since 2000-01-01] | stop time of the measurement
sensor_latitude | double |  | [degree_north] | latitude of the sensor
sensor_longitude | double |  | [degree_east] | longitude of the sensor
sensor_altitude | double |  | [m] | altitude of the sensor relative to the location site
altitude | double | {time, vertical} | [km] | effective retrieval altitude
pressure | double | {time, vertical} | [hPa] | independent pressure profile
temperature | double | {time, vertical} | [K] | independent temperature profile
altitude_bounds | double | {time, vertical, 2} | [km] | lower and upper boundaries of the height layers
solar_zenith_angle | double | {time} | [degree] | solar astronomical zenith angle
solar_azimuth_angle | double | {time} | [degree] | solar azimuth angle
viewing_azimuth_angle | double | {time} | [degree] | viewing azimuth angle of the sensor
viewing_zenith_angle | double | {time} | [degree] | viewing zenith angle of the sensor
latitude | double | {time, vertical} | [degree_north] | latitude of effective air mass at each altitude
longitude | double | {time, vertical} | [degree_east] | longitude of effective air mass at each altitude
aerosol_optical_depth | double | {time} | [] | aerosol optical depth used for the retrieval
SO2_column_number_density | double | {time} | [Pmolec cm-2] | SO2 column number density
SO2_column_number_density_uncertainty_random | double | {time} | [Pmolec cm-2] | random uncertainty of the SO2 column number density
SO2_column_number_density_uncertainty_systematic | double | {time} | [Pmolec cm-2] | systematic uncertainty of the SO2 column number density
SO2_column_number_density_apriori | double | {time, vertical} | [Pmolec cm-2] | a priori SO2 column number density
SO2_column_number_density_avk | double | {time, vertical} | [] | averaging kernel for the SO2 column number density
index | int32 | {time} |  | zero-based index of the sample within the source product

## Ingestion options

The table below lists the available ingestion options for `GEOMS-TE-UVVIS-DOAS-DIRECTSUN` products.

option name | legal values | description
--- | --- | ---
AOD | measured | ingest the modeled (default) or measured (AOD=measured) aerosol optical depth properties

## Mapping description

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

field name | mapping description
--- | ---
sensor_name | path | /@DATA.SOURCE
location_name | path | /@DATA.LOCATION
datetime | path | /DATETIME
datetime_start | path | /DATETIME.START
datetime_stop | path | /DATETIME.STOP
sensor_latitude | path | /LATITUDE.INSTRUMENT
sensor_longitude | path | /LONGITUDE.INSTRUMENT
sensor_altitude | path | /ALTITUDE.INSTRUMENT
altitude | path | /ALTITUDE
pressure | path | /PRESSURE_INDEPENDENT
temperature | path | /TEMPERATURE_INDEPENDENT
altitude_bounds | path | /ALTITUDE.BOUNDARIES
solar_zenith_angle | path | /ANGLE.SOLAR_ZENITH.ASTRONOMICAL
solar_azimuth_angle | path | /ANGLE.SOLAR_AZIMUTH
viewing_azimuth_angle | path | /ANGLE.VIEW_AZIMUTH
viewing_zenith_angle | path | /ANGLE.VIEW_ZENITH
latitude | available | optional
path | /LATITUDE
longitude | available | optional
path | /LONGITUDE
aerosol_optical_depth | available | optional
condition | AOD=modeled or AOD unset
path | /AEROSOL.OPTICAL.DEPTH_INDEPENDENT
condition | AOD=measured
path | /AEROSOL.OPTICAL.DEPTH_ABSORPTION.SOLAR
SO2_column_number_density | path | /SO2.COLUMN.ABSORPTION.SOLAR
SO2_column_number_density_uncertainty_random | path | /SO2.COLUMN.ABSORPTION.SOLAR_UNCERTAINTY.RANDOM.STANDARD
SO2_column_number_density_uncertainty_systematic | path | /SO2.COLUMN.ABSORPTION.SOLAR_UNCERTAINTY.SYSTEMATIC.STANDARD
SO2_column_number_density_apriori | path | /SO2.COLUMN.PARTIAL_ABSORPTION.SOLAR_APRIORI
SO2_column_number_density_avk | path | /SO2.COLUMN_ABSORPTION.SOLAR_AVK