docs/data_processing/pre_exit_codes.rst

Fri, 25 Mar 2022 15:54:53 +0100

author
Giuseppe D'Amico <giuseppe.damico@imaa.cnr.it>
date
Fri, 25 Mar 2022 15:54:53 +0100
changeset 136
a5059b423ea1
parent 129
a059b0d40a80
permissions
-rw-r--r--

Added a missing global attribute in ELPP and ELIC product descriptions

Preprocessor exit codes
=======================
After a measurement is processed by the preprocessor, an exit code is provided
that can help you understand if everything went OK, and if not, what was the problem.
The implemented exit codes are the following.
 

0	
   Finished without errors

1	
   Failure in memory allocation

2	
   Configuration file not found

3	
   Configuration file error: INPUT_DIR not defined

4	
   Configuration file error: OUTPUT_DIR not defined

5	
   Configuration file error: Cannot read in INPUT_DIR

6	
   Configuration file error: Cannot write on OUTPUT_DIR

7	
   Configuration file error: Cannot read in SOUNDINGS_DIR

8	
   Configuration file error: Cannot read in OVERLAP_DIR

9	
   Configuration file error: Cannot read in LIDARRATIO_DIR

10	
   Configuration file error: Cannot write on LOG_DIR

12	
   Wrong usage in calling the script

13	
   Cannot create output directory

14	
   An internal error occurred

15	
   Configuration file error: Cannot read in CLOUDMASK_DIR

16	
   Configuration file error: Cannot read in CLOUDNET_DIR

17	
   Configuration file error: Cannot write on RAW_SKIPPING_DIR

18	
   Cannot create cloudnet output directory

19	
   Cannot read CA file

20	
   Found one or more channels defined in the product definition but not linked to the used system configuration. Please check that all the channels in your products are also linked to the used system configuration

21	
   Cannot connect to SCC_DB

22	
   Failed in quering SCC_DB

23	
   Failed in fetching query of SCC_DB

24	
   Found error(s) in SCC_DB for the submitted Measurement_ID

25	
   Measurement ID not found in the selected database

26	
   Measurement_ID not unique in the selected database

27	
   Unknown usecase in SCC_DB

28	
   One or more mandatory datetime field(s) are not set into the database

29	
   Found mismatch among usecase, product type and given channels

30	
   All the products associated to a system configuration should be processed with the same processor module.

40	
   Unknown product type in SCC_DB

41	
   Cannot open NetCDF input file

42	
   Dimension "time" not found in NetCDF input file

43	
   Dimension "channels" or "channel" not found in NetCDF input file

44	
   Dimension "points" not found in NetCDF input file

45	
   Dimension "scan_angles" not found in NetCDF input file

46	
   Global attribute "Measurement_ID" not found or not correctly defined in NetCDF input file

47	
   Incorrect definition of global attribute "Measurement_ID" in NetCDF input file

48	
   Global attribute "RawData_Start_Date" not found in NetCDF input file

49	
   Global attribute "RawData_Start_Time_UT" not found in NetCDF input file

50	
   Global attribute "RawData_Stop_Time_UT" not found in NetCDF input file

51	
   Variable "Laser_Pointing_Anlge" not found and/or not  defined correctly in NetCDF input file

52	
   "Laser_Pointing_Angle" variable cannot be undefined and should be between 0 and 90.

53	
   Variable "Laser_Pointing_Angle_of_Profiles" not found and/or not defined correctly in NetCDF input file

54	
   Variable "Laser_Shots" not found and/or not  defined correctly in NetCDF input file

55	
   Found negative or not defined value in "Laser_Shots" array

56	
   Cannot write intermediate NetCDF file

57	
   Variables "Pol_Calib_Range_Min" and/or "Pol_Calib_Range_Max" not found and/or not  defined correctly in NetCDF input file

58	
   Invalid values for variables "Pol_Calib_Range_Min" and/or "Pol_Calib_Range_Max" in NetCDF input file

70	
   Generic NetCDF error

71	
   Dimension "time" cannot be zero

72	
   Dimension "channels" cannot be zero

73	
   Dimension "points" cannot be zero

74	
   Natural cubic spline interpolation not possible

75	
   lfit: no parameters to be fitted

76	
   gaussj: Singular Matrix

77	
   Not correct type in NetCDF variable definition

78	
   Not correct number of dimensions in NetCDF variable definition

79	
   Not correct type in NetCDF global attribute definition

80	
   Found invalid value of latitude. Check the database value or the value reported in the raw NetCDF input file

81	
   Found invalid value of longitude. Check the database value or the value reported in the raw NetCDF input file

