# ECA_ATL_EBD_2A

## Variables

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

field name | type | dimensions | unit | description
--- | --- | --- | --- | ---
datetime | double | {time} | [seconds since 2000-01-01] | UTC time
latitude | double | {time} | [degree_north] | Geodetic latitude
longitude | double | {time} | [degree_east] | Geodetic longitude
orbit_index | int32 |  |  | absolute orbit number
altitude | float | {time, vertical} | [m] | joint standard grid height
surface_altitude | float | {time} | [m] | surface altitude
viewing_elevation_angle | float | {time} | [degree] | viewing elevation angle
tropopause_height | float | {time} | [m] | tropopause height
extinction_coefficient | float | {time, vertical} | [1/m] | particle extinction coefficient 355nm
extinction_coefficient_uncertainty | float | {time, vertical} | [1/m] | particle extinction coefficient 355nm error
backscatter_coefficient | float | {time, vertical} | [1/m/sr] | particle backscatter coefficient 355nm
backscatter_coefficient_uncertainty | float | {time, vertical} | [1/m/sr] | particle backscatter coefficient 355nm error
lidar_ratio | float | {time, vertical} | [sr] | lidar ratio 355nm
lidar_ratio_uncertainty | float | {time, vertical} | [sr] | lidar ratio 355nm error
linear_depolarization_ratio | float | {time, vertical} | [] | particle linear depolarization ratio 355nm
linear_depolarization_ratio_uncertainty | float | {time, vertical} | [] | particle linear depolarization ratio 355nm error
optical_depth | float | {time, vertical} | [] | partical optical depth
optical_depth_uncertainty | float | {time, vertical} | [] | partical optical depth error
particle_effective_radius | float | {time, vertical} | [m] | particle effective area radius
particle_effective_radius_uncertainty | float | {time, vertical} | [m] | particle effective area radius error
particle_type | int8 | {time, vertical} |  | simple classification
validity | int8 | {time, vertical} |  | quality status
wavelength | float |  | [nm] | lidar wavelength
index | int32 | {time} |  | zero-based index of the sample within the source product

## Ingestion options

The table below lists the available ingestion options for `ECA_ATL_EBD_2A` products.

option name | legal values | description
--- | --- | ---
resolution | medium, low | classification resolution: normal (default), medium (resolution=medium), or low (resolution=low)

## Mapping description

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

