HiRELPP Products¶
This section describe the structure of HiRELPP products.
HiRELPP Products: dimensions¶
The following dimensions are defined in HiRELPP 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.
HiRELPP 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 - 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) - 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) - atmospheric_background
Type: double Dimensions: channel, time Variable_Type: Mandatory Description: Mean uncalibrated atmospheric background calculated from lidar signal Units: – Definition: double atmospheric_background(channel, time) - atmospheric_background_stdev
Type: double Dimensions: channel, time Variable_Type: Mandatory Description: Standard deviation of uncalibrated atmospheric background calculated from lidar signal Units: – Definition: double atmospheric_background_stdev(channel, time) - atmospheric_background_sterr
Type: double Dimensions: channel, time Variable_Type: Mandatory Description: Standard error of uncalibrated atmospheric background calculated from lidar signal Units: – Definition: double atmospheric_background_sterr(channel, time) - atmospheric_background_min
Type: double Dimensions: channel, time Variable_Type: Mandatory Description: Minimum uncalibrated atmospheric background calculated from lidar signal Units: – Definition: double atmospheric_background_min(channel, time) - atmospheric_background_max
Type: double Dimensions: channel, time Variable_Type: Mandatory Description: Maximum uncalibrated atmospheric background calculated from lidar signal Units: – Definition: double atmospheric_background_max(channel, time) - 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) - 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) - 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)
HiRELPP 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