giuseppe@125: ELDEC Products giuseppe@125: -------------- giuseppe@125: giuseppe@125: This section describe the structure of ELDEC products. giuseppe@125: giuseppe@125: giuseppe@125: ELDEC Products: dimensions giuseppe@125: ~~~~~~~~~~~~~~~~~~~~~~~~~~ giuseppe@125: giuseppe@125: The following dimensions are defined in ELDEC products: giuseppe@125: giuseppe@125: - time giuseppe@125: - altitude giuseppe@125: - ratio giuseppe@125: - calibration giuseppe@125: - nv giuseppe@125: giuseppe@125: The dimension *time* (mandatory) specifies the number of calibration performed at different times. giuseppe@125: giuseppe@125: The dimension *altitude* (mandatory) represents the number of rangebins characterizing giuseppe@125: the reflected to transmitted polarization calibration ratio. giuseppe@125: giuseppe@125: The dimension *ratio* (mandatory) indicates the number reflected to transmitted ratios included in the product. giuseppe@125: giuseppe@125: The dimension *calibration* indicates the number of calibrations provided by the product. giuseppe@125: giuseppe@125: The dimension *nv* (mandatory) is ancillary and it is always set to 2. giuseppe@125: giuseppe@125: giuseppe@125: giuseppe@125: ELDEC Products: variables giuseppe@125: ~~~~~~~~~~~~~~~~~~~~~~~~~ giuseppe@125: giuseppe@125: latitude giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: measurement site latitude giuseppe@125: :Units: degrees_north giuseppe@125: :Definition: *double latitude* giuseppe@125: giuseppe@125: longitude giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: measurement site longitude giuseppe@125: :Units: degrees_east giuseppe@125: :Definition: *double longitude* giuseppe@125: giuseppe@125: station\_altitude giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: station altitude above see level giuseppe@125: :Units: m giuseppe@125: :Definition: *double station\_altitude* giuseppe@125: giuseppe@125: altitude giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *altitude* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: altitude above see level giuseppe@125: :Units: m giuseppe@125: :Definition: *double altitude(altitude)* giuseppe@125: giuseppe@125: range giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *altitude* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: lidar range scale giuseppe@125: :Units: m giuseppe@125: :Definition: *double range(altitude)* giuseppe@125: giuseppe@125: shots giuseppe@125: :Type: *int* giuseppe@125: :Dimensions: *time* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: accumulated laser shots giuseppe@125: :Units: -- giuseppe@125: :Definition: *int shots(time)* giuseppe@125: giuseppe@125: time giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *time* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: seconds since 1970-01-01T00:00:00Z giuseppe@125: :Units: -- giuseppe@125: :Definition: *double time(time)* giuseppe@125: giuseppe@125: time\_bounds giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *time, nv* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: seconds since 1970-01-01T00:00:00Z giuseppe@125: :Units: -- giuseppe@125: :Definition: *double time\_bounds(time,nv)* giuseppe@125: giuseppe@125: scc\_product\_type giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Bitmask describing the SCC product type giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte scc\_product\_type* giuseppe@125: giuseppe@125: polarization\_calibration\_ratio\_emission\_wavelength giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *ratio* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Emission wavelength of the reflected to transmitted polarization calibration giuseppe@125: :Units: *nm* giuseppe@125: :Definition: *double polarization\_calibration\_ratio\_emission\_wavelength(ratio)* giuseppe@125: giuseppe@125: polarization\_calibration\_ratio\_detection\_wavelength giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *ratio* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Detection wavelength of the reflected to transmitted polarization calibration giuseppe@125: :Units: *nm* giuseppe@125: :Definition: *double polarization\_calibration\_ratio\_detection\_wavelength(ratio)* giuseppe@125: giuseppe@125: polarization\_calibration\_ratio\_range giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: *ratio* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Bitmask to identify the reflected to transmitted polarization calibration ratio range type giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte polarization\_calibration\_ratio\_range(ratio)* giuseppe@125: giuseppe@125: polarization\_calibration\_ratio\_configuration giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: *ratio* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Bitmask to identify the reflected to transmitted polarization calibration ratio configuration type giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte polarization\_calibration\_ratio\_configuration(ratio)* giuseppe@125: giuseppe@125: polarization\_calibration\_ratio giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *ratio, time, altitude* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Uncalibrated reflected to transmitted polarization calibration ratio giuseppe@125: :Units: -- giuseppe@125: :Definition: *double polarization\_calibration\_ratio(ratio, time, altitude)* giuseppe@125: giuseppe@125: polarization\_calibration\_ratio\_statistical\_error giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *ratio, time, altitude* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Statistical error (uncertainty) on uncalibrated reflected to transmitted polarization calibration ratio giuseppe@125: :Units: -- giuseppe@125: :Definition: *double polarization\_calibration\_ratio\_statistical\_error(ratio, time, altitude)* giuseppe@125: giuseppe@125: polarization\_calibration\_ratio\_systematic\_error giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *ratio, time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Systematic error (uncertainty) on uncalibrated reflected to transmitted polarization calibration ratio giuseppe@125: :Units: -- giuseppe@125: :Definition: *double polarization\_calibration\_ratio\_statistical\_error(ratio, time, altitude)* giuseppe@125: giuseppe@125: polarization\_calibration\_minimum\_range giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *ratio* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Minimum altitude to consider for polarization calibration giuseppe@125: :Units: *m* giuseppe@125: :Definition: *double polarization\_calibration\_minimum\_range(ratio)* giuseppe@125: giuseppe@125: giuseppe@125: polarization\_calibration\_maximum\_range giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *ratio* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Maximum altitude to consider for polarization calibration giuseppe@125: :Units: *m* giuseppe@125: :Definition: *double polarization\_calibration\_maximum\_range(ratio)* giuseppe@125: giuseppe@125: polarization\_calibration\_ratio\_average giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *ratio, time* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Average of the polarization calibration ratio within the calibration range giuseppe@125: :Units: -- giuseppe@125: :Definition: *double polarization\_calibration\_ratio\_average(ratio, time)* giuseppe@125: giuseppe@125: polarization\_calibration\_ratio\_average\_statistical_error giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *ratio, time* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Statistical error (uncertainty) on the average of the polarization calibration ratio within the calibration range giuseppe@125: :Units: -- giuseppe@125: :Definition: *double polarization\_calibration\_ratio\_average\_statistical\_error(ratio, time)* giuseppe@125: giuseppe@125: polarization\_calibration\_ratio\_average\_systematic_error giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *ratio, time* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Systematic error (uncertainty) on the average of the polarization calibration ratio within the calibration range giuseppe@125: :Units: -- giuseppe@125: :Definition: *double polarization\_calibration\_ratio\_average\_systematic\_error(ratio, time)* giuseppe@125: giuseppe@125: polarization\_gain\_factor\_wavelength giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *calibration* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Polarization gain factor wavelength giuseppe@125: :Units: *nm* giuseppe@125: :Definition: *double polarization\_gain\_factor\_wavelength(calibration)* giuseppe@125: giuseppe@125: polarization\_gain\_factor\_range giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: *calibration* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Bitmask to describe the polarization gain factor range type giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte polarization\_gain\_factor\_range(calibration)* giuseppe@125: giuseppe@125: giuseppe@125: polarization\_gain\_factor giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *calibration, time* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Polarization gain factor (eta*) giuseppe@125: :Units: -- giuseppe@125: :Definition: *double polarization\_gain\_factor(calibration, time)* giuseppe@125: giuseppe@125: polarization\_gain\_factor\_statistical\_error giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *calibration, time* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Statistical error (uncertainty) on polarization gain factor (eta*) giuseppe@125: :Units: -- giuseppe@125: :Definition: *double polarization\_gain\_factor\_statistical\_error(calibration, time)* giuseppe@125: giuseppe@125: polarization\_gain\_factor\_systematic\_error giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *calibration, time* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Systematic error (uncertainty) on polarization gain factor (eta*) giuseppe@125: :Units: -- giuseppe@125: :Definition: *double polarization\_gain\_factor\_systematic\_error(calibration, time)* giuseppe@125: giuseppe@125: giuseppe@125: ELDEC Products: global attributes giuseppe@125: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ giuseppe@125: giuseppe@125: Conventions giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: List of the conventions the product is compliant to giuseppe@125: giuseppe@125: giuseppe@125: title giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Product title giuseppe@125: giuseppe@125: source giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: String describing the source used to generate the product giuseppe@125: giuseppe@125: references giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Reference(s) for data processing giuseppe@125: location giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Measurement site location giuseppe@125: giuseppe@125: station_ID giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Unique 3 digit code identifying SCC station giuseppe@125: giuseppe@125: PI giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: PI full name giuseppe@125: giuseppe@125: PI\_affiliation giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: PI complete affiliation giuseppe@125: giuseppe@125: PI\_affiliation_acronym giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: PI affiliation acronym giuseppe@125: giuseppe@125: PI\_address giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Optional giuseppe@125: :Description: PI address giuseppe@125: giuseppe@125: PI\_phone giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Optional giuseppe@125: :Description: PI phone number giuseppe@125: giuseppe@125: PI\_email giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: PI e-mail giuseppe@125: giuseppe@125: Data\_Originator giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Data originator full name giuseppe@125: giuseppe@125: Data\_Originator\_affiliation giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Data originator complete affiliation giuseppe@125: giuseppe@125: Data\_Originator\_affiliation\_acronym giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Data originator affiliation acronym giuseppe@125: giuseppe@125: Data\_Originator\_address giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Optional giuseppe@125: :Description: Data originator complete address giuseppe@125: giuseppe@125: Data\_Originator\_phone giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Optional giuseppe@125: :Description: Data originator phone number giuseppe@125: giuseppe@125: Data\_Originator\_email giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Data originator e-mail address giuseppe@125: giuseppe@125: institution giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Istitution the product belong to giuseppe@125: giuseppe@125: system giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Name of the measuring instrument (lidar) giuseppe@125: giuseppe@125: hoi\_system\_ID giuseppe@125: :Type: *int* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Numeric ID identifying the measuring system in the ACTRIS/EARLINET Handbook Of Instrument (HOI) giuseppe@125: giuseppe@125: hoi\_configuration\_ID; giuseppe@125: :Type: *int* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Numeric ID identifying the configuration of the measuring system in the ACTRIS/EARLINET Handbook Of Instrument (HOI) giuseppe@125: giuseppe@125: measurement\_ID; giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Alphanumeric identifier for the raw data measurements use to generate the product giuseppe@125: giuseppe@125: measurement\_start\_datetime giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Measurement start datetime YYYY-mm-ddTHH:MM:SSZ giuseppe@125: giuseppe@125: measurement\_stop\_datetime giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Measruement stop datetime YYYY-mm-ddTHH:MM:SSZ giuseppe@125: giuseppe@125: comment giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Optional giuseppe@125: :Description: Any product comments giuseppe@125: giuseppe@125: scc\_version\_description giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Extended SCC version description giuseppe@125: giuseppe@125: scc\_version giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: SCC version number giuseppe@125: giuseppe@125: processor\_name giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Name of the processor used to generate the product giuseppe@125: giuseppe@125: processor\_version giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Version of the processor used to generate the product giuseppe@125: giuseppe@125: history giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Field describing the history of the product giuseppe@125: giuseppe@125: \_\_file\_format_version giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Version of the product file format giuseppe@125: giuseppe@125: data\_processing\_institution giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Instituion responsible for data processing giuseppe@125: giuseppe@125: input\_file giuseppe@125: :Type: *string* giuseppe@125: :Global\_Attribute\_Type: Mandatory giuseppe@125: :Description: Filename of the input data product used to generate the current product