field name | mapping description
--- | ---
datetime | path | /ScienceData/time
latitude | path | /ScienceData/latitude
longitude | path | /ScienceData/longitude
orbit_index | path | /HeaderData/VariableProductHeader/MainProductHeader/orbitNumber
altitude | path | /ScienceData/height, /ScienceData/geoid_offset
description | the vertical grid is inverted to make it ascending; altitude[i,j] = height[i,j] - geoid_offset[i]
surface_altitude | path | /ScienceData/elevation, /ScienceData/geoid_offset
description | altitude = elevation - geoid_offset
viewing_elevation_angle | path | /ScienceData/viewing_elevation_angle
tropopause_height | path | /ScienceData/tropopause_height
extinction_coefficient | condition | resolution unset
path | /ScienceData/particle_extinction_coefficient_355nm
description | the vertical grid is inverted to make it ascending
condition | resolution=medium
path | /ScienceData/particle_extinction_coefficient_355nm_medium_resolution
description | the vertical grid is inverted to make it ascending
condition | resolution=low
path | /ScienceData/particle_extinction_coefficient_355nm_low_resolution
description | the vertical grid is inverted to make it ascending
extinction_coefficient_uncertainty | condition | resolution unset
path | /ScienceData/particle_extinction_coefficient_355nm_error
description | the vertical grid is inverted to make it ascending
condition | resolution=medium
path | /ScienceData/particle_extinction_coefficient_355nm_medium_resolution_error
description | the vertical grid is inverted to make it ascending
condition | resolution=low
path | /ScienceData/particle_extinction_coefficient_355nm_low_resolution_error
description | the vertical grid is inverted to make it ascending
backscatter_coefficient | condition | resolution unset
path | /ScienceData/particle_backscatter_coefficient_355nm
description | the vertical grid is inverted to make it ascending
condition | resolution=medium
path | /ScienceData/particle_backscatter_coefficient_355nm_medium_resolution
description | the vertical grid is inverted to make it ascending
condition | resolution=low
path | /ScienceData/particle_backscatter_coefficient_355nm_low_resolution
description | the vertical grid is inverted to make it ascending
backscatter_coefficient_uncertainty | condition | resolution unset
path | /ScienceData/particle_backscatter_coefficient_355nm_error
description | the vertical grid is inverted to make it ascending
condition | resolution=medium
path | /ScienceData/particle_backscatter_coefficient_355nm_medium_resolution_error
description | the vertical grid is inverted to make it ascending
condition | resolution=low
path | /ScienceData/particle_backscatter_coefficient_355nm_low_resolution_error
description | the vertical grid is inverted to make it ascending
lidar_ratio | condition | resolution unset
path | /ScienceData/lidar_ratio_355nm
description | the vertical grid is inverted to make it ascending
condition | resolution=medium
path | /ScienceData/lidar_ratio_355nm_medium_resolution
description | the vertical grid is inverted to make it ascending
condition | resolution=low
path | /ScienceData/lidar_ratio_355nm_low_resolution
description | the vertical grid is inverted to make it ascending
lidar_ratio_uncertainty | condition | resolution unset
path | /ScienceData/lidar_ratio_355nm_error
description | the vertical grid is inverted to make it ascending
condition | resolution=medium
path | /ScienceData/lidar_ratio_355nm_medium_resolution_error
description | the vertical grid is inverted to make it ascending
condition | resolution=low
path | /ScienceData/lidar_ratio_355nm_low_resolution_error
description | the vertical grid is inverted to make it ascending
linear_depolarization_ratio | condition | resolution unset
path | /ScienceData/particle_linear_depol_ratio_355nm
description | the vertical grid is inverted to make it ascending
condition | resolution=medium
path | /ScienceData/particle_linear_depol_ratio_355nm_medium_resolution
description | the vertical grid is inverted to make it ascending
condition | resolution=low
path | /ScienceData/particle_linear_depol_ratio_355nm_low_resolution
description | the vertical grid is inverted to make it ascending
linear_depolarization_ratio_uncertainty | condition | resolution unset
path | /ScienceData/particle_linear_depol_ratio_355nm_error
description | the vertical grid is inverted to make it ascending
condition | resolution=medium
path | /ScienceData/particle_linear_depol_ratio_355nm_medium_resolution_error
description | the vertical grid is inverted to make it ascending
condition | resolution=low
path | /ScienceData/particle_linear_depol_ratio_355nm_low_resolution_error
description | the vertical grid is inverted to make it ascending
optical_depth | condition | resolution unset
path | /ScienceData/particle_optical_depth_355nm
description | the vertical grid is inverted to make it ascending
condition | resolution=medium
path | /ScienceData/particle_optical_depth_355nm_medium_resolution
description | the vertical grid is inverted to make it ascending
condition | resolution=low
path | /ScienceData/particle_optical_depth_355nm_low_resolution
description | the vertical grid is inverted to make it ascending
optical_depth_uncertainty | condition | resolution unset
path | /ScienceData/particle_optical_depth_355nm_error
description | the vertical grid is inverted to make it ascending
condition | resolution=medium
path | /ScienceData/particle_optical_depth_355nm_medium_resolution_error
description | the vertical grid is inverted to make it ascending
condition | resolution=low
path | /ScienceData/particle_optical_depth_355nm_low_resolution_error
description | the vertical grid is inverted to make it ascending
particle_effective_radius | path | /ScienceData/particle_effective_area_radius
description | the vertical grid is inverted to make it ascending
particle_effective_radius_uncertainty | path | /ScienceData/particle_effective_area_radius_error
description | the vertical grid is inverted to make it ascending
particle_type | path | /ScienceData/simple_classification
description | the vertical grid is inverted to make it ascending
validity | path | /ScienceData/quality_status
description | the vertical grid is inverted to make it ascending
wavelength | description | set to fixed value of 355nm