# S5_L1B_IRR

## Variables

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

field name | type | dimensions | unit | description
--- | --- | --- | --- | ---
orbit_index | int32 |  |  | absolute orbit number
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.
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_irradiance | float | {time, spectral} | [mol/(s.m^2.nm)] | Measured spectral photon irradiance for each spectral channel and cross track position.
photon_irradiance_uncertainty_systematic | float | {time, spectral} | [mol/(s.m^2.nm)] | spectral irradiance systematic uncertainty
photon_irradiance_uncertainty_random | float | {time, spectral} | [mol/(s.m^2.nm.sr)] | spectral irradiance random uncertainty
photon_irradiance_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_IRR` products.

option name | legal values | description
--- | --- | ---
band | 1a, 1b, 2, 3a, 3b, 3c, 4, 5 | Choose which IRR band values to ingest: band1a (default), band1b, band2, band3a, band3b, band3c, band4, 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
sensor_altitude | condition | band=1a or band unset
path | /data/band1a/geolocation_data/satellite_altitude[]
description | the satellite altitude associated with a scanline is repeated for each pixel in the scanline
condition | band=1b
path | /data/band1b/geolocation_data/satellite_altitude[]
description | the satellite altitude associated with a scanline is repeated for each pixel in the scanline
condition | band=2
path | /data/band2/geolocation_data/satellite_altitude[]
description | the satellite altitude associated with a scanline is repeated for each pixel in the scanline
condition | band=3a
path | /data/band3a/geolocation_data/satellite_altitude[]
description | the satellite altitude associated with a scanline is repeated for each pixel in the scanline
condition | band=3b
path | /data/band3b/geolocation_data/satellite_altitude[]
description | the satellite altitude associated with a scanline is repeated for each pixel in the scanline
condition | band=3c
path | /data/band3c/geolocation_data/satellite_altitude[]
description | the satellite altitude associated with a scanline is repeated for each pixel in the scanline
condition | band=4
path | /data/band4/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/band5/geolocation_data/satellite_altitude[]
description | the satellite altitude associated with a scanline is repeated for each pixel in the scanline
sensor_latitude | condition | band=1a or band unset
path | /data/band1a/geolocation_data/satellite_latitude[]
description | the satellite latitude associated with a scanline is repeated for each pixel in the scanline
condition | band=1b
path | /data/band1b/geolocation_data/satellite_latitude[]
description | the satellite latitude associated with a scanline is repeated for each pixel in the scanline
condition | band=2
path | /data/band2/geolocation_data/satellite_latitude[]
description | the satellite latitude associated with a scanline is repeated for each pixel in the scanline
condition | band=3a
path | /data/band3a/geolocation_data/satellite_latitude[]
description | the satellite latitude associated with a scanline is repeated for each pixel in the scanline
condition | band=3b
path | /data/band3b/geolocation_data/satellite_latitude[]
description | the satellite latitude associated with a scanline is repeated for each pixel in the scanline
condition | band=3c
path | /data/band3c/geolocation_data/satellite_latitude[]
description | the satellite latitude associated with a scanline is repeated for each pixel in the scanline
condition | band=4
path | /data/band4/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/band5/geolocation_data/satellite_latitude[]
description | the satellite latitude associated with a scanline is repeated for each pixel in the scanline
sensor_longitude | condition | band=1a or band unset
path | /data/band1a/geolocation_data/satellite_longitude[]
description | the satellite longitude associated with a scanline is repeated for each pixel in the scanline
condition | band=1b
path | /data/band1b/geolocation_data/satellite_longitude[]
description | the satellite longitude associated with a scanline is repeated for each pixel in the scanline
condition | band=2
path | /data/band2/geolocation_data/satellite_longitude[]
description | the satellite longitude associated with a scanline is repeated for each pixel in the scanline
condition | band=3a
path | /data/band3a/geolocation_data/satellite_longitude[]
description | the satellite longitude associated with a scanline is repeated for each pixel in the scanline
condition | band=3b
path | /data/band3b/geolocation_data/satellite_longitude[]
description | the satellite longitude associated with a scanline is repeated for each pixel in the scanline
condition | band=3c
path | /data/band3c/geolocation_data/satellite_longitude[]
description | the satellite longitude associated with a scanline is repeated for each pixel in the scanline
condition | band=4
path | /data/band4/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/band5/geolocation_data/satellite_longitude[]
description | the satellite longitude associated with a scanline is repeated for each pixel in the scanline
validity | condition | band=1a or band unset
path | /data/band1a/observation_data/measurement_quality[]
description | the measurement quality associated with a scanline is repeated for each pixel in the scanline
condition | band=1b
path | /data/band1b/observation_data/measurement_quality[]
description | the measurement quality associated with a scanline is repeated for each pixel in the scanline
condition | band=2
path | /data/band2/observation_data/measurement_quality[]
description | the measurement quality associated with a scanline is repeated for each pixel in the scanline
condition | band=3a
path | /data/band3a/observation_data/measurement_quality[]
description | the measurement quality associated with a scanline is repeated for each pixel in the scanline
condition | band=3b
path | /data/band3b/observation_data/measurement_quality[]
description | the measurement quality associated with a scanline is repeated for each pixel in the scanline
condition | band=3c
path | /data/band3c/observation_data/measurement_quality[]
description | the measurement quality associated with a scanline is repeated for each pixel in the scanline
condition | band=4
path | /data/band4/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/band5/observation_data/measurement_quality[]
description | the measurement quality associated with a scanline is repeated for each pixel in the scanline
datetime | condition | band=1a or band unset
path | /data/band1a/observation_data/time, /data/band1a/observation_data/delta_time[]
description | time converted from days since 20200-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=1b
path | /data/band1b/observation_data/time, /data/band1b/observation_data/delta_time[]
description | time converted from days since 20200-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=2
path | /data/band2/observation_data/time, /data/band2/observation_data/delta_time[]
description | time converted from days since 20200-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=3a
path | /data/band3a/observation_data/time, /data/band3a/observation_data/delta_time[]
description | time converted from days since 20200-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=3b
path | /data/band3b/observation_data/time, /data/band3b/observation_data/delta_time[]
description | time converted from days since 20200-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=3c
path | /data/band3c/observation_data/time, /data/band3c/observation_data/delta_time[]
description | time converted from days since 20200-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=4
path | /data/band4/observation_data/time, /data/band4/observation_data/delta_time[]
description | time converted from days since 20200-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/band5/observation_data/time, /data/band5/observation_data/delta_time[]
description | time converted from days since 20200-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 | band=1a or band unset
path | /data/band1a/delta_time/time, /data/band1a/delta_time/delta_time[]
description | delta_time[1] - delta_time[0]
condition | band=1b
path | /data/band1b/delta_time/time, /data/band1b/delta_time/delta_time[]
description | delta_time[1] - delta_time[0]
condition | band=2
path | /data/band2/delta_time/time, /data/band2/delta_time/delta_time[]
description | delta_time[1] - delta_time[0]
condition | band=3a
path | /data/band3a/delta_time/time, /data/band3a/delta_time/delta_time[]
description | delta_time[1] - delta_time[0]
condition | band=3b
path | /data/band3b/delta_time/time, /data/band3b/delta_time/delta_time[]
description | delta_time[1] - delta_time[0]
condition | band=3c
path | /data/band3c/delta_time/time, /data/band3c/delta_time/delta_time[]
description | delta_time[1] - delta_time[0]
condition | band=4
path | /data/band4/delta_time/time, /data/band4/delta_time/delta_time[]
description | delta_time[1] - delta_time[0]
condition | band=5
path | /data/band5/delta_time/time, /data/band5/delta_time/delta_time[]
description | delta_time[1] - delta_time[0]
photon_irradiance | condition | band=1a or band unset
path | /data/band1a/observation_data/irradiance[]
condition | band=1b
path | /data/band1b/observation_data/irradiance[]
condition | band=2
path | /data/band2/observation_data/irradiance[]
condition | band=3a
path | /data/band3a/observation_data/irradiance[]
condition | band=3b
path | /data/band3b/observation_data/irradiance[]
condition | band=3c
path | /data/band3c/observation_data/irradiance[]
condition | band=4
path | /data/band4/observation_data/irradiance[]
condition | band=5
path | /data/band5/observation_data/irradiance[]
photon_irradiance_uncertainty_systematic | condition | band=1a or band unset
path | /data/band1a/observation_data/irradiance_error[]
description | uncertainty = abs(irradiance / exp(irradiance_error / 20))
condition | band=1b
path | /data/band1b/observation_data/irradiance_error[]
description | uncertainty = abs(irradiance / exp(irradiance_error / 20))
condition | band=2
path | /data/band2/observation_data/irradiance_error[]
description | uncertainty = abs(irradiance / exp(irradiance_error / 20))
condition | band=3a
path | /data/band3a/observation_data/irradiance_error[]
description | uncertainty = abs(irradiance / exp(irradiance_error / 20))
condition | band=3b
path | /data/band3b/observation_data/irradiance_error[]
description | uncertainty = abs(irradiance / exp(irradiance_error / 20))
condition | band=3c
path | /data/band3c/observation_data/irradiance_error[]
description | uncertainty = abs(irradiance / exp(irradiance_error / 20))
condition | band=4
path | /data/band4/observation_data/irradiance_error[]
description | uncertainty = abs(irradiance / exp(irradiance_error / 20))
condition | band=5
path | /data/band5/observation_data/irradiance_error[]
description | uncertainty = abs(irradiance / exp(irradiance_error / 20))
photon_irradiance_uncertainty_random | condition | band=1a or band unset
path | /data/band1a/observation_data/irradiance_noise[]
description | uncertainty = abs(irradiance / exp(irradiance_noise / 20))
condition | band=1b
path | /data/band1b/observation_data/irradiance_noise[]
description | uncertainty = abs(irradiance / exp(irradiance_noise / 20))
condition | band=2
path | /data/band2/observation_data/irradiance_noise[]
description | uncertainty = abs(irradiance / exp(irradiance_noise / 20))
condition | band=3a
path | /data/band3a/observation_data/irradiance_noise[]
description | uncertainty = abs(irradiance / exp(irradiance_noise / 20))
condition | band=3b
path | /data/band3b/observation_data/irradiance_noise[]
description | uncertainty = abs(irradiance / exp(irradiance_noise / 20))
condition | band=3c
path | /data/band3c/observation_data/irradiance_noise[]
description | uncertainty = abs(irradiance / exp(irradiance_noise / 20))
condition | band=4
path | /data/band4/observation_data/irradiance_noise[]
description | uncertainty = abs(irradiance / exp(irradiance_noise / 20))
condition | band=5
path | /data/band5/observation_data/irradiance_noise[]
description | uncertainty = abs(irradiance / exp(irradiance_noise / 20))
photon_irradiance_validity | condition | band=1a or band unset
path | /data/band1a/observation_data/spectral_channel_quality[]
condition | band=1b
path | /data/band1b/observation_data/spectral_channel_quality[]
condition | band=2
path | /data/band2/observation_data/spectral_channel_quality[]
condition | band=3a
path | /data/band3a/observation_data/spectral_channel_quality[]
condition | band=3b
path | /data/band3b/observation_data/spectral_channel_quality[]
condition | band=3c
path | /data/band3c/observation_data/spectral_channel_quality[]
condition | band=4
path | /data/band4/observation_data/spectral_channel_quality[]
condition | band=5
path | /data/band5/observation_data/spectral_channel_quality[]
wavelength | condition | band=1a or band unset
path | /data/band1a/instrument_data/nominal_wavelength_coefficients[]
condition | band=1b
path | /data/band1b/instrument_data/nominal_wavelength_coefficients[]
condition | band=2
path | /data/band2/instrument_data/nominal_wavelength_coefficients[]
condition | band=3a
path | /data/band3a/instrument_data/nominal_wavelength_coefficients[]
condition | band=3b
path | /data/band3b/instrument_data/nominal_wavelength_coefficients[]
condition | band=3c
path | /data/band3c/instrument_data/nominal_wavelength_coefficients[]
condition | band=4
path | /data/band4/instrument_data/nominal_wavelength_coefficients[]
condition | band=5
path | /data/band5/instrument_data/nominal_wavelength_coefficients[]
condition | band=1a or band unset,lambda=calibrated or lambda unset
path | /data/band1a/instrument_data/calibrated_wavelength_coefficients[]
condition | band=1a or band unset,lambda=nominal
path | /data/band1a/instrument_data/nominal_wavelength_coefficients[]
condition | band=1b,lambda=calibrated or lambda unset
path | /data/band1b/instrument_data/calibrated_wavelength_coefficients[]
condition | band=1b,lambda=nominal
path | /data/band1b/instrument_data/nominal_wavelength_coefficients[]
condition | band=2,lambda=calibrated or lambda unset
path | /data/band2/instrument_data/calibrated_wavelength_coefficients[]
condition | band=2,lambda=nominal
path | /data/band2/instrument_data/nominal_wavelength_coefficients[]
condition | band=3a,lambda=calibrated or lambda unset
path | /data/band3a/instrument_data/calibrated_wavelength_coefficients[]
condition | band=3a,lambda=nominal
path | /data/band3a/instrument_data/nominal_wavelength_coefficients[]
condition | band=3b,lambda=calibrated or lambda unset
path | /data/band3b/instrument_data/calibrated_wavelength_coefficients[]
condition | band=3b,lambda=nominal
path | /data/band3b/instrument_data/nominal_wavelength_coefficients[]
condition | band=3c,lambda=calibrated or lambda unset
path | /data/band3c/instrument_data/calibrated_wavelength_coefficients[]
condition | band=3c,lambda=nominal
path | /data/band3c/instrument_data/nominal_wavelength_coefficients[]
condition | band=4,lambda=calibrated or lambda unset
path | /data/band4/instrument_data/calibrated_wavelength_coefficients[]
condition | band=4,lambda=nominal
path | /data/band4/instrument_data/nominal_wavelength_coefficients[]
condition | band=5,lambda=calibrated or lambda unset
path | /data/band5/instrument_data/calibrated_wavelength_coefficients[]
condition | band=5,lambda=nominal
path | /data/band5/instrument_data/nominal_wavelength_coefficients[]
wavelength_uncertainty | condition | band=1a or band unset,lambda=calibrated or lambda unset
path | /data/band1a/instrument_data/calibrated_wavelength_coefficients_error[]
condition | band=1a or band unset,lambda=nominal
path | /data/band1a/instrument_data/nominal_wavelength_coefficients_error[]
condition | band=1b,lambda=calibrated or lambda unset
path | /data/band1b/instrument_data/calibrated_wavelength_coefficients_error[]
condition | band=1b,lambda=nominal
path | /data/band1b/instrument_data/nominal_wavelength_coefficients_error[]
condition | band=2,lambda=calibrated or lambda unset
path | /data/band2/instrument_data/calibrated_wavelength_coefficients_error[]
condition | band=2,lambda=nominal
path | /data/band2/instrument_data/nominal_wavelength_coefficients_error[]
condition | band=3a,lambda=calibrated or lambda unset
path | /data/band3a/instrument_data/calibrated_wavelength_coefficients_error[]
condition | band=3a,lambda=nominal
path | /data/band3a/instrument_data/nominal_wavelength_coefficients_error[]
condition | band=3b,lambda=calibrated or lambda unset
path | /data/band3b/instrument_data/calibrated_wavelength_coefficients_error[]
condition | band=3b,lambda=nominal
path | /data/band3b/instrument_data/nominal_wavelength_coefficients_error[]
condition | band=3c,lambda=calibrated or lambda unset
path | /data/band3c/instrument_data/calibrated_wavelength_coefficients_error[]
condition | band=3c,lambda=nominal
path | /data/band3c/instrument_data/nominal_wavelength_coefficients_error[]
condition | band=4,lambda=calibrated or lambda unset
path | /data/band4/instrument_data/calibrated_wavelength_coefficients_error[]
condition | band=4,lambda=nominal
path | /data/band4/instrument_data/nominal_wavelength_coefficients_error[]
condition | band=5,lambda=calibrated or lambda unset
path | /data/band5/instrument_data/calibrated_wavelength_coefficients_error[]
condition | band=5,lambda=nominal
path | /data/band5/instrument_data/nominal_wavelength_coefficients_error[]
wavelength_validity | condition | band=1a or band unset
path | /data/band1a/instrument_data/spectral_calibration_quality[]
condition | band=1b
path | /data/band1b/instrument_data/spectral_calibration_quality[]
condition | band=2
path | /data/band2/instrument_data/spectral_calibration_quality[]
condition | band=3a
path | /data/band3a/instrument_data/spectral_calibration_quality[]
condition | band=3b
path | /data/band3b/instrument_data/spectral_calibration_quality[]
condition | band=3c
path | /data/band3c/instrument_data/spectral_calibration_quality[]
condition | band=4
path | /data/band4/instrument_data/spectral_calibration_quality[]
condition | band=5
path | /data/band5/instrument_data/spectral_calibration_quality[]