Auxiliary_Calibration_ZWC_04_19

xml record "Auxiliary_Calibration_ZWC_04_19"
Auxiliary Calibration ZWC

idfield namedefinition
0List_of_Data_Set_Records
xml record
List of Data Set Records

attribute: count
xml string


idfield namedefinition
0Data_Set_Record
xml array[dim_0]
dim_0: determined automatically from xml file
xml record
Data Set Record

idfield namedefinition
0Start_of_Observation_Time
ascii timesize: 23
Start of observation time

unit: "s since 2000-01-01"

value: if(str(., 23) == "UTC=9999-12-31T23:59:59", +inf, if(str(., 23) == "UTC=0000-00-00T00:00:00", -inf, time(str(.), "'UTC='yyyy-MM-dd'T'HH:mm:ss|'TAI='yyyy-MM-dd'T'HH:mm:ss|'GPS='yyyy-MM-dd'T'HH:mm:ss|'UT1='yyyy-MM-dd'T'HH:mm:ss")))
ascii stringsize: 23
CCSDS ASCII datetime with time reference "RRR=YYYY-MM-DDThh:mm:ss". The reference RRR can be any of "UT1", "UTC", "TAI", or "GPS".
1Observation_Info
xml record
Obsevation information containing the attitude and geolocation

idfield namedefinition
0Latitude_of_DEM_Intersection
ascii double (double)
Latitude of DEM Intersection with instrument lineof-sight at the centre of the observation

unit: "1e-6 degrees_north"

converted unit: "degrees_north" (multiply by 1/1000000)

attribute: unit
ascii stringsize: 8
fixed value: "10-6DegN"

available: optional
1Longitude_of_DEM_Intersection
ascii double (double)
Longitude of DEM Intersection with instrument lineof-sight at the centre of the observation

unit: "1e-6 degrees_east"

converted unit: "degrees_east" (multiply by 1/1000000)

attribute: unit
ascii stringsize: 8
fixed value: "10-6DegE"

available: optional
2Argument_of_Latitude_of_DEM_Intersection
ascii double (double)
Argument of Latitude of DEM Intersection with instrument line-of-sight at the centre of the observation

unit: "1e-6 degrees"

converted unit: "degrees" (multiply by 1/1000000)

attribute: unit
ascii stringsize: 7
fixed value: "10-6Deg"

available: optional
3Roll_Angle
ascii double
Instrument roll angle in ECEF frame at the centre of the observation

unit: "degrees"

attribute: unit
ascii stringsize: 3
fixed value: "deg"

available: optional
4Pitch_Angle
ascii double
Instrument pitch angle in ECEF frame at the centre of the observation

unit: "degrees"

attribute: unit
ascii stringsize: 3
fixed value: "deg"

available: optional
5Yaw_Angle
ascii double
Instrument yaw angle in ECEF frame at the centre of the observation

unit: "deg"

attribute: unit
ascii stringsize: 3
fixed value: "deg"

available: optional
6Mie_Satellite_Range_to_Target
ascii array[25]
List of satellite range to target values for all Mie height bins of the observation

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional

ascii double
7Rayleigh_Satellite_Range_to_Target
ascii array[25]
List of satellite range to target values for all Rayleigh height bins of the observation

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional

ascii double
2ZWC_Result_Type
xml string
Enum indicating ZWC result type. One of Mie only (ZWC_Mie), Rayleigh only (ZWC_Rayleigh), or both (ZWC_Both)
3Mie_Ground_Correction_Velocity
ascii double
Mie ground correction velocityr. This value is filled in when ZWC_Result_Type is set to ZWC_Mie or ZWC_Both

unit: "m/s"

attribute: unit
ascii stringsize: 3
fixed value: "m/s"

available: optional
4Rayleigh_Ground_Correction_Velocity
ascii double
Rayleigh ground correction factor. This value is filled in when ZWC_Result_Type is set to ZWC_Rayleigh or ZWC_Both

unit: "m/s"

attribute: unit
ascii stringsize: 3
fixed value: "m/s"