82	
   Found invalid value of altitude. Check the database value or the value reported in the raw NetCDF input file

83	
   Found invalid value of emission wavelength. Check the database value or the value reported in the raw NetCDF input file

84	
   Found invalid value of detection wavelength. Check the database value or the value reported in the raw NetCDF input file

101	
   Found wrong value for integration time in SCC_DB

102	
   Overlap file not registered in the database. Please register it and then re-run the SCC

103	
   Lidarratio file not registered in the database. Please register it and then re-run the SCC

104	
   Sounding file not registered in the database. Please register it and then re-run the SCC

105	
   Not all required depolarization calibrations is available in SCC_DB. Please submit at least one depolarizatio calibration measurement for each required calibration and link them to the product to be calibrated

106	
   Found no valid values for depolarization constant in the SCC_DB

107	
   Unkown depolarization calibration calculation method

108	
   No depolarization cross-talk correction factors (G and H) are available in SCC_DB for the depolarization channels. Please submit them

109	
   Found no valid values for depolarization cross-talk correction factors in the SCC_DB

110	
   No correction factor (K) for depolarization calibration is available in SCC_DB. Please provide at least one value for correction factor and link it to the product to be calibrated

111	
   Found no valid values for depolarization constant correction factor in the SCC_DB

112	
   Unkown depolarization correction factor calculation method

113	
   Found SCC_DB inconsistencies in the definition of transmitted depolarization channels. Please be sure that all the products containing the reflected depolarization channel includes the corresponding transmitted depolarization channel as well. Check also the signal type and the scattering type are set correctly.

114	
   Found SCC_DB inconsistencies in the definition of reflected depolarization channels. Please be sure that all the products containing the transmitted depolarization channel includes the corresponding reflected depolarization channel as well. Check also the signal type and the scattering type are set correctly.

115	
   For one or more polarization calibration parameters you have selected to use the option "Use the most recent available calibration previous to the measurement date". No calibrations according to this criteria has been found. So please select another calibration options of provide at least one calibration measurements with a date previous to the current measurement date.

121	
   Dimension "nb_of_time_scales" not found in NetCDF input file

122	
   Incorrect definition of global attribute "RawData_Start_Date" in NetCDF input file

123	
   Incorrect definition of global attribute "RawData_Start_Time_UT" in NetCDF input file

124	
   Incorrect definition of global attribute "RawData_Stop_Time_UT" in NetCDF input file

125	
   Variables "channel_string_ID" and/or "channel_ID" not found and/or not  defined correctly in the NetCDF input file

126	
   Missing one or more channels in NetCDF input file

127	
   Found wrong value(s) in variable "Background_Low" end/or "Background_High"

128	
   Variable "Background_Low" not found and/or not  defined correctly in NetCDF input file

129	
   Variable "Background_High" not found and/or not  defined correctly in NetCDF input file

130	
   Variable "id_timescale" not found and/or not  defined correctly in NetCDF input file

131	
   Variable "Raw_Data_Start_Time" not found and/or not  defined correctly in NetCDF input file

132	
   Variable "Raw_Data_Stop_Time" not found and/or not  defined correctly in NetCDF input file

133	
   Variable "Raw_Lidar_Data" not found and/or not  defined correctly in NetCDF input file

134	
   Found not integer values in photoncounting signal

135	
   Variable "Molecular_Calc" not found and/or not  defined correctly in NetCDF input file

136	
   Variable "Molecular_Calc" has not valid value

137	
   Variable "Pressure_at_Lidar_Station" not found and/or not  defined correctly in NetCDF input file

138	
   Variable "Temperature_at_Lidar_Station" not found and/or not  defined correctly in NetCDF input file

139	
   Found wrong value(s) for channel first signal range bin. Please check your SCC channels configuration of the variable "First_Signal_Rangebin" in NetCDF input file

140	
   Variable "DAQ_Range" not found and/or not  defined correctly in NetCDF input file

143	
   Variable "Raw_Bck_Start_Time" not found and/or not  defined correctly in NetCDF input file

144	
   Variable "Raw_Bck_Stop_Time" not found and/or not  defined correctly in NetCDF input file

145	
   Global attribute "RawBck_Start_Date" not found in NetCDF input file

146	
   Global attribute "RawBck_Start_Time_UT" not found in NetCDF input file

147	
   Global attribute "RawBck_Stop_Time_UT" not found in NetCDF input file

148	
   Found not compatible values of variable "id_timescale". All the values of "id_timescale" should be less then the dimension "nb_of_time_scales"

