ELDA Products¶
This section describe the structure of ELDA products.
ELPP Products: dimensions¶
Aerosol optical products have the wavelength dimension (accommodating products at different wavelength in the same variable) and time dimension (accommodating different profiles in the same time series). The altitude dimension is defined for reporting the information as a function of the altitude. The dimension nv is used following the cf convention whenever a bound is needed for some evaluation. In our case nv is used for defining variables which have per definition some bounds as time_bounds reported below.
The following dimensions are defined in ELDA products:
- time
- altitude
- wavelength
- nv
The dimension time (mandatory) specifies the number of vertical profiles included in the product timeseries.
The dimension altitude (mandatory) represents the number of rangebins characterizing each vertical profile
The dimension wavelength (mandatory) indicates the number wavelengths for which the optical variables are provided
The dimension nv (mandatory) is ancillary and it is always set to 2.
ELDA Products: variables¶
- latitude
Type: float Dimensions: – Variable_Type: Mandatory Description: measurement site latitude Units: degrees_north Definition: float latitude - longitude
Type: float Dimensions: – Variable_Type: Mandatory Description: measurement site longitude Units: degrees_east Definition: float longitude - station_altitude
Type: float Dimensions: – Variable_Type: Mandatory Description: station altitude above see level Units: m Definition: float station_altitude - altitude
Type: double Dimensions: altitude Variable_Type: Mandatory Description: altitude above see level Units: m Definition: double altitude(altitude) - time
Type: double Dimensions: time Variable_Type: Mandatory Description: seconds since 1970-01-01T00:00:00Z Units: – Definition: double time(time) - time_bounds
Type: double Dimensions: time, nv Variable_Type: Mandatory Description: seconds since 1970-01-01T00:00:00Z Units: – Definition: double time_bounds(time,nv) - shots
Type: int Dimensions: time Variable_Type: Mandatory Description: accumulated laser shots Units: – Definition: int shots(time) - cloud_mask_type
Type: byte Dimensions: – Variable_Type: Mandatory Description: Bimask describing the cloudmask type Units: – Definition: byte cloud_mask_type - cloud_mask
Type: byte Dimensions: time, altitude Variable_Type: Optional Description: Bimask describing the cloudmask Units: – Definition: byte cloud_mask(time, altitude) - vertical_resolution
Type: double Dimensions: wavelength, time, altitude Variable_Type: Mandatory Description: Effective vertical resolution according to Pappalardo et al., appl. opt. 2004 Units: m Definition: double vertical_resolution(wavelength, time, altitude) - cirrus_contamination
Type: byte Dimensions: – Variable_Type: Mandatory Description: Do the profiles contain cirrus layers? Units: – Definition: byte cirrus_contamination - cirrus_contamination_source
Type: byte Dimensions: – Variable_Type: Mandatory Description: How was cirrus_contamination obtained? Units: – Definition: byte cirrus_contamination_source - error_retrieval_method
Type: byte Dimensions: wavelength Variable_Type: Mandatory Description: Method used for the retrieval of erros (uncertainties) Units: – Definition: byte error_retrieval_method(wavelength) - backscatter_evaluation_method
Type: byte Dimensions: wavelength Variable_Type: Optional Description: Method used for the backscatter retrieval Units: – Definition: byte backscatter_evaluation_method(wavelength) - elastic_backscatter_algorithm
Type: byte Dimensions: wavelength Variable_Type: Optional Description: Algorithm used for the retrieval of the elastic backscatter profile Units: – Definition: byte elastic_backscatter_algorithm(wavelength) - assumed_particle_lidar_ratio
Type: double Dimensions: wavelength, time, altitude Variable_Type: Optional Description: Assumed particle lidar ratio for the elastic-only backscatter retrieval Units: sr Definition: double assumed_particle_lidar_ratio(wavelength, time, altitude) - backscatter
Type: double Dimensions: wavelength, time, altitude Variable_Type: Optional Description: Particle backscatter coefficient Units: 1/(m*sr) Definition: double backscatter(wavelength, time, altitude) - error_backscatter
Type: double Dimensions: wavelength, time, altitude Variable_Type: Optional Description: Absolute statistical error (unertanity) of particle backscatter coefficient Units: 1/(m*sr) Definition: double error_backscatter(wavelength, time, altitude) - extinction
Type: double Dimensions: wavelength, time, altitude Variable_Type: Optional Description: Particle extinction coefficient Units: 1/m Definition: double extinction(wavelength, time, altitude) - error_extinction
Type: double Dimensions: wavelength, time, altitude Variable_Type: Optional Description: Absolute statistical error (unertanity) of particle extinction coefficient Units: 1/m Definition: double error_extinction(wavelength, time, altitude) - volumedepolarization
Type: double Dimensions: wavelength, time, altitude Variable_Type: Optional Description: Volume linear depolarization ratio Units: – Definition: double volumedepolarization(wavelength, time, altitude) - error_volumedepolarization
Type: double Dimensions: wavelength, time, altitude Variable_Type: Optional Description: Absolute statistical error (unertanity) of volume linear depolarization ratio Units: 1/m Definition: double error_volumedepolarization(wavelength, time, altitude) - particledepolarization
Type: double Dimensions: wavelength, time, altitude Variable_Type: Optional Description: Particle linear depolarization ratio Units: – Definition: double particledepolarization(wavelength, time, altitude) - error_particledepolarization
Type: double Dimensions: wavelength, time, altitude Variable_Type: Optional Description: Absolute statistical error (unertanity) of particle linear depolarization ratio Units: 1/m Definition: double error_particledepolarization(wavelength, time, altitude) - user_defined_category
Type: int Dimensions: – Variable_Type: Optional Description: User defined category of the measurement Units: – Definition: int user_defined_category - molecular_calculation_source
Type: byte Dimensions: – Variable_Type: Mandatory Description: Data source of the molecular calculations Units: – Definition: byte molecular_calculation_source - backscatter_calibration_value
Type: float Dimensions: wavelength Variable_Type: Optional Description: Assumed backscatter-ratio value (unitless) in calibration range Units: – Definition: float backscatter_calibration_value(wavelength) - backscatter_calibration_search_range
Type: float Dimensions: wavelength, nv Variable_Type: Optional Description: Height range wherein calibration range is searched Units: m Definition: float backscatter_calibration_search_range(wavelength, nv) - wavelength
Type: float Dimensions: wavelength Variable_Type: Mandatory Description: Wavelength of the transmitted laser pulse Units: nm Definition: float wavelength(wavelength) - zenith_angle
Type: float Dimensions: – Variable_Type: Mandatory Description: Laser pointing angle with respect to the zenith Units: degrees Definition: float zenith_angle - earlinet_product_type
Type: int Dimensions: – Variable_Type: Mandatory Description: Earlinet product type Units: – Definition: int earlinet_product_type - backscatter_calibration_range_search_algorithm
Type: byte Dimensions: wavelength Variable_Type: Optional Description: Algorithm used for the search of the calibration_range Units: – Definition: byte backscatter_calibration_range_search_algorithm(wavelength) - backscatter_calibration_range
Type: float Dimensions: wavelength, nv Variable_Type: Optional Description: Height range where calibration was calculated Units: m Definition: float backscatter_calibration_range(wavelength, nv) - raman_backscatter_algorithm
Type: byte Dimensions: wavelength Variable_Type: Optional Description: Algorithm used for the retrieval of the Raman backscatter profile Units: – Definition: byte raman_backscatter_algorithm(wavelength) - extinction_evaluation_algorithm
Type: byte Dimensions: wavelength Variable_Type: Optional Description: Algorithm used for the extinction retrieval Units: – Definition: byte extinction_evaluation_algorithm(wavelength) - extinction_assumed_wavelength_dependence
Type: float Dimensions: wavelength Variable_Type: Optional Description: Assumed wavelength dependence for particle extinction retrieval Definition: float extinction_assumed_wavelength_dependence(wavelength) - scc_product_type
Type: byte Dimensions: – Variable_Type: Mandatory Description: Bitmask describing the SCC product type Units: – Definition: byte scc_product_type
ELDA Products: global attributes¶
- Conventions
Type: string Global_Attribute_Type: Mandatory Description: List of the conventions the product is compliant to - title
Type: string Global_Attribute_Type: Mandatory Description: Product title - source
Type: string Global_Attribute_Type: Mandatory Description: String describing the source used to generate the product - references
Type: string Global_Attribute_Type: Mandatory Description: Reference(s) for data processing - location
Type: string Global_Attribute_Type: Mandatory Description: Measurement site location - station_ID
Type: string Global_Attribute_Type: Mandatory Description: Unique 3 digit code identifying SCC station - PI
Type: string Global_Attribute_Type: Mandatory Description: PI full name - PI_affiliation
Type: string Global_Attribute_Type: Mandatory :Description: PI complete affiliation - PI_affiliation_acronym
Type: string Global_Attribute_Type: Mandatory Description: PI affiliation acronym - PI_address
Type: string Global_Attribute_Type: Optional Description: PI address - PI_phone
Type: string Global_Attribute_Type: Optional Description: PI phone number - PI_email
Type: string Global_Attribute_Type: Mandatory Description: PI e-mail - Data_Originator
Type: string Global_Attribute_Type: Mandatory Description: Data originator full name - Data_Originator_affiliation
Type: string Global_Attribute_Type: Mandatory Description: Data originator complete affiliation - Data_Originator_affiliation_acronym
Type: string Global_Attribute_Type: Mandatory Description: Data originator affiliation acronym - Data_Originator_address
Type: string Global_Attribute_Type: Optional Description: Data originator complete address - Data_Originator_phone
Type: string Global_Attribute_Type: Optional Description: Data originator phone number - Data_Originator_email
Type: string Global_Attribute_Type: Mandatory Description: Data originator e-mail address - institution
Type: string Global_Attribute_Type: Mandatory Description: Istitution the product belong to - system
Type: string Global_Attribute_Type: Mandatory Description: Name of the measuring instrument (lidar) - hoi_system_ID
Type: int Global_Attribute_Type: Mandatory Description: Numeric ID identifying the measuring system in the ACTRIS/EARLINET Handbook Of Instrument (HOI) - hoi_configuration_ID;
Type: int Global_Attribute_Type: Mandatory Description: Numeric ID identifying the configuration of the measuring system in the ACTRIS/EARLINET Handbook Of Instrument (HOI) - measurement_ID;
Type: string Global_Attribute_Type: Mandatory Description: Alphanumeric identifier for the raw data measurements use to generate the product - measurement_start_datetime
Type: string Global_Attribute_Type: Mandatory Description: Measurement start datetime YYYY-mm-ddTHH:MM:SSZ - measurement_stop_datetime
Type: string Global_Attribute_Type: Mandatory Description: Measruement stop datetime YYYY-mm-ddTHH:MM:SSZ - comment
Type: string Global_Attribute_Type: Optional Description: Any product comments - scc_version_description
Type: string Global_Attribute_Type: Mandatory Description: Extended SCC version description - scc_version
Type: string Global_Attribute_Type: Mandatory Description: SCC version number - processor_name
Type: string Global_Attribute_Type: Mandatory Description: Name of the processor used to generate the product - processor_version
Type: string Global_Attribute_Type: Mandatory Description: Version of the processor used to generate the product - history
Type: string Global_Attribute_Type: Mandatory Description: Field describing the history of the product - __file_format_version
Type: string Global_Attribute_Type: Mandatory Description: Version of the product file format - data_processing_institution
Type: string Global_Attribute_Type: Mandatory Description: Instituion responsible for data processing - input_file
Type: string Global_Attribute_Type: Mandatory Description: Filename of the input data product used to generate the current product