available: optional
5Validity_Indicators
xml record
Validity Indicators

idfield namedefinition
0Min_Num_of_Mie_Ground_Echo_Measurements
ascii uint32
Minimum number of Mie ground wind measurements to validate ground correction factor
1Mie_Land_Useful_Signal_Lower_Threshold
ascii double
Threshold applied to coadded gound signal of a measurement if the surface indicates land surface. If the threshold is met, the signal is added to the sum of the ground signal on observation level

unit: "ACCD counts"

attribute: unit
ascii stringsize: 11
fixed value: "ACCD counts"

available: optional
2Mie_Water_Useful_Signal_Lower_Threshold
ascii double
Threshold applied to coadded gound signal of a measurement if the surface indicates water/sea ice surface. If the threshold is met, the signal is added to the sum of the ground signal on observation level

unit: "ACCD counts"

attribute: unit
ascii stringsize: 11
fixed value: "ACCD counts"

available: optional
3Mie_Max_Ground_Echo_Bin_Thickness_Above_DEM
ascii double
Threshold applied to a bin identified as ground bin candidate. If the threshold is not met, the signal of the bin is not added to the sum of the ground signal on observation level

unit: "meters"

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional
4Min_Num_of_Rayleigh_Ground_Echo_Measurements
ascii uint32
Minimum number of Rayleigh ground wind measurements to validate ground correction factor
5Rayleigh_Land_Useful_Signal_Lower_Threshold
ascii double
Threshold applied to coadded gound signal of a measurement if the surface indicates land surface. If the threshold is met, the signal is added to the sum of the ground signal on observation level

unit: "ACCD counts"

attribute: unit
ascii stringsize: 11
fixed value: "ACCD counts"

available: optional
6Rayleigh_Water_Useful_Signal_Lower_Threshold
ascii double
Threshold applied to coadded gound signal of a measurement if the surface indicates water/sea ice surface. If the threshold is met, the signal is added to the sum of the ground signal on observation level

unit: "ACCD counts"

attribute: unit
ascii stringsize: 11
fixed value: "ACCD counts"

available: optional
7Rayleigh_Max_Ground_Echo_Bin_Thickness_Above_DEM
ascii double
Threshold applied to a bin identified as ground bin candidate. If the threshold is not met, the signal of the bin is not added to the sum of the ground signal on observation level

unit: "meters"

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional
8Number_of_Mie_Ground_Measurements
ascii uint32
Number of Mie measurements with detected ground echo
9Number_of_Rayleigh_Ground_Measurements
ascii uint32
Number of Rayleigh measurements with detected ground echo
10Mie_Average_Ground_Echo_Bin_Thickness
ascii double
Average of measurement ground wind bin altitudes for Mie

unit: "meters"

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional
11Rayleigh_Average_Ground_Echo_Bin_Thickness
ascii double
Average of measurement ground wind bin altitudes for Rayleigh

unit: "meters"

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional
12Mie_Average_Ground_Echo_Bin_Thickness_Above_DEM
ascii double
Average ground wind bin thickness (air column height) for Mie

unit: "meters"

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional
13Rayleigh_Average_Ground_Echo_Bin_Thickness_Above_DEM
ascii double
Average ground wind bin thickness (air column height) for Rayleigh

unit: "meters"

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional
14Mie_Min_Top_Ground_Bin
ascii int32
Highest of all the ground bins detected in all the measurements used in that observation. (Highest bin is bin number 1.) Value is set to 0 in case ground could not be detected in any measurement of the observation
15Rayleigh_Min_Top_Ground_Bin
ascii int32
Highest of all the ground bins detected in all the measurements used in that observation. (Highest bin is bin number 1.) Value is set to 0 in case ground could not be detected in any measurement of the observation
16Mie_Max_Bottom_Ground_Bin
ascii int32
Lowest of all the ground bins detected in all the measurements used in that observation. (Lowest bin is bin number 24.) Value is set to 0 in case ground could not be detected in any measurement of the observation
17Rayleigh_Max_Bottom_Ground_Bin
ascii int32
Lowest of all the ground bins detected in all the measurements used in that observation. (Lowest bin is bin number 24.) Value is set to 0 in case ground could not be detected in any measurement of the observation
18Mie_Ground_FWHM
ascii double
Mie Core 2 output FWHM when applied to observation level Mie ground signal. This value is filled in when ZWC_Result_Type is set to ZWC_Mie or ZWC_Both and the Mie Core 2 algorithm has been applied. In all other cases the value is set to 0.0

