ELPP Products¶
This section describe the structure of ELPP products.
ELPP Products: dimensions¶
The following dimensions are defined in ELPP products:
- time
- level
- channel
- depolarization
- angle
- nv
- nc
The dimension time (mandatory) specifies the number of RCS (for each channel) composing all the pre-processed time-series reported in the products.
The dimension level (mandatory) represents the number of rangebins characterizing the pre-processed RCS.
The dimension channel (mandatory) indicates the number channels at which the RCS time-series included in the product refer to.
The dimension depolarization (optional) indicates how many volume depolarization time-series are included in the products.
The dimension angle (mandatory) takes into account how many zenith scan angles have been used to measure the RCS time-series reported into the products.
The dimension nv (mandatory) is ancillary and it is always set to 2.
The dimension nc (optional) is ancillary and provides the number of channels involved in the calculation of RCS or volume depolarization time-series.
ELPP Products: variables¶
- latitude
Type: double Dimensions: – Variable_Type: Mandatory Description: measurement site latitude Units: degrees_north Definition: double latitude - longitude
Type: double Dimensions: – Variable_Type: Mandatory Description: measurement site longitude Units: degrees_east Definition: double longitude - station_altitude
Type: double Dimensions: – Variable_Type: Mandatory Description: station altitude above see level Units: m Definition: double station_altitude - altitude
Type: double Dimensions: time, level Variable_Type: Mandatory Description: altitude above see level Units: m Definition: double altitude(time, level) - range
Type: double Dimensions: level Variable_Type: Mandatory Description: lidar range scale Units: m Definition: double range(level) - laser_pointing_angle
Type: double Dimensions: angle Variable_Type: Mandatory Description: laser pointing angle with respect to the zenith Units: degrees Definition: double laser_pointing_angle(angle) - laser_pointing_angle_of_profile
Type: int Dimensions: angle Variable_Type: Mandatory Description: index of scan angle at which each single raw profile has been detected Units: – Definition: int laser_pointing_angle_of_profile(angle) - shots
Type: int Dimensions: time Variable_Type: Mandatory Description: accumulated laser shots Units: – Definition: int shots(time) - 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) - cloud_mask_type
Type: byte Dimensions: – Variable_Type: Mandatory Description: Bitmask describing the cloudmask type Units: – Definition: byte cloud_mask_type - cloud_mask
Type: byte Dimensions: time, level Variable_Type: Optional Description: Bitmask describing the cloudmask Units: – Definition: byte cloud_mask(time, level) - cloud_fraction
Type: double Dimensions: time, level Variable_Type: Optional Description: Fraction of cloud contamination Units: – Definition: byte cloud_mask(time, altitude) - temperature
Type: double Dimensions: time, level Variable_Type: Mandatory Description: Atmospheric temperature Units: K Definition: double temperature(time, level) - pressure
Type: double Dimensions: time, level Variable_Type: Mandatory Description: Atmospheric pressure Units: mbar Definition: double pressure(time, level) - molecular_calculation_source
Type: byte Dimensions: – Variable_Type: Mandatory Description: Source used to compute the atmospheric molecular density Units: – Definition: byte molecular_calculation_source - scc_product_type
Type: byte Dimensions: – Variable_Type: Mandatory Description: Bitmask describing the SCC product type Units: – Definition: byte scc_product_type - range_corrected_signal_channel_id
Type: int Dimensions: channel, nc Variable_Type: Optional Description: SCC channel ID list involved in the calculation of the range corrected signal total timeseries Units: – Definition: int range_corrected_signal_channel_id(channel, nc) - range_corrected_signal_channel_name
Type: string Dimensions: channel Variable_Type: Mandatory Description: Channel name for the range corrected signal timeseries Units: – Definition: string range_corrected_signal_channel_name(channel) - range_corrected_signal_emission_wavelength
Type: double Dimensions: channel Variable_Type: Mandatory Description: Emission wavelength used to measure the range corrected signal timeseries Units: nm Definition: double range_corrected_signal_emission_wavelength(channel) - range_corrected_signal_detection_wavelength
Type: double Dimensions: channel Variable_Type: Mandatory Description: Detection wavelength used to measure the range corrected signal timeseries Units: nm Definition: double range_corrected_signal_detection_wavelength(channel) - range_corrected_signal_range
Type: byte Dimensions: channel Variable_Type: Mandatory Description: Bitmask to identify range corrected signal range type Units: – Definition: byte range_corrected_signal_range(channel) - range_corrected_signal_scatterers
Type: byte Dimensions: channel Variable_Type: Mandatory Description: Bitmask to identify range corrected signal scatterer type Units: – Definition: byte range_corrected_signal_scatterers(channel) - range_corrected_signal_detection_mode
Type: byte Dimensions: channel Variable_Type: Mandatory Description: Bitmask to identify range corrected signal detection mode Units: – Definition: byte range_corrected_signal_detection_mode(channel) - polarization_crosstalk_parameter_g
Type: double Dimensions: channel Variable_Type: Optional Description: Polarization crosstalk parameter (G) Units: – Definition: double polarization_crosstalk_parameter_g(channel) - polarization_crosstalk_parameter_g_statistical_error
Type: double Dimensions: channel Variable_Type: Optional Description: Statistical error on polarization crosstalk parameter (G) Units: – Definition: double polarization_crosstalk_parameter_g_statistical_error(channel) - polarization_crosstalk_parameter_g_systematic_error
Type: double Dimensions: channel Variable_Type: Optional Description: Systematic error on polarization crosstalk parameter (G) Units: – Definition: double polarization_crosstalk_parameter_g_systematic_error(channel) - polarization_crosstalk_parameter_h
Type: double Dimensions: channel Variable_Type: Optional Description: Polarization crosstalk parameter (H) Units: – Definition: double polarization_crosstalk_parameter_h(channel) - polarization_crosstalk_parameter_h_statistical_error
Type: double Dimensions: channel Variable_Type: Optional Description: Statistical error on polarization crosstalk parameter (H) Units: – Definition: double polarization_crosstalk_parameter_h_statistical_error(channel) - polarization_crosstalk_parameter_h_systematic_error
Type: double Dimensions: channel Variable_Type: Optional Description: Systematic error on polarization crosstalk parameter (H) Units: – Definition: double polarization_crosstalk_parameter_H_systematic_error(channel) - polarization_channel_geometry
Type: byte Dimensions: channel Variable_Type: Optional Description: Polarization channel geometry Units: – Definition: byte polarization_channel_geometry - polarization_channel_configuration
Type: byte Dimensions: channel Variable_Type: Optional Description: Polarization channel configuration Units: – Definition: byte polarization_channel_configuration(channel) - overlap_correction_function
Type: double Dimensions: channel,angle, level Variable_Type: Mandatory Description: Overlap funciton used to correct the range corrected signal Units: – Definition: double overlap_correction_function(channel, angle, level) - assumed_particle_lidar_ratio
Type: double Dimensions: angle, level Variable_Type: Optional Description: Assumed particle lidar ration for the elastic-only backscatter retrieval Units: sr Definition: double assumed_particle_lidar_ratio(angle, level) - assumed_particle_lidar_ratio_error
Type: double Dimensions: angle, level Variable_Type: Optional Description: Total error (uncertainty) on assumed particle lidar ration for the elastic-only backscatter retrieval Units: sr Definition: double assumed_particle_lidar_ratio(angle, level) - molecular_extinction
Type: double Dimensions: channel, time, level Variable_Type: Mandatory Description: Calculated molecular extinction at emission wavelength Units: m^{-1} Definition: double molecular_extinction(channel, time, level) - molecular_transmissivity_at_emission_wavelength
Type: double Dimensions: channel, time, level Variable_Type: Mandatory Description: Calculate molecular transmissivity at emission wavelentgh Units: – Definition: double molecular_transmissivity_at_emission_wavelength(channel, time, level) - molecular_transmissivity_at_detection_wavelength
Type: double Dimensions: channel, time, level Variable_Type: Mandatory Description: Calculate molecular transmissivity at detection wavelentgh Units: – Definition: double molecular_transmissivity_at_detection_wavelength(channel, time, level) - molecular_lidar_ratio
Type: double Dimensions: channel Variable_Type: Mandatory Description: Calculated molecular lidar ratio at emission wavelength Units: sr Definition: double molecular_lidar_ratio(channel) - depolarization_calibration_index
Type: int Dimensions: channel Variable_Type: Optional Description: Depolarization index to use to calibrate the channel Units: – Definition: int depolarization_calibration_index(channel) - polarization_calibration_type
Type: byte Dimensions: depolarization Variable_Type: Optional Description: Polarization calibration type Units: – Definition: byte polarization_calibration_type(depolarization) - molecular_depolarization_ratio
Type: double Dimensions: depolarization, time, level Variable_Type: Optional Description: Calculated molecular depolarization ratio Units: – Definition: double molecular_depolarization_ratio(depolarization, time, level) - near_range_glueing_region_minimum
Type: double Dimensions: channel, time Variable_Type: Optional Description: Mininum altitude of glueing region for the near range and far range signals Units: m Definition: double near_range_glueing_region_minimum(channel, time) - near_range_glueing_region_maximum
Type: double Dimensions: channel, time Variable_Type: Optional Description: Mininum altitude of glueing region for the near range and far range signals Units: m Definition: double near_range_glueing_region_maximum(channel, time) - ultra_near_range_glueing_region_minimum
Type: double Dimensions: channel, time Variable_Type: Optional Description: Mininum altitude of glueing region for the ultra near range and near range signals Units: m Definition: double ultra_near_range_glueing_region_minimum(channel, time) - ultra_near_range_glueing_region_maximum
Type: double Dimensions: channel, time Variable_Type: Optional Description: Maximum altitude of glueing region for the ultra near range and near range signals Units: m Definition: double ultra_near_range_glueing_region_maximum(channel, time) - range_corrected_signal
Type: double Dimensions: channel, time, level Variable_Type: Mandatory Description: Range corrected signal timeseries Units: – Definition: double range_corrected_signal(channel, time, level) - range_corrected_signal_statistical_error
Type: double Dimensions: channel, time, level Variable_Type: Mandatory Description: Statistical error (uncertainty) on range corrected signal timeseries Units: – Definition: double range_corrected_signal_statistical_error(channel, time, level) - range_corrected_signal_systematic_error
Type: double Dimensions: channel, time, level Variable_Type: Optional Description: Systematic error (uncertainty) on range corrected signal timeseries Units: – Definition: double range_corrected_signal_statistical_error(channel, time, level) - polarization_gain_factor_measurementid
Type: string Dimensions: depolarization Variable_Type: Optional Description: Measurement ID corresponding to the polarization measurements used to calibrate polarization channels Units: – Definition: string polarization_gain_factor_measurementid(depolarization) - polarization_gain_factor
Type: double Dimensions: depolarization Variable_Type: Optional Description: Reflected to transmitted polarization channel gain factor (eta*) Units: – Definition: double polarization_gain_factor(depolarization) - polarization_gain_factor_statistical_error
Type: double Dimensions: depolarization Variable_Type: Optional Description: Statistical error (uncertainty) on reflected to transmitted polarization channel gain factor Units: – Definition: double polarization_gain_factor_statistical_error(depolarization) - polarization_gain_factor_systematic_error
Type: double Dimensions: depolarization Variable_Type: Optional Description: Systamatic error (uncertainty) on reflected to transmitted polarization channel gain factor Units: – Definition: double polarization_gain_factor_systematic_error(depolarization) - polarization_gain_factor_start_datetime
Type: double Dimensions: depolarization Variable_Type: Optional Description: Polarization gain factor measurement start datetime Units: seconds since 1970-01-01T00:00:00Z Definition: double polarization_gain_factor_start_datetime(depolarization) - polarization_gain_factor_stop_datetime
Type: double Dimensions: depolarization Variable_Type: Optional Description: Polarization gain factor measurement stop datetime Units: seconds since 1970-01-01T00:00:00Z Definition: double polarization_gain_factor_stop_datetime(depolarization) - polarization_gain_factor_correction
Type: double Dimensions: depolarization Variable_Type: Optional Description: Reflected to transmitted polarization channel gain correction factor (K) Units: – Definition: double polarization_gain_factor_correction(depolarization) - polarization_gain_factor_correction_statistical_error
Type: double Dimensions: depolarization Variable_Type: Optional Description: Statistical error (uncertainty) on reflected to transmitted polarization channel gain correction factor Units: – Definition: double polarization_gain_factor_correction_statistical_error(depolarization) - polarization_gain_factor_correction_systematic_error
Type: double Dimensions: depolarization Variable_Type: Optional Description: Systamatic error (uncertainty) on reflected to transmitted polarization channel gain correction factor Units: – Definition: double polarization_gain_factor_correction_systematic_error(depolarization) - polarization_gain_factor_correction_start_datetime
Type: double Dimensions: depolarization Variable_Type: Optional Description: Polarization gain corrrection factor measurement start datetime Units: seconds since 1970-01-01T00:00:00Z Definition: double polarization_gain_factor_correction_start_datetime(depolarization) - polarization_gain_factor_correction_stop_datetime
Type: double Dimensions: depolarization Variable_Type: Optional Description: Polarization gain correction factor measurement stop datetime Units: seconds since 1970-01-01T00:00:00Z Definition: double polarization_gain_factor_correction_stop_datetime(depolarization)
ELPP 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 - molecular_calculation_source_file
Type: string Global_Attribute_Type: Optional Description: Name of the source file containing atmospheric PTU profile(s) used to compute molecular number density (if standard atmosphere is used this global attribute is missing)