# S5_L1B_SWR

## Variables

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

field name | type | dimensions | unit | description
--- | --- | --- | --- | ---
orbit_index | int32 |  |  | absolute orbit number
latitude | float | {time} | [degree_north] | Latitude of the center of each ground pixel on the WGS84 reference ellipsoid.
longitude | float | {time} | [degree_east] | Longitude of the center of each ground pixel on the WGS84 reference ellipsoid.
latitude_bounds | float | {time, 4} | [degree_north] | The four latitude boundaries of each ground pixel on the WGS84 reference ellipsoid.
longitude_bounds | float | {time, 4} | [degree_east] | The four longitude boundaries of each ground pixel on the WGS84 reference ellipsoid.
sensor_altitude | float | {time} | [m] | The altitude of the spacecraft relative to the WGS84 reference ellipsoid.
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.
solar_zenith_angle | float | {time} | [degree] | Zenith angle of the sun at the ground pixel location on the WGS84 reference ellipsoid.
solar_azimuth_angle | float | {time} | [degree] | Azimuth angle of the sun at the ground pixel location on the WGS84 ellipsoid.
sensor_zenith_angle | float | {time} | [degree] | Zenith angle of the spacecraft at the ground pixel location on the WGS84 reference ellipsoid.
sensor_azimuth_angle | float | {time} | [degree] | Azimuth angle of the spacecraft at the ground pixel location on the WGS84 reference ellipsoid.
validity | int16 | {time} |  | Overall quality information for a measurement.
datetime | double | {time} | [seconds since 2020-01-01] | time of the measurement
datetime_length | double |  | [s] | measurement duration
photon_radiance | float | {time, spectral} | [mol/(s.m^2.nm.sr)] | measured spectral photon radiance for each spectral channel
photon_radiance_uncertainty_systematic | float | {time, spectral} | [mol/(s.m^2.nm.sr)] | spectral radiance systematic uncertainty
photon_radiance_uncertainty_random | float | {time, spectral} | [mol/(s.m^2.nm.sr)] | spectral radiance random uncertainty
photon_radiance_validity | int8 | {time, spectral} |  | Quality assessment information for each (spectral) channel.
wavelength | float | {time, spectral} | [nm] | Wavelength [nm] derived from 3rd-order Chebyshev polynomial coefficients stored per pixel (calibrated or nominal).
wavelength_uncertainty | float | {time, spectral} | [nm] | 1-sigma uncertainty of the wavelength [nm] propagated from the 3rd-order Chebyshev coefficient errors (calibrated or nominal).
wavelength_validity | int16 | {time} |  | Spectral calibration quality assessment information for each pixel.
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_L1B_SWR` products.

option name | legal values | description
--- | --- | ---
band | 4, 5 | Choose which SWR band values to ingest: band4 (default), or band5

## Mapping description

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

field name | mapping description
--- | ---
orbit_index | path | /@orbit_start
latitude | condition | band4
path | /data/band=4 or band unset/geolocation_data/latitude[]
condition | band=5
path | /data/band=5/geolocation_data/latitude[]
longitude | condition | band4
path | /data/band=4 or band unset/geolocation_data/longitude[]
condition | band=5
path | /data/band=5/geolocation_data/longitude[]
latitude_bounds | condition | band4
path | /data/band=4 or band unset/geolocation_data/latitude_bounds[]
condition | band=5
path | /data/band=5/geolocation_data/latitude_bounds[]
longitude_bounds | condition | band4
path | /data/band=4 or band unset/geolocation_data/longitude_bounds[]
condition | band=5
path | /data/band=5/geolocation_data/longitude_bounds[]
sensor_altitude | condition | band4
path | /data/band=4 or band unset/geolocation_data/satellite_altitude[]
description | the satellite altitude associated with a scanline is repeated for each pixel in the scanline
condition | band=5
path | /data/band=5/geolocation_data/satellite_altitude[]
description | the satellite altitude associated with a scanline is repeated for each pixel in the scanline
sensor_latitude | condition | band4
path | /data/band=4 or band unset/geolocation_data/satellite_latitude[]
description | the satellite latitude associated with a scanline is repeated for each pixel in the scanline
condition | band=5
path | /data/band=5/geolocation_data/satellite_latitude[]
description | the satellite latitude associated with a scanline is repeated for each pixel in the scanline
sensor_longitude | condition | band4
path | /data/band=4 or band unset/geolocation_data/satellite_longitude[]
description | the satellite longitude associated with a scanline is repeated for each pixel in the scanline
condition | band=5
path | /data/band=5/geolocation_data/satellite_longitude[]
description | the satellite longitude associated with a scanline is repeated for each pixel in the scanline
solar_zenith_angle | condition | band4
path | /data/band=4 or band unset/geolocation_data/solar_zenith_angle[]
condition | band=5
path | /data/band=5/geolocation_data/solar_zenith_angle[]
solar_azimuth_angle | condition | band4
path | /data/band=4 or band unset/geolocation_data/solar_azimuth_angle[]
condition | band=5
path | /data/band=5/geolocation_data/solar_azimuth_angle[]
sensor_zenith_angle | condition | band4
path | /data/band=4 or band unset/geolocation_data/viewing_zenith_angle[]
condition | band=5
path | /data/band=5/geolocation_data/viewing_zenith_angle[]
sensor_azimuth_angle | condition | band4
path | /data/band=4 or band unset/geolocation_data/viewing_azimuth_angle[]
condition | band=5
path | /data/band=5/geolocation_data/viewing_azimuth_angle[]
validity | condition | band4
path | /data/band=4 or band unset/observation_data/measurement_quality[]
description | the measurement quality associated with a scanline is repeated for each pixel in the scanline
condition | band=5
path | /data/band=5/observation_data/measurement_quality[]
description | the measurement quality associated with a scanline is repeated for each pixel in the scanline
datetime | condition | band4
path | /data/band=4 or band unset/observation_data/time, /data/band=4 or band unset/observation_data/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
condition | band=5
path | /data/band=5/observation_data/time, /data/band=5/observation_data/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 | condition | band4
path | /data/band=4 or band unset/delta_time/time, /data/band=4 or band unset/delta_time/delta_time[]
description | delta_time[1] - delta_time[0]
condition | band=5
path | /data/band=5/delta_time/time, /data/band=5/delta_time/delta_time[]
description | delta_time[1] - delta_time[0]
photon_radiance | condition | band4
path | /data/band=4 or band unset/observation_data/radiance[]
condition | band=5
path | /data/band=5/observation_data/radiance[]
photon_radiance_uncertainty_systematic | condition | band4
path | /data/band=4 or band unset/observation_data/radiance_error[]
description | uncertainty = abs(radiance / exp(radiance_error / 20))
condition | band=5
path | /data/band=5/observation_data/radiance_error[]
description | uncertainty = abs(radiance / exp(radiance_error / 20))
photon_radiance_uncertainty_random | condition | band4
path | /data/band=4 or band unset/observation_data/radiance_noise[]
description | uncertainty = abs(radiance / exp(radiance_noise / 20))
condition | band=5
path | /data/band=5/observation_data/radiance_noise[]
description | uncertainty = abs(radiance / exp(radiance_noise / 20))
photon_radiance_validity | condition | band4
path | /data/band=4 or band unset/observation_data/spectral_channel_quality[]
condition | band=5
path | /data/band=5/observation_data/spectral_channel_quality[]
wavelength | condition | band4
path | /data/band=4 or band unset/instrument_data/nominal_wavelength_coefficients[]
condition | band=5
path | /data/band=5/instrument_data/nominal_wavelength_coefficients[]
condition | band4,lambda=calibrated or lambda unset
path | /data/band=4 or band unset/instrument_data/calibrated_wavelength_coefficients[]
condition | band4,lambda=nominal
path | /data/band=4 or band unset/instrument_data/nominal_wavelength_coefficients[]
condition | band=5,lambda=calibrated or lambda unset
path | /data/band=5/instrument_data/calibrated_wavelength_coefficients[]
condition | band=5,lambda=nominal
path | /data/band=5/instrument_data/nominal_wavelength_coefficients[]
wavelength_uncertainty | condition | band4,lambda=calibrated or lambda unset
path | /data/band=4 or band unset/instrument_data/calibrated_wavelength_coefficients_error[]
condition | band4,lambda=nominal
path | /data/band=4 or band unset/instrument_data/nominal_wavelength_coefficients_error[]
condition | band=5,lambda=calibrated or lambda unset
path | /data/band=5/instrument_data/calibrated_wavelength_coefficients_error[]
condition | band=5,lambda=nominal
path | /data/band=5/instrument_data/nominal_wavelength_coefficients_error[]
wavelength_validity | condition | band4
path | /data/band=4 or band unset/instrument_data/spectral_calibration_quality[]
condition | band=5
path | /data/band=5/instrument_data/spectral_calibration_quality[]