unit: "ACCD pixel"

attribute: unit
ascii stringsize: 10
fixed value: "ACCD pixel"

available: optional
19Mie_Ground_Useful_Signal
ascii double
Useful signal of observation level Mie ground signal. This value is filled in when ZWC_Result_Type is set to ZWC_Mie or ZWC_Both. In all other cases the value is set to 0.0

unit: "ACCD counts"

attribute: unit
ascii stringsize: 11
fixed value: "ACCD counts"

available: optional
20Mie_Ground_Signal_to_Noise_Ratio
ascii double
Signal to noise ratio of observation level Mie ground signal. This value is filled in when ZWC_Result_Type is set to ZWC_Mie or ZWC_Both. In all other cases the value is set to 0.0
21Mie_Ground_Refined_Signal_to_Noise_Ratio
ascii double
Refined signal to noise ratio of observation level Mie ground signal. This value is filled in when ZWC_Result_Type is set to ZWC_Mie or ZWC_Both. In all other cases the value is set to 0.0
22Rayleigh_Ground_Useful_Signal
ascii double
Useful signal of observation level Rayleigh ground signal. This value is filled in when ZWC_Result_Type is set to ZWC_Rayleigh or ZWC_Both. In all other cases the value is set to 0.0

unit: "ACCD counts"

attribute: unit
ascii stringsize: 11
fixed value: "ACCD counts"

available: optional
23Rayleigh_Ground_Signal_to_Noise_Ratio
ascii double
Signal to noise ratio of observation level Rayleigh ground signal. This value is filled in when ZWC_Result_Type is set to ZWC_Rayleigh or ZWC_Both. In all other cases the value is set to 0.0
24Mie_Measurement_Validity_Indicators
xml record
idfield namedefinition
0Measurement_Used
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
TRUE if measurement ground bin was detected, velocity calculated and used for average of ground correction value on observation level

mapping: "FALSE" -> 0

mapping: "False" -> 0

mapping: "false" -> 0

mapping: "TRUE" -> 1

mapping: "True" -> 1

mapping: "true" -> 1
1Expected_Ground_Bin_Index
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
Expected DEM ground bin
2Topocentric_Elevation_Expected_Ground_Bin
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 3
fixed value: "deg"

available: optional

ascii double
Topocentric elevation of the expected ground bin

unit: "degrees"
3Top_Ground_Bin
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
Highest detected bin with ground return signal. Value is set to 0 in case ground could not be detected in the measurement
4Topocentric_Elevation_Top_Ground_Bin
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 3
fixed value: "deg"

available: optional

ascii double
Topocentric elevation of the highest detected ground bin

unit: "degrees"
5Bottom_Ground_Bin
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
Lowest detected bin with ground return signal. Value is set to 0 in case ground could not be detected in the measurement
6Topocentric_Elevation_Bottom_Ground_Bin
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 3
fixed value: "deg"

available: optional

ascii double
Topocentric elevation of the lowest detected ground bin

unit: "degrees"
7Height_Difference_Expected_to_Top
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional

ascii double
Height difference between detected top ground bin and expected ground bin, with reference to centre altitude of bins

unit: "meters"
8Height_Difference_Expected_to_Bottom
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional

ascii double
Height difference between detected bottom ground bin and expected ground bin, with reference to centre altitude of bins

