# CALIPSO_L2_CAL_LID_APro

## Variables

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

field name | type | dimensions | unit | description
--- | --- | --- | --- | ---
datetime_start | double | {time} | [seconds since 2000-01-01] | time at the start of the measurement
datetime | double | {time} | [seconds since 2000-01-01] | time during midpoint of the measurement
datetime_stop | double | {time} | [seconds since 2000-01-01] | time at the end of the measurement
latitude | double | {time} | [degree_north] | latitude of the ground pixel center
longitude | double | {time} | [degree_east] | longitude of the ground pixel center
tropopause_altitude | double | {time} | [km] | tropopause altitude
altitude | double | {vertical} | [km] | altitude
pressure | double | {time, vertical} | [hPa] | pressure
temperature | double | {time, vertical} | [K] | temperature
aerosol_extinction_coefficient | double | {time, vertical} | [km^-1] | aerosol extinction coefficient
aerosol_extinction_coefficient_uncertainty | double | {time, vertical} | [km^-1] | aerosol extinction coefficient uncertainty
backscatter_coefficient | double | {time, vertical} | [sr^-1 km^-1] | backscatter coefficient
backscatter_coefficient_uncertainty | double | {time, vertical} | [sr^-1 km^-1] | backscatter coefficient uncertainty
tropospheric_aerosol_optical_depth | double | {time} | [] | tropospheric aerosol optical depth
tropospheric_aerosol_optical_depth_uncertainty | double | {time} | [] | tropospheric aerosol optical depth uncertainty
stratospheric_aerosol_optical_depth | double | {time} | [] | stratospheric aerosol optical depth
stratospheric_aerosol_optical_depth_uncertainty | double | {time} | [] | stratospheric aerosol optical depth uncertainty
cloud_optical_depth | double | {time} | [] | cloud optical depth
cloud_optical_depth_uncertainty | double | {time} | [] | cloud optical depth uncertainty
index | int32 | {time} |  | zero-based index of the sample within the source product

## Ingestion options

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

option name | legal values | description
--- | --- | ---
wavelength | 532, 1064 | the wavelength whose measurements are ingested; option values are ‘532’ (default), ‘1064’

## Mapping description

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

field name | mapping description
--- | ---
datetime_start | path | /Profile_Time[,0]
description | time at the start of the measurement
datetime | path | /Profile_Time[,N/2]
datetime_stop | path | /Profile_Time[,N-1]
description | time at the end of the measurement
latitude | path | /Latitude[,N/2]
longitude | path | /Longitude[,N/2]
tropopause_altitude | path | /Tropopause_Height[]
altitude | path | /metadata/Lidar_Data_Altitudes[]
pressure | path | /Pressure[,]
temperature | path | /Temperature[,]
aerosol_extinction_coefficient | condition | wavelength=532 or wavelength unset
path | /Extinction_Coefficient_532[,]
condition | wavelength=1064
path | /Extinction_Coefficient_1064[,]
aerosol_extinction_coefficient_uncertainty | condition | wavelength=532 or wavelength unset
path | /Extinction_Coefficient_Uncertainty_532[,]
condition | wavelength=1064
path | /Extinction_Coefficient_Uncertainty_1064[,]
backscatter_coefficient | condition | wavelength=532 or wavelength unset
path | /Total_Backscatter_Coefficient_532[,]
condition | wavelength=1064
path | /Backscatter_Coefficient_1064[,]
backscatter_coefficient_uncertainty | condition | wavelength=532 or wavelength unset
path | /Total_Backscatter_Coefficient_Uncertainty_532[,]
condition | wavelength=1064
path | /Backscatter_Coefficient_Uncertainty_1064[,]
tropospheric_aerosol_optical_depth | condition | wavelength=532 or wavelength unset
path | /Column_Optical_Depth_Tropospheric_Aerosols_532[]
condition | wavelength=1064
path | /Column_Optical_Depth_Tropospheric_Aerosols_1064[]
tropospheric_aerosol_optical_depth_uncertainty | condition | wavelength=532 or wavelength unset
path | /Column_Optical_Depth_Tropospheric_Aerosols_Uncertainty_532[]
condition | wavelength=1064
path | /Column_Optical_Depth_Tropospheric_Aerosols_Uncertainty_1064[]
stratospheric_aerosol_optical_depth | condition | wavelength=532 or wavelength unset
path | /Column_Optical_Depth_Stratospheric_Aerosols_532[]
condition | wavelength=1064
path | /Column_Optical_Depth_Stratospheric_Aerosols_1064[]
stratospheric_aerosol_optical_depth_uncertainty | condition | wavelength=532 or wavelength unset
path | /Column_Optical_Depth_Stratospheric_Aerosols_Uncertainty_532[]
condition | wavelength=1064
path | /Column_Optical_Depth_Stratospheric_Aerosols_Uncertainty_1064[]
cloud_optical_depth | path | /Column_Optical_Depth_Cloud_532[]
cloud_optical_depth_uncertainty | path | /Column_Optical_Depth_Cloud_Uncertainty_532[]