150	
   Global attribute "Sounding_File_Name" not found in NetCDF input file

151	
   Sounding NetCDF input file not found

152	
   Dimension "points" not found in Sounding NetCDF input file

153	
   Global attribute "Sounding_Start_Date" not found in the Sounding NetCDF input file

154	
   Global attribute "Sounding_Start_Time" not found in the Sounding NetCDF input file

155	
   Global attribute "Latitude_degrees_north" not found in the Sounding NetCDF input file

156	
   Global attribute "Longitude_degrees_east" not found in the Sounding NetCDF input file

157	
   Global attribute "Altitude_meter_asl" not found in the Sounding NetCDF input file

158	
   Variable "Altitude" not found and/or not  defined correctly in the Souding NetCDF input file

159	
   Variable "Temperature" not found and/or not  defined correctly in the Souding NetCDF input file

160	
   Variable "Pressure" not found and/or not  defined correctly in the Souding NetCDF input file

161	
   Sounding file error: "Altitude" array should contain altitudes in ascendent order (from the lowest point to the highest one)

162	
   Cannot found variable "LR_Input" within NetCDF input file. This variable is mandatory for elastic backscatter retrievals

163	
   Found invalid value(s) for Variable "LR_Input"

164	
   Global attribute "LR_File_Name" not found in NetCDF input file

165	
   Lidar ratio NetCDF input file not found

166	
   Dimension "points" not found in lidar ratio NetCDF input file

167	
   Dimension "products" not found in lidar ratio NetCDF input file

168	
   Global attribute "Lidar_Station_Name" not found in the lidar ratio NetCDF input file

169	
   Variable "Altitude" not found and/or not  defined correctly in the lidar ratio NetCDF input file

170	
   Variable "product_ID" not found and/or not  defined correctly in the lidar ratio NetCDF input file

171	
   Variable "Lidar_Ratio" not found and/or not  defined correctly in the lidar ratio NetCDF input file

172	
   Variable "product_id" in the lidar ratio NetCDF input file contains data that are not consistent with the SCC database values

173	
   Variable "Lidar_Ratio" in the lidar ratio NetCDF input file contains undefined values within the valid altitude range defined by the corresponding product. Please remove them.

174	
   Lidarratio file error: "Altitude" array should contain altitudes in ascendent order (from the lowest point to the highest one)

175	
   Overlap NetCDF input file not found

176	
   Dimension "points" not found in Overlap NetCDF input file

177	
   Dimension "channels" not found in Overlap NetCDF input file

178	
   Global attribute "Lidar_Station_Name" not found in the Overlap NetCDF input file

179	
   Global attribute "Overlap_Measurement_Date" not found in the Overlap NetCDF input file

180	
   Variable "Altitude" not found and/or not  defined correctly in the Overlap NetCDF input file

181	
   Variable "channel_ID" not found and/or not  defined correctly in the Overlap NetCDF input file

182	
   Variable "Overlap_Function" not found and/or not  defined correctly in the Overlap NetCDF input file

183	
   Overlap file error: "Altitude" array should contain altitudes in ascendent order (from the lowest point to the highest one)

184	
   Sounding file error: "Temperature" array should contain atmospheric temperature values in degrees Celsius

185	
   Sounding file error: "Pressure" array should contain atmospheric pressure values in hPa

186	
   Lidar ratio file error: "Lidar_Ratio" array should contain valid lidar ratio values in sr

187	
   Overlap file error: "Overlap_Function" array should contain valid overlap correction values

188	
   Variable "Lidar_Ratio_Error" not  defined correctly in the lidar ratio NetCDF input file

189	
   Dimension "time" is zero in the output file. This may be due to few cloud-free profile within integration time or the integration time is too small. Please check that thare are enought (>2) cloud-free profiles within the integration time in the submitted timeseries


190	
   Unable to use Poisson statistic in Montecarlo simulation. Found not integer values

191	
   Found wrong value(s) for "Background_Mode" in NetCDF file or in SCC_DB

192	
   Found wrong value(s) for variable "Dead_Time_Corr_Type" in NetCDF file or in SCC_DB

193	
   Cannot apply dead time correction. Please check the dead time value and the your photoncouning raw data

194	
   Found negative number of counts in lidar data!

195	
   Found wrong value(s) in variable "Raw_Bck_Start_Time" end/or "Raw_Bck_Stop_Time" and/or in laser repetition rate value

196	
   Background profiles don"t contain the same number of valid data point of the corresponding lidar profile

197	
   Cannot calculate errors using Montecarlo simulation within trigger delay correction