unit: "meters"
9Mean_Ground_Bin_SNR
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii double
Mean SNR over SNR values of detected ground bins
10Num_Top_Ground_Bins_Discarded
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
Number of bins above expected bin in which ground return signal was detected, but offset to expected bin was larger than threshold
11Num_Bottom_Ground_Bins_Discarded
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
Number of bins below expected bin in which ground return signal was detected, but offset to expected bin was larger than threshold
25Rayleigh_Measurement_Validity_Indicators
xml record
idfield namedefinition
0Measurement_Used
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
TRUE if measurement ground bin was detected, velocity calculated and used for average of ground correction value on observation level

mapping: "FALSE" -> 0

mapping: "False" -> 0

mapping: "false" -> 0

mapping: "TRUE" -> 1

mapping: "True" -> 1

mapping: "true" -> 1
1Expected_Ground_Bin_Index
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
Expected DEM ground bin
2Topocentric_Elevation_Expected_Ground_Bin
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 3
fixed value: "deg"

available: optional

ascii double
Topocentric elevation of the expected ground bin

unit: "degrees"
3Top_Ground_Bin
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
Highest detected bin with ground return signal. Value is set to 0 in case ground could not be detected in the measurement
4Topocentric_Elevation_Top_Ground_Bin
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 3
fixed value: "deg"

available: optional

ascii double
Topocentric elevation of the highest detected ground bin

unit: "degrees"
5Bottom_Ground_Bin
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
Lowest detected bin with ground return signal. Value is set to 0 in case ground could not be detected in the measurement
6Topocentric_Elevation_Bottom_Ground_Bin
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 3
fixed value: "deg"

available: optional

ascii double
Topocentric elevation of the lowest detected ground bin

unit: "degrees"
7Height_Difference_Expected_to_Top
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional

ascii double
Height difference between detected top ground bin and expected ground bin, with reference to centre altitude of bins

unit: "meters"
8Height_Difference_Expected_to_Bottom
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional

ascii double
Height difference between detected bottom ground bin and expected ground bin, with reference to centre altitude of bins

unit: "meters"
9Channel_A_Mean_Ground_Bin_SNR
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii double
Mean SNR over SNR values of detected ground bins
10Channel_B_Mean_Ground_Bin_SNR
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii double
Mean SNR over SNR values of detected ground bins
11Num_Top_Ground_Bins_Discarded
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
Number of bins above expected bin in which ground return signal was detected, but offset to expected bin was larger than threshold
12Num_Bottom_Ground_Bins_Discarded
ascii array[dim_0]
dim_0: int(str(../../../Measurement_Info/List_of_Measurement_Range_Infos@count))
ascii uint8
Number of bins below expected bin in which ground return signal was detected, but offset to expected bin was larger than threshold
6Measurement_Info
xml record
idfield namedefinition
0DEM_Height
ascii array[dim_0]
This list contains N_Meas values separated by blanks. The items in this list refer to the altitude of the DEM intersection of the measurements 1 .. N_Meas of the observation.

dim_0: int(str(../List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional

ascii double
unit: "m"
1Surface_Type
ascii array[dim_0]
This list contains N_Meas values separated by blanks. The items in this list refer to the altitude of the DEM intersection of the measurements 1 .. N_Meas of the observation.

dim_0: int(str(../List_of_Measurement_Range_Infos@count))

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional

ascii uint8
2List_of_Measurement_Range_Infos
xml record
attribute: count
xml string


idfield namedefinition
0Measurement_Range_Info
xml array[dim_0]
dim_0: determined automatically from xml file
xml record
idfield namedefinition
0Satellite_Range_to_Target_Mie
ascii array[25]
This list contains 25 values, separated by blanks. The first item contains the range from satellite to the upper edge of the top-most Mie lidar measurement range bin. The remaining 24 items contain the height of the lower edge of each lidar measurement range bin.

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional

ascii uint32
1Satellite_Range_to_Target_Rayleigh
ascii array[25]
This list contains 25 values, separated by blanks. The first item contains the range from satellite to the upper edge of the top-most Rayleigh lidar measurement range bin. The remaining 24 items contain the height of the lower edge of each lidar measurement range bin.

attribute: unit
ascii stringsize: 1
fixed value: "m"

available: optional

ascii uint32