giuseppe@125: ELDA Products giuseppe@125: ---------------- giuseppe@125: giuseppe@125: This section describe the structure of ELDA products. giuseppe@125: giuseppe@125: giuseppe@125: ELPP Products: dimensions giuseppe@125: ~~~~~~~~~~~~~~~~~~~~~~~~~ giuseppe@125: giuseppe@125: Aerosol optical products have the wavelength dimension (accommodating products at different wavelength in the same variable) and time dimension (accommodating different profiles in the same time series). The altitude dimension is defined for reporting the information as a function of the altitude. The dimension nv is used following the cf convention whenever a bound is needed for some evaluation. In our case nv is used for defining variables which have per definition some bounds as time_bounds reported below. giuseppe@125: giuseppe@125: The following dimensions are defined in ELDA products: giuseppe@125: giuseppe@125: - time giuseppe@125: - altitude giuseppe@125: - wavelength giuseppe@125: - nv giuseppe@125: giuseppe@125: The dimension *time* (mandatory) specifies the number of vertical profiles included in the product timeseries. giuseppe@125: giuseppe@125: The dimension *altitude* (mandatory) represents the number of rangebins characterizing each vertical profile giuseppe@125: giuseppe@125: The dimension *wavelength* (mandatory) indicates the number wavelengths for which the optical variables are provided 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: ELDA Products: variables giuseppe@125: ~~~~~~~~~~~~~~~~~~~~~~~~ giuseppe@125: giuseppe@125: latitude giuseppe@125: :Type: *float* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: measurement site latitude giuseppe@125: :Units: degrees_north giuseppe@125: :Definition: *float latitude* giuseppe@125: giuseppe@125: longitude giuseppe@125: :Type: *float* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: measurement site longitude giuseppe@125: :Units: degrees_east giuseppe@125: :Definition: *float longitude* giuseppe@125: giuseppe@125: station\_altitude giuseppe@125: :Type: *float* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: station altitude above see level giuseppe@125: :Units: m giuseppe@125: :Definition: *float 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: 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: 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: cloud\_mask\_type giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Bimask describing the cloudmask type giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte cloud_mask_type* giuseppe@125: giuseppe@125: cloud\_mask giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: *time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Bimask describing the cloudmask giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte cloud_mask(time, altitude)* giuseppe@125: giuseppe@125: vertical\_resolution giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *wavelength, time, altitude* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Effective vertical resolution according to Pappalardo et al., appl. opt. 2004 giuseppe@125: :Units: *m* giuseppe@125: :Definition: *double vertical\_resolution(wavelength, time, altitude)* giuseppe@125: giuseppe@125: giuseppe@125: cirrus\_contamination giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Do the profiles contain cirrus layers? giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte cirrus\_contamination* giuseppe@125: giuseppe@125: cirrus\_contamination\_source giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: How was cirrus_contamination obtained? giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte cirrus\_contamination\_source* giuseppe@125: giuseppe@125: giuseppe@125: error\_retrieval\_method giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: *wavelength* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Method used for the retrieval of erros (uncertainties) giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte error\_retrieval\_method(wavelength)* giuseppe@125: giuseppe@125: giuseppe@125: backscatter\_evaluation\_method giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: *wavelength* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Method used for the backscatter retrieval giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte backscatter\_evaluation\_method(wavelength)* giuseppe@125: giuseppe@125: elastic\_backscatter\_algorithm giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: *wavelength* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Algorithm used for the retrieval of the elastic backscatter profile giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte elastic\_backscatter\_algorithm(wavelength)* giuseppe@125: giuseppe@125: giuseppe@125: giuseppe@125: assumed\_particle\_lidar\_ratio giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *wavelength, time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Assumed particle lidar ratio for the elastic-only backscatter retrieval giuseppe@125: :Units: *sr* giuseppe@125: :Definition: *double assumed\_particle\_lidar\_ratio(wavelength, time, altitude)* giuseppe@125: giuseppe@125: giuseppe@125: backscatter giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *wavelength, time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Particle backscatter coefficient giuseppe@125: :Units: *1/(m\*sr)* giuseppe@125: :Definition: *double backscatter(wavelength, time, altitude)* giuseppe@125: giuseppe@125: error\_backscatter giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *wavelength, time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Absolute statistical error (unertanity) of particle backscatter coefficient giuseppe@125: :Units: *1/(m\*sr)* giuseppe@125: :Definition: *double error\_backscatter(wavelength, time, altitude)* giuseppe@125: giuseppe@125: extinction giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *wavelength, time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Particle extinction coefficient giuseppe@125: :Units: *1/m* giuseppe@125: :Definition: *double extinction(wavelength, time, altitude)* giuseppe@125: giuseppe@125: error\_extinction giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *wavelength, time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Absolute statistical error (unertanity) of particle extinction coefficient giuseppe@125: :Units: *1/m* giuseppe@125: :Definition: *double error\_extinction(wavelength, time, altitude)* giuseppe@125: giuseppe@125: volumedepolarization giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *wavelength, time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Volume linear depolarization ratio giuseppe@125: :Units: -- giuseppe@125: :Definition: *double volumedepolarization(wavelength, time, altitude)* giuseppe@125: giuseppe@125: error\_volumedepolarization giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *wavelength, time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Absolute statistical error (unertanity) of volume linear depolarization ratio giuseppe@125: :Units: *1/m* giuseppe@125: :Definition: *double error\_volumedepolarization(wavelength, time, altitude)* giuseppe@125: giuseppe@125: particledepolarization giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *wavelength, time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Particle linear depolarization ratio giuseppe@125: :Units: -- giuseppe@125: :Definition: *double particledepolarization(wavelength, time, altitude)* giuseppe@125: giuseppe@125: error\_particledepolarization giuseppe@125: :Type: *double* giuseppe@125: :Dimensions: *wavelength, time, altitude* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Absolute statistical error (unertanity) of particle linear depolarization ratio giuseppe@125: :Units: *1/m* giuseppe@125: :Definition: *double error\_particledepolarization(wavelength, time, altitude)* giuseppe@125: giuseppe@125: giuseppe@125: user\_defined\_category giuseppe@125: :Type: *int* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: User defined category of the measurement giuseppe@125: :Units: -- giuseppe@125: :Definition: *int user\_defined_category* giuseppe@125: giuseppe@125: giuseppe@125: molecular\_calculation\_source giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Data source of the molecular calculations giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte molecular\_calculation\_source* giuseppe@125: giuseppe@125: giuseppe@125: backscatter\_calibration\_value giuseppe@125: :Type: *float* giuseppe@125: :Dimensions: *wavelength* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Assumed backscatter-ratio value (unitless) in calibration range giuseppe@125: :Units: -- giuseppe@125: :Definition: *float backscatter\_calibration\_value(wavelength)* giuseppe@125: giuseppe@125: backscatter\_calibration\_search\_range giuseppe@125: :Type: *float* giuseppe@125: :Dimensions: *wavelength, nv* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Height range wherein calibration range is searched giuseppe@125: :Units: *m* giuseppe@125: :Definition: *float backscatter\_calibration\_search\_range(wavelength, nv)* giuseppe@125: giuseppe@125: wavelength giuseppe@125: :Type: *float* giuseppe@125: :Dimensions: *wavelength* giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Wavelength of the transmitted laser pulse giuseppe@125: :Units: *nm* giuseppe@125: :Definition: *float wavelength(wavelength)* giuseppe@125: giuseppe@125: zenith\_angle giuseppe@125: :Type: *float* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Laser pointing angle with respect to the zenith giuseppe@125: :Units: *degrees* giuseppe@125: :Definition: *float zenith\_angle* giuseppe@125: giuseppe@125: giuseppe@125: earlinet_product_type giuseppe@125: :Type: *int* giuseppe@125: :Dimensions: -- giuseppe@125: :Variable\_Type: Mandatory giuseppe@125: :Description: Earlinet product type giuseppe@125: :Units: -- giuseppe@125: :Definition: *int earlinet_product_type* giuseppe@125: giuseppe@125: backscatter\_calibration\_range_search\_algorithm giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: *wavelength* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Algorithm used for the search of the calibration_range giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte backscatter\_calibration\_range\_search\_algorithm(wavelength)* giuseppe@125: giuseppe@125: giuseppe@125: giuseppe@125: backscatter\_calibration\_range giuseppe@125: :Type: *float* giuseppe@125: :Dimensions: *wavelength, nv* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Height range where calibration was calculated giuseppe@125: :Units: *m* giuseppe@125: :Definition: *float backscatter\_calibration\_range(wavelength, nv)* giuseppe@125: giuseppe@125: raman\_backscatter\_algorithm giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: *wavelength* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Algorithm used for the retrieval of the Raman backscatter profile giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte raman\_backscatter\_algorithm(wavelength)* giuseppe@125: giuseppe@125: extinction\_evaluation\_algorithm giuseppe@125: :Type: *byte* giuseppe@125: :Dimensions: *wavelength* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Algorithm used for the extinction retrieval giuseppe@125: :Units: -- giuseppe@125: :Definition: *byte extinction\_evaluation\_algorithm(wavelength)* giuseppe@125: giuseppe@125: extinction\_assumed\_wavelength\_dependence giuseppe@125: :Type: *float* giuseppe@125: :Dimensions: *wavelength* giuseppe@125: :Variable\_Type: Optional giuseppe@125: :Description: Assumed wavelength dependence for particle extinction retrieval giuseppe@125: :Definition: *float extinction\_assumed\_wavelength\_dependence(wavelength)* 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: giuseppe@125: giuseppe@125: ELDA 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