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