198	
   Linear interpolation not possible

199	
   Too few cloud-free lidar profiles within the integration time. Please check the integration time is not too small or/and there are enought cloud-free regions in the submitted timeseries

200	
   Cannot calculate the errors after time integration

201	
   Found timescales not syncronized

202	
   Cannot calculate errors using Montecarlo simulation within interpolation routine
   
203
   Gluing between near range and far range signals not possible. No suitable overlap region can found
   
204
   Gluing between near range and far range signals not possible. Poor linear correlation
   
205
   Gluing between near range and far range signals not possible. Too noisy signal(s)
   
206
   Gluing between near range and far range signals not possible. Slope test not passed
   
207
   All the profiles within the submitted timeseries seem contaminated by low clouds. Cannot calculate aerosol optical properties
   
211
   Found wrong value(s) for scattering type id
   
212
   Found wrong value(s) for detection type id
   
213
   Found wrong value(s) for range type id
   
214
   Too few lidar points to calculate atmospheric background. At least 10 lidar rangebins are required within the background subtraction range.
   
215
   Raw time resolution is greater than the selected integration time
   
216
   Gluing between near range and far range signals not possible. Too large difference between signals in gluing point
   
217
   Unkown interpolation type.
   
218
   Found wrong value(s) for signal type id or product channel(s) missing in system channel connections
   
219
   Found range resolution in raw lidar data greater than the value in SCC_DB
   
220
   Error in calculating molecular depolarization ratio
   
221
   Error in getting interferencial filter information for depolarization channels
   
222
   Found too few valid datapoints. Please check the variable "Raw_Lidar_Data" in the raw input file contains at least 15 valid points for all the channels
   
223
   Found not physical values after the interpolation of the sounding file. Try to change the interpolation type (to linear) to fix the problem.
   
224
   Found not physical values after the interpolation of the lidar ratio file. Try to change the interpolation type (to linear) to fix the problem.
   
225
   Found not physical values after the interpolation of the overlap file. Try to change the interpolation type (to linear) to fix the problem.
   
226
   Found incompatible value for the emission wavelength in one or more lidar channels
   
227
   Found not physical values after the interpolation of the model data. Try to change the interpolation type (to linear) to fix the problem.
   
228
   Polarization calibration product and the corresponding product to calibrate refer to different stations!
   
230
   Found invalid value of laser repetition rate. Check the database value or the value reported in the raw NetCDF input file
   
231
   All negative heights above lidar station in sounding file. Please be sure that the heights above sounding station and the sounding station altitude are reported correctly in the sounding file. Check also that your lidar station altitude is correct.
   
232
   All negative heights above lidar station in GDAS file. This shouldn"t happen! Try to force another model or use standard atmosphere or external sounding.
   
233
   Found invalid value of detection wavelength fwhm. Check the database value or the value reported in the raw NetCDF input file
   
234
   Found invalid value of range resolution. Check the database value or the value reported in the raw NetCDF input file
   
235
   Cannot open cloud mask NetCDF file
   
236
   Dimension "time" not found or not defined correctly in the cloudmask NetCDF file
   
237
   Dimension "level" not found or not defined correctly in the cloudmask NetCDF file
   
238
   Variable "time" and/or "time_bounds" not found or not defined correctly in the cloudmask NetCDF file
   
239
   Variable "altitude" not found or not defined correctly in the cloudmask NetCDF file
   
240
   Variable "latitude" not found or not defined correctly in the cloudmask NetCDF file
   
241
   Variable "longitude" not found or not defined correctly in the cloudmask NetCDF file
   
242
   Variable "station_altitude" not found or not defined correctly in the cloudmask NetCDF file
   
243
   Variable "automatic_cloud_mask" or "manual_cloud_mask" not found or not defined correctly in the cloudmask NetCDF file
   
244
   No cloud mask found for this measurement id. Please be sure the cloudmaks module ran succesfully
   
245
   Global attribute "measurement_ID" not found or not defined correctly in the cloudmask NetCDF file
   
246
   Cloud mask data not consistent with raw lidar data!
   
247
   Unknown distribution type for MonteCarlo simulation
   
248
   Polarization calibration: found inconsistency between wavelengths to calibrate and calibration wavelengths
   
249
   Error in getting model data from CloudNet
   
250
   It seems your station is not enabled to get model data from CloudNet. So please set Molecular_Calc=0 or 1 in your raw input file.
   
251
   CloudNet model data have been downloaded succesfully but it seems it contains invalid height value (null or negative values).
   
254
   General error (most probably segmentation fault)
   
255
   Timeout

mercurial