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

