ELIC Products¶
This section describe the structure of ELIC products.
ELIC Products: dimensions¶
The following dimensions are defined in ELPP products:
- time
- level
- channel
- depolarization
- angle
- nv
- nc
- ncal
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.
The dimension ncal (mandatory) is ancillary and provides the number of optical calibration used to calibrate the current product.
ELIC 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) - scc_product_type
Type: byte Dimensions: – Variable_Type: Mandatory Description: Bitmask describing the SCC product type Units: – Definition: byte scc_product_type - attenuated_backscatter_channel_id
Type: int Dimensions: channel, nc Variable_Type: Optional Description: SCC channel ID list involved in the calculation of the total attenuated backscatter timeseries Units: – Definition: int attenuated_backscatter_channel_id(channel, nc) - attenuated_backscatter_channel_name
Type: string Dimensions: channel Variable_Type: Mandatory Description: Channel name for the total attenuated backscatter timeseries Units: – Definition: string attenuated_backscatter_channel_name(channel) - attenuated_backscatter_emission_wavelength
Type: double Dimensions: channel Variable_Type: Mandatory Description: Emission wavelength used to measure the total attenuated backscatter timeseries Units: nm Definition: double attenuated_backscatter_emission_wavelength(channel) - attenuated_backscatter_detection_wavelength
Type: double Dimensions: channel Variable_Type: Mandatory Description: Detection wavelength used to measure the total attenuated backscatter timeseries Units: nm Definition: double attenuated_backscatter_detection_wavelength(channel) - attenuated_backscatter_range
Type: byte Dimensions: channel Variable_Type: Mandatory Description: Bitmask to identify total attenuated backscatter range type Units: – Definition: byte attenuated_backscatter_range(channel) - attenuated_backscatter_scatterers
Type: byte Dimensions: channel Variable_Type: Mandatory Description: Bitmask to identify total attenuated backscatter scatterer type Units: – Definition: byte attenuated_backscatter_scatterers(channel) - attenuated_backscatter_detection_mode
Type: byte Dimensions: channel Variable_Type: Mandatory Description: Bitmask to identify total attenuated backscatter detection mode Units: – Definition: byte attenuated_backscatter_detection_mode(channel) - 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) - attenuated_backscatter
Type: double Dimensions: channel, time, level Variable_Type: Mandatory Description: Total attenuated baskcatter timeseries Units: 1/(m*sr) Definition: double attenuated_backscatter(channel, time, level) - attenuated_backscatter_statistical_error
Type: double Dimensions: channel, time, level Variable_Type: Mandatory Description: Statistical error (uncertainty) on total attenuated backscatter timeseries Units: 1/(m*sr) Definition: double attenuated_backscatter_statistical_error(channel, time, level) - attenuated_backscatter_systematic_error
Type: double Dimensions: channel, time, level Variable_Type: Optional Description: Systematic error (uncertainty) on total attenuated backscatter timeseries Units: – Definition: double attenuated_backscatter_systematic_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) - cloud_mask_type
Type: byte Dimensions: – Variable_Type: Optional Description: Bimask describing the cloudmask type Units: – Definition: byte cloud_mask_type - cloud_mask
Type: byte Dimensions: time, level Variable_Type: Optional Description: Bimask 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: Optional Description: Atmospheric temperature Units: K Definition: double temperature(time, level) - pressure
Type: double Dimensions: time, level Variable_Type: Optional Description: Atmospheric pressure Units: mbar Definition: double pressure(time, level) - molecular_calculation_source
Type: byte Dimensions: – Variable_Type: Optional Description: Source used to compute the atmospheric molecular density Units: – Definition: byte molecular_calculation_source - 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: Optional 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: Optional 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: Optional 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: Optional 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: Optional 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) - atmospheric_background
Type: double Dimensions: channel, time Variable_Type: Optional Description: Mean atmospheric background calculated from lidar signal Units: 1/(m^3*sr) Definition: double atmospheric_background(channel, time) - atmospheric_background_stdev
Type: double Dimensions: channel, time Variable_Type: Optional Description: Standard deviation of atmospheric background calculated from lidar signal Units: 1/(m^3*sr) Definition: double atmospheric_background_stdev(channel, time) - atmospheric_background_sterr
Type: double Dimensions: channel, time Variable_Type: Optional Description: Standard error of atmospheric background calculated from lidar signal Units: 1/(m^3*sr) Definition: double atmospheric_background_sterr(channel, time) - atmospheric_background_min
Type: double Dimensions: channel, time Variable_Type: Optional Description: Minimum atmospheric background calculated from lidar signal Units: 1/(m^3*sr) Definition: double atmospheric_background_min(channel, time) - atmospheric_background_max
Type: double Dimensions: channel, time Variable_Type: Optional Description: Maximum atmospheric background calculated from lidar signal Units: 1/(m^3*sr) Definition: double atmospheric_background_max(channel, time) - volume_linear_depolarization_ratio_channel_id
Type: int Dimensions: depolarization, nc Variable_Type: Optional Description: SCC channel ID list involved in the calculation of the volume linear depolarization ratio timeseries Units: – Definition: int volume_linear_depolarization_ratio_channel_id(depolarization, nc) - volume_linear_depolarization_ratio_channel_name
Type: string Dimensions: depolarization Variable_Type: Optional Description: Channel name for volume linear depolarization ration timeseries Units: – Definition: string volume_linear_depolarization_ratio_channel_name(depolarization) - volume_linear_depolarization_ratio_wavelength
Type: double Dimensions: depolarization Variable_Type: Optional Description: Wavelength at which the volume linear depolarization ratio is calculated Units: nm Definition: double volume_linear_depolarization_ratio_wavelength(depolarization) - volume_linear_depolarization_ratio_range
Type: byte Dimensions: depolarization Variable_Type: Optional Description: Bitmask field indicating the volume linear depolarization range type Units: – Definition: byte volume_linear_depolarization_ratio_range(depolarization) - volume_linear_depolarization_ratio_scatterers
Type: byte Dimensions: depolarization Variable_Type: Optional Description: Bitmask field indicating the volume linear depolarization scatteter type Units: – Definition: byte volume_linear_depolarization_ratio_scatterers(depolarization) - volume_linear_depolarization_ratio
Type: double Dimensions: depolarization, time, level Variable_Type: Optional Description: Volume linear depolarization ratio timeseries Units: – Definition: double volume_linear_depolarization_ratio(depolarization, time, level) - volume_linear_depolarization_ratio_statistical_error
Type: double Dimensions: depolarization, time, level Variable_Type: Optional Description: Statistical error (uncertanity) on volume linear depolarization ratio timeseries Units: – Definition: double volume_linear_depolarization_ratio_statistical_error(depolarization, time, level) - volume_linear_depolarization_ratio_systematic_error
Type: double Dimensions: depolarization, time, level Variable_Type: Optional Description: Systematic error (uncertanity) on volume linear depolarization ratio timeseries Units: – Definition: double volume_linear_depolarization_ratio_systematic_error(depolarization, time, level) - attenuated_backscatter_calibration
Type: double Dimensions: channel, time Variable_Type: Mandatory Description: Constant used to calibrate the total attenuated backscatter Units: – Definition: double attenuated_backscatter_calibration(channel, time) - attenuated_backscatter_calibration_statistical_error
Type: double Dimensions: channel, time Variable_Type: Mandatory Description: Statistical error (uncertainty) of the attenuated backscatter calibration Units: – Definition: double attenuated_backscatter_calibration_statistical_error(channel, time) - attenuated_backscatter_calibration_systematic_error
Type: double Dimensions: channel, time Variable_Type: Mandatory Description: Systematic error (uncertainty) of the attenuated backscatter calibration Units: – Definition: double attenuated_backscatter_calibration_sytematic_error(channel, time) - attenuated_backscatter_calibration_start_datetime
Type: double Dimensions: channel, ncal Variable_Type: Mandatory Description: Attenuated backscatter calibration measurement start datetime Units: seconds since 1970-01-01T00:00:00Z Definition: double attenuated_backscatter_calibration_start_datetime(channel, ncal) - attenuated_backscatter_calibration_stop_datetime
Type: double Dimensions: channel, ncal Variable_Type: Mandatory Description: Attenuated backscatter calibration measurement stop datetime Units: seconds since 1970-01-01T00:00:00Z Definition: double attenuated_backscatter_calibration_stop_datetime(channel, ncal) - attenuated_backscatter_calibration_measurementid
Type: string Dimensions: channel, ncal Variable_Type: Mandatory Description: Attenuated backscatter calibration measurementID Units: – Definition: string attenuated_backscatter_calibration_measurementid(channel, ncal) - attenuated_backscatter_calibration_id
Type: int Dimensions: channel, ncal Variable_Type: Mandatory Description: Attenuated backscatter calibration ID Units: – Definition: int attenuated_backscatter_calibration_id(channel, ncal)
ELIC 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)