Mercurial > public > sccdocs / file revision

ELPP Products
----------------

This section describe the structure of ELPP products.


ELPP Products: dimensions
~~~~~~~~~~~~~~~~~~~~~~~~~

The following dimensions are defined in ELPP 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.


ELPP 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)*

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)*		

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: Mandatory	
   :Description: Atmospheric temperature
   :Units: K		 
   :Definition: *double temperature(time, level)*

pressure		
   :Type: *double*
   :Dimensions: *time, level*
   :Variable\_Type: Mandatory	
   :Description: Atmospheric pressure
   :Units: mbar		 
   :Definition: *double pressure(time, level)*
		
molecular\_calculation\_source        
   :Type: *byte*
   :Dimensions: --
   :Variable\_Type: Mandatory	
   :Description: Source used to compute the atmospheric molecular density
   :Units: --		 
   :Definition: *byte molecular_calculation_source*             
	
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)*

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: Mandatory	
   :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: Mandatory	
   :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: Mandatory	
   :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: Mandatory	
   :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: Mandatory	 
   :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)*

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)* 

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)* 		
	


ELPP 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)