docs/file_formats/elic_product_format.rst

changeset 125
003aa42747f5
child 136
a5059b423ea1
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/file_formats/elic_product_format.rst	Fri Mar 19 13:43:18 2021 +0100
@@ -0,0 +1,879 @@
+
+
+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

mercurial