# -------------------------------------------------- listOfValidFlags
# ---> listOfValidFlags: [  [KEY, level[0..4], description[html], comment[html] ],... ]

listOfValidFlags =  [
 [ '-1', 1, 'GENE', '--<br><nobr>Not checked</nobr>', '<!--comment-->' ] ,
 [ '0', 1, 'GENE', '--<br><nobr>No error found</nobr>', '<!--comment-->' ] ,
 [ '1', 4, 'TIME', 'testTimeStep() <a href="qc2list.html#fn">^0</a>, <a href="qc2list.html#fn">^5</a><br><nobr>Error: negative time step</nobr>', '<!--comment-->' ] ,
 [ '2', 3, 'TIME', 'testTimeStep() <a href="qc2list.html#fn">^0</a>, <a href="qc2list.html#fn">^5</a><br><nobr>Error: missing time step</nobr>', 'This, of course, is no error if the QC is run over several time slices with intentional gaps in between. <br>You may want to set NON_REGULAR_TIME_STEP in the setup file to check only for positive increments <br>(of perhaps different sizes).' ] ,
 [ '4', 4, 'TIME', 'testTimeStep() <a href="qc2list.html#fn">^0</a>, <a href="qc2list.html#fn">^5</a><br><nobr>Error: identical time step</nobr>', '<!--comment-->' ] ,
 [ '8', 2, 'TIME', 'testCalendarTimeBounds()<br><nobr>Error: negative/zero time bounds range</nobr>', '<!--comment-->' ] ,
 [ '16', 2, 'TIME', 'testCalendarTimeBounds() <a href="qc2list.html#fn">^0</a><br><nobr>Error: overlapping time bounds ranges</nobr>', '<!--comment-->' ] ,
 [ '32', 2, 'TIME', 'testCalendarTimeBounds() <a href="qc2list.html#fn">^0</a><br><nobr>Warning: gap between time bounds ranges</nobr>', 'This warning refers to the bounds CF defines for every time step within a file. Rightbound(n) should be = Leftbound(n+1).' ] ,
 [ '100', 2, 'VARI', 'testData()<br><nobr>Warning: found a record entirely with filling value</nobr>', '<!--comment-->' ] ,
 [ '200', 2, 'VARI', 'testData()<br><nobr>Warning: found a record entirely with constant value</nobr>', '<!--comment-->' ] ,
 [ '400', 1, 'VARI', 'testData()<br><nobr>Warning: suspect minimum</nobr><br><nobr>Note: no table comparison; inferred from the data</nobr>', '<!--comment-->' ] ,
 [ '800', 1, 'VARI', 'testData()<br><nobr>Warning: suspect maximum</nobr><br><nobr>Note: no table comparison; inferred from the data</nobr>', '<!--comment-->' ] ,
 [ '1600', 1, 'VARI', 'testData()<br><nobr>Warning: undefined standard deviation</nobr>', '<!--comment-->' ] ,
 [ '3200', 1, 'VARI', 'testData()<br><nobr>Warning: suspecting a replicated record</nobr><br><nobr>Note: a record of min, max, ave, and stdDev</nobr><br><nobr>is identical to a previous one.</nobr><br><nobr>Note: fields of constant or filling value excluded.</nobr>', 'For most variables this should not happen. Check if 2 consecutive steps may have identical values. <br>The comparison of the values is:  abs(diff) &lt; 10**-7 .' ] ,
 [ '6400', 3, 'VARI', 'testData()<br><nobr>Warning: infinite (Inf) or not-a-number (NaN)</nobr>', '<!--comment-->' ] 
]


# -------------------------------------------------- listOfExceptions
# ---> listOfExceptions: [  [KEY, level[0..4], description[html], comment[html] ],... ]

listOfExceptions =  [
 [ '1', 4, 'OBSO', '''<nobr>from qc_main.cpp: --</nobr><br><nobr>Internal errors indicating flaws in</nobr><br><nobr>the scripts or qc_main.cpp.</nobr><br><nobr>''', '''All the errors of the 1_ family should not happen unless scripts or qc_main.cpp was changed. They may happen in test or debugging situations.''' ] ,
 [ '1_1', 4, 'OBSO', '''<nobr>from qc_main.cpp: getFilename() <a href="qc2list.html#fn">^2</a></nobr><br><nobr>Invalid name.</nobr><br><nobr>''', '''...in script qcExecutor (see comment of exception 1).''' ] ,
 [ '1_2', 4, 'OBSO', '''<nobr>from qc_main.cpp: insertPointedObj() <a href="qc2list.html#fn">^2</a></nobr><br><nobr>String parsing: definition of object ... must not have references.</nobr><br><nobr>''', '''...in the c++ code (see comment of exception 1).''' ] ,
 [ '1_3', 4, 'OBSO', '''<nobr>from qc_main.cpp: getopt() <a href="qc2list.html#fn">^2</a></nobr><br><nobr>Undefined option ...</nobr><br><nobr>''', '''...in the c++ code (see comment of exception 1).''' ] ,
 [ '1_4', 4, 'OBSO', '''<nobr>from qc_main.cpp: setObjLinks() <a href="qc2list.html#fn">^2</a></nobr><br><nobr>... must have a single reference.</nobr><br><nobr>''', '''...in the c++ code (see comment of exception 1).''' ] ,
 [ '2', 4, 'OBSO', '''<nobr>from qc_main.cpp: entry() <a href="qc2list.html#fn">^2</a></nobr><br><nobr>No QC object linked to InFile object.</nobr><br><nobr>''', '''...in the c++ code (see comment of exception 1).''' ] ,
 [ '5', 4, 'OBSO', '''<nobr>from Base.cpp: setFillingValue()</nobr><br><nobr>Undefined explicitly provided variable name.</nobr><br><nobr>Note: not related to CMIP5.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '6', 4, 'OBSO', '''<nobr>from Base.cpp: setVarPropsNoOperation()</nobr><br><nobr>No rules to link alias to any variable in operation.</nobr><br><nobr>Note: not related to CMIP5.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '7', 4, 'OBSO', '''<nobr>from Base.cpp: setVarPropsNoOperation()</nobr><br><nobr>No rules for finding a variable name.</nobr><br><nobr>Note: not related to CMIP5.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '8', 4, 'OBSO', '''<nobr>from Base.cpp: setVarPropsNoOperation()</nobr><br><nobr>No rules for finding a variable name.</nobr><br><nobr>Note: not related to CMIP5.</nobr><br><nobr>''', '''...in the c++ code (see comment of exception 1).''' ] ,
 [ '9', 4, 'OBSO', '''<nobr>from Base.cpp: getVarname(std::string &s, std::vector&lt;std::string&gt; &) <a href="qc2list.html#fn">^2</a></nobr><br><nobr>Invalid assignment statement of variable names.</nobr><br><nobr>Note: not related to CMIP5.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '10', 4, 'ACCE', '''<nobr>from InFile.cpp: init() <a href="qc2list.html#fn">^2</a></nobr><br><nobr>Could not open netCDF file.</nobr><br><nobr>Note: non-operational processing only.</nobr><br><nobr>''', '''NetCDF output file for (QC results) could not be opened. This is checked before, too - so there normally should be no access errors here.''' ] ,
 [ '12', 3, 'VARI', '''<nobr>from InFile.cpp: checkVarType()</nobr><br><nobr>The type of the variable is not float.</nobr><br><nobr>Note: CMIP5 requires always float.</nobr><br><nobr>''', '''The checked variables are expected to be float! Double variables are not checked but their error messages can be suppressed in setup file. <br>Unchecked variables cannot be part of a DOI (persistent Document Object Identifier).''' ] ,
 [ '14', 4, 'TIME', '''<nobr>from InFile.cpp: setGeoParam()</nobr><br><nobr>Dimension rank of the field is higher than 3D.</nobr><br><nobr>Note: the dimension of time is excluded.</nobr><br><nobr>''', '''Three space dimensions are allowed as maximum.''' ] ,
 [ '15', 3, 'VARI', '''<nobr>from InFile.cpp: setGeoParam()</nobr><br><nobr>Vertices or bounds of unknown format.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '16', 4, 'VARI', '''<nobr>from InFile.cpp: scanNcVars() <a href="qc2list.html#fn">^2</a></nobr><br><nobr>Explicitly provided variable name not found in the netCDF file.</nobr><br><nobr>Note: non-operational processing only.</nobr><br><nobr>''', '''The expected variable was not found in the NetCDF header.''' ] ,
 [ '18', 3, 'VARI', '''<nobr>from InFile.cpp: xtractNum()</nobr><br><nobr>Dimension rank of the field is higher than 3D.</nobr><br><nobr>Note: the dimension of time is excluded.</nobr><br><nobr>''', '''2D (lat/lon) and 3D (lat/lon/alt) data are expected.''' ] ,
 [ '19', 4, 'GENE', '''<nobr>from InFile.cpp: init() <a href="qc2list.html#fn">^2</a></nobr><br><nobr>No QC object linked to the InFile object.</nobr><br><nobr>Note: non-operational processing only.</nobr><br><nobr>''', '''Instance of c++ class &quot;QC&quot; does not exist (see comment of exception 1). <br>If this is the case, exception 2 should have been thrown before.''' ] ,
 [ '21', 3, 'VARI', '''<nobr>from InFile.cpp: scanNcVars()</nobr><br><nobr>Neither explicit variable name nor CMOR encoded filename.</nobr><br><nobr>Note: search priority: clear excluded variables, time</nobr><br><nobr>dependence, multi-dimensional variables, independent</nobr><br><nobr>variables matched with filename.</nobr><br><nobr>''', '''In the setup file a fixed field variable was spcified but not found in the data.''' ] ,
 [ '22', 4, 'VARI', '''<nobr>from InFile.cpp: scanNcVars()</nobr><br><nobr>Fixed field variable name from filename not found in the netCDF file.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '28', 4, 'GENE', '''<nobr>from Parse.cpp: convertEmbeddedObj()</nobr><br><nobr>Undefined specification in the command-line arguments.</nobr><br><nobr>Note: non-operational processing only.</nobr><br><nobr>''', '''Fatal, as this should not happen in the CMIP5 project. This routine is called from a script. So its command line input should be clean.''' ] ,
 [ '29', 4, 'GENE', '''<nobr>from Parse.cpp: convertEmbeddedObj()</nobr><br><nobr>Syntax error in the command-line arguments.</nobr><br><nobr>Note: non-operational processing only.</nobr><br><nobr>''', '''Fatal, as this should not happen in the CMIP5 project. This routine is called from a script. So its command line input should be clean.''' ] ,
 [ '30', 2, 'OBSO', '''<nobr>&nbsp;''', '''Checks from 30 to 39 refer to the consistency of parent-child relations between experiments.''' ] ,
 [ '30_1', 2, 'ACCE', '''<nobr>from qcExecutor_FS (script): checkParent()</nobr><br><nobr>Invalid path to parent: &lt;path&gt;</nobr><br><nobr>Note: issues a warning.</nobr><br><nobr>''', '''The information on the parent-child relation is requested in CMIP5 for all experiments but piControl. There the attribute should be set to n/a.''' ] ,
 [ '30_2', 2, 'ACCE', '''<nobr>from qcExecutor_FS (script): checkParent()</nobr><br><nobr>No parent file found in path: &lt;file&gt;</nobr><br><nobr>Note: issues a warning.</nobr><br><nobr>''', '''The information on the parent-child relation is requested in CMIP5 for all experiments but piControl. There the attribute should be set to n/a.''' ] ,
 [ '30_3', 2, 'META', '''<nobr>from QC.cpp: QC.checkCMIP5_Filename()</nobr><br><nobr>Missing netCDF attribute: parent_experiment_id.</nobr><br><nobr>''', '''The information on the parent-child relation is requested in CMIP5 for all experiments but piControl. There the attribute should be set to n/a.''' ] ,
 [ '30_4', 2, 'META', '''<nobr>from QC.cpp: QC.checkCMIP5_Filename()</nobr><br><nobr>Missing netCDF attribute: parent_experiment_rip.</nobr><br><nobr>''', '''The information on the parent-child relation is requested in CMIP5 for all experiments but piControl. There the attribute should be set to n/a.<br>You may want to set PARENT_EXP_RIP=none in the setup file to suppress this check (e.g., for older data from when this attirbute was not yet required).''' ] ,
 [ '30_5', 2, 'GENE', '''<nobr>from testParentChild.cpp: testParentChild.main()</nobr><br><nobr>Missing command-line parameter for the child experiment: -c file.</nobr><br><nobr>''', '''The information on the parent-child relation is requested in CMIP5 for all experiments but piControl.''' ] ,
 [ '30_6', 2, 'GENE', '''<nobr>from testParentChild.cpp: testParentChild.main()</nobr><br><nobr>Missing command-line parameter for the parent experiment: -p file.</nobr><br><nobr>''', '''The information on the parent-child relation is requested in CMIP5 for all experiments but piControl.''' ] ,
 [ '31_1', 3, 'ACCE', '''<nobr>from testParentChild.cpp: testParentChild.main()</nobr><br><nobr>Could not open the netCDF file of the child experiment</nobr><br><nobr>''', '''Missing authorisation.''' ] ,
 [ '31_2', 3, 'ACCE', '''<nobr>from testParentChild.cpp: testParentChild.main()</nobr><br><nobr>Could not open the netCDF file of the parent experiment</nobr><br><nobr>''', '''Missing authorisation.''' ] ,
 [ '31_3', 4, '', '''<nobr>from testParentChild.cpp: qcManager</nobr><br><nobr>Empty data file</nobr><br><nobr>Note: only when option COMPLAIN_EMPTY_FILE is enabled</nobr><br><nobr>''', '''&nbsp;-''' ] ,
 [ '32', 1, 'TIME', '''<nobr>from testParentChild.cpp: testParentChild.getTimeProperties()</nobr><br><nobr>Different calendar types in parent and child.</nobr><br><nobr>Note: This could work. Thus, only a warning.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '33_1', 3, 'META', '''<nobr>from testParentChild.cpp: testParentChild.getTimeProperties()</nobr><br><nobr>No time units attribute in the child file.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '33_2', 3, 'META', '''<nobr>from testParentChild.cpp: testParentChild.getTimeProperties()</nobr><br><nobr>No time units attribute in the parent file.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '34_1', 2, 'META', '''<nobr>from testParentChild.cpp: testParentChild.getTimeProperties()</nobr><br><nobr>Time units attribute: different measuring in child and parent.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '34_2', 2, 'META', '''<nobr>from testParentChild.cpp: testParentChild.getTimeProperties()</nobr><br><nobr>Time units attribute: different reference dates in child and parent.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '35', 4, 'TIME', '''<nobr>from testParentChild.cpp: testParentChild.sync()</nobr><br><nobr>Child begins earlier than the parent</nobr><br><nobr>Note: potentially different time units are taken into account.</nobr><br><nobr>The last lag of the parent is the one closest before the first one of the child.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '36', 2, 'TIME', '''<nobr>from testParentChild.cpp: testParentChild.checkTime()</nobr><br><nobr>The lag across files differs from the last lag in the parent.</nobr><br><nobr>Note: potentially different time units are taken into account.</nobr><br><nobr>The last lag of the parent is the one closest before the first one of the child.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '37', 2, 'TIME', '''<nobr>from testParentChild.cpp: testParentChild.checkTime()</nobr><br><nobr>The last lag of the parent differs from the first lag of the child.</nobr><br><nobr>Note: potentially different time units are taken into account.</nobr><br><nobr>The last lag of the parent is the one closest before the first one of the child.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '38_1', 1, 'TIME', '''<nobr>from testParentChild.cpp: testParentChild.checkTime()</nobr><br><nobr>No bounds attribute of time of the parent.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '38_2', 1, 'TIME', '''<nobr>from testParentChild.cpp: testParentChild.checkTime()</nobr><br><nobr>No bounds attribute of time of the child.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '38_3', 1, 'TIME', '''<nobr>from testParentChild.cpp: testParentChild.checkTime()</nobr><br><nobr>Time bound lags of the last parent lag and the first lag of the child overlap.</nobr><br><nobr>''', '''&nbsp;''' ] ,
 [ '41', 4, 'ACCE', '''<nobr>from testParentChild.cpp: CMIP5.openTable() <a href="qc2list.html#fn">^3</a></nobr><br><nobr>Could not open the CMIP5 table.</nobr><br><nobr>''', '''Refers to the CMIP5 standard table for comparison of variable names etc.''' ] ,
 [ '42', 4, 'TABL', '''<nobr>from testParentChild.cpp: CMIP5.findNextVariableHeadline() <a href="qc2list.html#fn">^3</a></nobr><br><nobr>MIP table name not found in the CMIP5 table.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '43', 4, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkStandardTable() <a href="qc2list.html#fn">^3</a></nobr><br><nobr>Missing column(s) in the standard table.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '44', 2, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkStandardTable() <a href="qc2list.html#fn">^3</a></nobr><br><nobr>Variable not found in the standard table.</nobr><br><nobr>''', '''The variable does not need to be in the CMIP5 standard table in case option &quot;TABLE_VARIABLE_CONSTRAINT=RELAXED&quot; is set in the setup file.<br>An additional variable of surface pressure (e.g., ps) to base the vertical coord system on is ok.<!--ft 20110614 after disk with MJ-->''' ] ,
 [ '45_1', 4, 'TIME', '''<nobr>from testParentChild.cpp: QC.getDimMetaData()</nobr><br><nobr>Variable time has no unit attribute.</nobr><br><nobr>''', '''Fatal, as the time axis cannot be checked.''' ] ,
 [ '45_2', 2, 'TIME', '''<nobr>from testParentChild.cpp: QC.getDimMetaData()</nobr><br><nobr>Time attribute declares time_bounds, but there is no such variable.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '45_3', 2, 'TIME', '''<nobr>from testParentChild.cpp: QC.getVariableMetaData()</nobr><br><nobr>Variable name in filename does not match any variable in the file.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '45_4', 2, 'TIME', '''<nobr>from testParentChild.cpp: exploitFormulaTerms()</nobr><br><nobr>Attribute formula or formula_terms is missing for variable &lt;var&gt;.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '46', 4, 'META', '''<nobr>from testParentChild.cpp: CMIP5.checkGlobalAttributes()</nobr><br><nobr>Missing required netCDF global attribute: &lt;name&gt;</nobr><br><nobr>''', '''The following exceptions (46_x) refer to the file name syntax and to NetCDF attributes. Checks are based on the conventions used in CMIP5.''' ] ,
 [ '46_1', 4, 'META', '''<nobr>from testParentChild.cpp: checkCMIP5_Filename()</nobr><br><nobr>Missing netCDF attribute: project_id.</nobr><br><nobr>''', '''Fatal, as many parts of the CMIP5 workflow depend on the DRS syntax.''' ] ,
 [ '46_2', 4, 'META', '''<nobr>from testParentChild.cpp: checkCMIP5_Filename()</nobr><br><nobr>Missing netCDF attribute: physics_version.</nobr><br><nobr>''', '''Fatal, as &quot;no sub-table named in file header&quot; should not happen when data is written by CMOR2.''' ] ,
 [ '46_3', 4, 'META', '''<nobr>from testParentChild.cpp: checkCMIP5_Filename()</nobr><br><nobr>Missing netCDF attribute: initialization_method.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '46_4', 4, 'META', '''<nobr>from testParentChild.cpp: checkCMIP5_Filename()</nobr><br><nobr>Missing netCDF attribute: realization.</nobr><br><nobr>''', '''The names of the CMIP5's subtable differ in file name and file header of the NetCDF file. <br>Fatal, as this should not happen when data is written by CMOR2.''' ] ,
 [ '46_5', 4, 'META', '''<nobr>from testParentChild.cpp: checkCMIP5_Filename()</nobr><br><nobr>Missing netCDF attribute: experiment_id.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '46_6', 3, 'META', '''<nobr>from testParentChild.cpp: CMIP5.checkCMIP5_Filename()</nobr><br><nobr>Filename is inconsistent with CMOR encoding.</nobr><br><nobr>''', '''For the required structure of the file name see <i>Taylor et al, CMIP5 Data Reference Syntax (DRS) and Controlled Vocabularies</i>.''' ] ,
 [ '46_7', 3, 'META', '''<nobr>from testParentChild.cpp: CMIP5.checkCMIP5_Filename()</nobr><br><nobr>Filename does not match CMIP5 attributes.</nobr><br><nobr>''', '''The file (chunk) name constructed from the header information in the file does not match the actual file name. <br>E.g., the header's global attribute for the realisation's number (or initialisation or physics) does not match the *_r&lt;i&gt;i&lt;j&gt;p&lt;k&gt;_* portion of the file name.''' ] ,
 [ '46_8', 4, 'META', '''<nobr>from testParentChild.cpp: CMIP5.getMIP_table()</nobr><br><nobr>Invalid MIP table name in CMIP5 attributes.</nobr><br><nobr>''', '''Mind: a string like &quot;amon&quot; is case sensitive.''' ] ,
 [ '47', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a></nobr><br><nobr>Table error for dimension(s) of a variable.</nobr><br><nobr>''', '''The following exceptions (47_x) refer to the dimension information in the NetCDF file header. <br>At first, this is compared to the CMIP5 standard table, from the second temporal subset (chunk, file) on to the internal project table.''' ] ,
 [ '47_1', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Standard/Project table: &lt;variable&gt;, &lt;dimension&gt;: output name.</nobr><br><nobr>''', '''The output name is the variable acronym used in the file name.''' ] ,
 [ '47_2', 4, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Standard/Project table: &lt;variable&gt;, &lt;dimension&gt;: standard name.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '47_3', 1, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Standard/Project table: &lt;variable&gt;, &lt;dimension&gt;: long name.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '47_4', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Standard/Project table: &lt;variable&gt;, &lt;dimension&gt;: axis.</nobr><br><nobr>''', '''Correlation lon/lat/alt/time vs X/Y/Z/T according standard table did not match.''' ] ,
 [ '47_5', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Standard/Project table: &lt;variable&gt;, &lt;dimension&gt;: checksum.</nobr><br><nobr>Note: Indicates a change in the layering or model grid.</nobr><br><nobr>''', '''Checksum is over the set of values of this (1D) axis, e.g., over var=altitudeValues(<list>) or var=listOfBasins:{atlantic, pacific, indic}.<br>The axes' values of different chunks (including char dimensions) are compared by checksums to<br>a: each other (file to file) and<br>b: the required values of Taylor's tables (if given there).<br>This error is &quot;nearly fatal&quot;. However, we might accept obvious rounding errors.''' ] ,
 [ '47_6', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Standard/Project table: &lt;variable&gt;, &lt;dimension&gt;: units.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '47_7', 2, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Standard/Project table: &lt;variable&gt;, &lt;dimension&gt;: bounds.</nobr><br><nobr>a) Conflict in request for bounds.</nobr><br><nobr>b) Bounds not available in the file.</nobr><br><nobr>''', '''Existence of bounds in the file header needs to be one of {yes,no}. Value found does not match.''' ] ,
 [ '47_8', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Standard/Project table: &lt;variable&gt;, &lt;dimension&gt;: size.</nobr><br><nobr>''', '''Length of axis (=number of points) should be constant!<br>Except: the number of vertical levels may vary (dim=plev).<!--2011-03-30-->''' ] ,
 [ '47_9', 1, 'TIME', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Standard/Project table: time, units: missing key string</nobr><br><nobr>in the units attribute &apos;PERIOD since&apos;.</nobr><br><nobr>Note: PERIOD indicates key: minutes, hours, days, etc.</nobr><br><nobr>Note: Throws always an error flag, because the date at each</nobr><br><nobr>time step cannot be determined later.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '47_10', 1, 'TIME', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Standard/Project table: time, units: different reference dates.</nobr><br><nobr>Note: Throws always a warning flag, because the date at each</nobr><br><nobr>time step might be found correct later.</nobr><br><nobr>''', '''For files where time is coded as &lt;referenceTime&gt;+&lt;timeStep&gt;: change of reference time. <br>This may be ok in case &lt;timeStepUnit&gt; is changed accordingly.''' ] ,
 [ '47_11', 4, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkStandardTableDimBounds() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Number of dim_bounds do not match those of the standard table.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '47_12', 4, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkStandardTableDimBounds() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>Values of dim_bounds do not match those of the standard table.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '47_13', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimTableEntry() <a href="qc2list.html#fn">^5</a>, <a href="qc2list.html#fn">^7</a></nobr><br><nobr>File: coordinate attribute variable: incorrect units.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '48', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimStandardTable() <a href="qc2list.html#fn">^3</a>, <a href="qc2list.html#fn">^4</a></nobr><br><nobr>Dimension not found in the standard table.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '49', 4, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimStandardTable() <a href="qc2list.html#fn">^3</a></nobr><br><nobr>Table sheet for dimensions not found in the CMIP5 table.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '50', 4, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimStandardTable() <a href="qc2list.html#fn">^3</a></nobr><br><nobr>Corrupt standard sub-table for dimensions: wrong number of columns.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '51', 2, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimStandardTable() <a href="qc2list.html#fn">^3</a></nobr><br><nobr>Missing value in MIP table &apos;dims&apos; in column &apos;bounds&apos;?.</nobr><br><nobr>Note: Required is &apos;yes&apos; or &apos;no&apos;.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '52', 2, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkDimStandardTable() <a href="qc2list.html#fn">^3</a>, <a href="qc2list.html#fn">^4</a></nobr><br><nobr>Dimension from the table not found in the file.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '54', 4, 'ACCE', '''<nobr>from testParentChild.cpp: QC.checkProjectTable()</nobr><br><nobr>Could not create project table.</nobr><br><nobr>Note: Due to a faulty configguration file entry.</nobr><br><nobr>Note: Signal to qcManager to shutdown.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '55', 4, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkProjectTable() <a href="qc2list.html#fn">^2</a></nobr><br><nobr>Corrupt project table: variable | dimension | auxiliary.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '56', 2, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkProjectTableAuxiliary()</nobr><br><nobr>Project-table errors for auxiliaries.</nobr><br><nobr>''', '''The following exceptions (56_x) refer to checks of auxiliary variables in the file against the internal project table. Here &quot;auxiliary variables&quot; refers to all time independent variables (except a fixed variable as standard name), e.g. dimensions etc.''' ] ,
 [ '56_1', 2, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkProjectTableAuxiliary()</nobr><br><nobr>Project-table: time independence check failed.</nobr><br><nobr>''', '''A variable which changed from being independent on time to being time dependent.''' ] ,
 [ '56_2', 4, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkProjectTableAuxiliary()</nobr><br><nobr>Project-table: number of dimensions of auxiliary changed.</nobr><br><nobr>''', '''E.g., a change in the number of pressure levels.''' ] ,
 [ '56_3', 4, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkProjectTableAuxiliary()</nobr><br><nobr>Project-table: checksum of levels or grid values changed.</nobr><br><nobr>''', '''Checksum of the set of values of a space dimension has changed between files.''' ] ,
 [ '56_4', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkProjectTableAuxiliary()</nobr><br><nobr>Project-table: missing auxiliary in the file.</nobr><br><nobr>''', '''An auxiliary variable &quot;disappeared&quot; between two temporal subsets (chunks, files).''' ] ,
 [ '56_5', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkProjectTableAuxiliary()</nobr><br><nobr>Project-table: missing auxiliary in the table.</nobr><br><nobr>''', '''An auxiliary variable &quot;appeared&quot; between two temporal subsets (chunks).''' ] ,
 [ '56_6', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.getVariableMetaData()</nobr><br><nobr>Option AUXILIARIES is not syntax compliant.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '57', 4, 'ACCE', '''<nobr>from testParentChild.cpp: QC</nobr><br><nobr>No path to tables; faulty config-file entry.</nobr><br><nobr>Note: Signal to qcManager to shutdown.</nobr><br><nobr>''', '''No path to CMIP5 standard table OR to project table ==> no checks possible ===> end of work.''' ] ,
 [ '58', 2, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkVarTableEntry() <a href="qc2list.html#fn">^5</a></nobr><br><nobr>Table error for a variable.</nobr><br><nobr>''', '''The following exceptions (58_x) refer to checks of the main variable in the file against the internal project table (or the CMIP5 standard table).<br>You may use a flag in the setup file to switch between the detailed code (58_x) and the lumped coarse form (just &quot;58&quot;).''' ] ,
 [ '58_1', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkVarTableEntry() <a href="qc2list.html#fn">^5</a></nobr><br><nobr>Standard/Project table: variable: standard name conflict.</nobr><br><nobr>''', '''Different standard names in NetCDF header and project/standard table.''' ] ,
 [ '58_2', 1, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkVarTableEntry() <a href="qc2list.html#fn">^5</a></nobr><br><nobr>Standard/Project table: variable: long name conflict.</nobr><br><nobr>''', '''Different long names in NetCDF header and project/standard table.''' ] ,
 [ '58_3', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkVarTableEntry() <a href="qc2list.html#fn">^5</a></nobr><br><nobr>Standard/Project table: variable: units conflict.</nobr><br><nobr>a) variable has no units attribute, table requires units= or units=1.</nobr><br><nobr>b) variable has no units attribute.</nobr><br><nobr>c) variable has &lt;v_units&gt;, table requires &lt;t_units&gt;.</nobr><br><nobr>''', '''Different units in NetCDF header and project/standard table.''' ] ,
 [ '58_4', 2, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkVarTableEntry() <a href="qc2list.html#fn">^5</a></nobr><br><nobr>Standard/Project table: variable: cell-method conflict.</nobr><br><nobr>''', '''Different cell methods in NetCDF header and project/standard table.<br>Cell method may be missing in the file header (or the table) or is wrong. In the latter case, this will affect the time step width <br>(provided it refers to dimension time) and will be detected as time axis inconsistency.<!--2011-03-29-->''' ] ,
 [ '58_5', 4, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkVarTableEntry() <a href="qc2list.html#fn">^5</a></nobr><br><nobr>Standard/Project table: variable: type conflict.</nobr><br><nobr>''', '''Different variable type (float expected) in NetCDF header and project/standard table. <br>Fatal, as this variable will not be checked.''' ] ,
 [ '58_6', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkSigmaPressureCoordinates()</nobr><br><nobr>No variables a(k) or b(k) found for the hybrid sigma pressure coordinates.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '58_7', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkVarTableEntry() <a href="qc2list.html#fn">^5</a></nobr><br><nobr>Standard/Project table: variable: cell-measures conflict.</nobr><br><nobr>''', '''Dimensions in CF carry the "cell-measure" attribute (mean,..). This information is compared to the entries in the Taylor tables.''' ] ,
 [ '58_8', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkVarTableEntry() <a href="qc2list.html#fn">^5</a></nobr><br><nobr>Standard/Project table: variable: incorrect coordinate attribute.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '58_9', 1, 'TABL', '''<nobr>from testParentChild.cpp: QC.checkVarTableEntry() <a href="qc2list.html#fn">^5</a></nobr><br><nobr>Standard/Project table: variable: type check discarded, not specified in the MIP Table.</nobr><br><nobr>''', '''The type of the variable could not be checked as it was not found in the MIP table.''' ] ,
 [ '59', 3, 'VARI', '''<nobr>+''', '''The following exceptions (59_x) refer to checks of variables.''' ] ,
 [ '59_1', 3, 'VARI', '''<nobr>from testParentChild.cpp: QC.finally()</nobr><br><nobr>Data set entirely of const value.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '59_2', 3, 'VARI', '''<nobr>from testParentChild.cpp: QC.finally()</nobr><br><nobr>Data set entirely of _FillValue.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '59_3', 3, 'VARI', '''<nobr>from testParentChild.cpp: QC.finally()</nobr><br><nobr>All records (data at given time steps) are identical.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '60', 3, 'META', '''<nobr>from testParentChild.cpp: QC.initResumeSession()</nobr><br><nobr>Name of a variable has changed</nobr><br><nobr>Note: Compared to previous chunks.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '63', 4, 'OBSO', '''<nobr>from testParentChild.cpp: QC.sync()</nobr><br><nobr>All records have previously been processed.</nobr><br><nobr>Note: This is not an error: idle</nobr><br><nobr>''', '''All existing records of the file have been processed. However, expected file end (according to file name) and time stamp of last record do not match. <br>This should not happen, if you run these checks on a non-increasing (=not supplemented) fixed set of data.''' ] ,
 [ '64', 4, 'GENE', '''<nobr>from testParentChild.cpp: QC.syncRedo()</nobr><br><nobr>Indication of a renewal of the input file.</nobr><br><nobr>''', '''This should not happen unless you run QC during the model run. <br>In this case it means that the model perhaps has newly started to write this file <br>(i.e., less time steps as during last visit of this file were found by the checking routine).''' ] ,
 [ '65', 4, 'GENE', '''<nobr>from testParentChild.cpp: QC.syncRedo()</nobr><br><nobr>Faulty argument in config-file for redo-option.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '66', 4, 'GENE', '''<nobr>from testParentChild.cpp: QC.syncRedo()</nobr><br><nobr>REDO is selected, but the qc-file is empty.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '67', 4, 'GENE', '''<nobr>from testParentChild.cpp: QC.syncRedo()</nobr><br><nobr>REDO requires at least one record in qc_&lt;filename&gt;.nc</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '68', 4, '', '''<nobr>from testParentChild.cpp: QC.testTimeStep()</nobr><br><nobr>Waiting for a closing temporal gap.</nobr><br><nobr>Note: This is not an error.</nobr><br><nobr>''', '''tbd...''' ] ,
 [ '69', 4, 'TIME', '''<nobr>from testParentChild.cpp: QC.initResumeSession() <a href="qc2list.html#fn">^2</a></nobr><br><nobr>Sub-cycle of time step has changed.</nobr><br><nobr>Note: For any kind of cycles within a time step (e.g. diurnal cycle).</nobr><br><nobr>Note: Not for CMIP5</nobr><br><nobr>''', '''Should not happen in CMIP5 as values of, e.g., subcycle UTC 0/6/12/18 never are aggregated to four distinct monthly means.''' ] ,
 [ '70', 0, 'GENE', '''<nobr>from testParentChild.cpp: QC.(different methods)</nobr><br><nobr>Any error in any record.</nobr><br><nobr>''', '''In this case, F&lt;value&gt; is given for specification according to the table at the top of this page (see file qc_&lt;fileName&gt;.nc, too). <br>The severity level of this exception depends on the level of exception F&lt;value&gt;.''' ] ,
 [ '71', 3, 'GENE', '''<nobr>from testParentChild.cpp: QC.testTimeStep()</nobr><br><nobr>Error in a time record (Error Flags: 1, 2, 4) stops and blocks</nobr><br><nobr>further attempts, if option STOP_AT_TIME_ERROR is enabled.</nobr><br><nobr>''', '''In this case, F1,F2 or F4 is given for specification according to the table at the top of this page.<br>No further attempts to check these Atomic Dataset are made.<!--There remain unchecked Data after this stop of checks.-->''' ] ,
 [ '71_1', 2, '', '''<nobr>from testParentChild.cpp: qcManager</nobr><br><nobr>Ambiguity check failed for sorted dates of sub-temporal file set.</nobr><br><nobr>''', '''This check refers to the modification time stamp which is stored by the operating system of the computer. <br>The modification times of the files (chunks) should be ascending for files with ascending values on their time axes.<br>In this case the check failed.''' ] ,
 [ '71_2', 2, '', '''<nobr>from testParentChild.cpp: qcManager</nobr><br><nobr>Modification time check failed for ascending dates of sub-temporal files.</nobr><br><nobr>''', '''This check refers to the modification time stamp which is stored by the operating system of the computer. <br>The modification times of the files (chunks) should be ascending for files with ascending values on their time axes. In case  of this warning it is not.<br>The check may be suppressed by setting &quot;SYNC_FILE_AMBIGUITY_CHECK = NO_MOD&quot;.''' ] ,
 [ '72', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.parseTimeTable()</nobr><br><nobr>Violation against time information of the standard table.</nobr><br><nobr>''', '''The following exceptions (72_x) refer to checks of the file time axis against the CMIP5 standard table&apos;s time information.''' ] ,
 [ '72_1', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.parseTimeTable()</nobr><br><nobr>Time record before the first time-table range.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '72_2', 3, 'TABL', '''<nobr>from testParentChild.cpp: QC.parseTimeTable()</nobr><br><nobr>Time record after the last time-table range</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '72_3', 2, 'TABL', '''<nobr>from testParentChild.cpp: QC.parseTimeTable()</nobr><br><nobr>Too many time records compared to the time-table.</nobr><br><nobr>''', '''<!--comment-->''' ] ,
 [ '95', 2, 'TIME', '''<nobr>from testParentChild.cpp: QC.testTimeStamp()</nobr><br><nobr>Ambiguous or faulty first time-stamp in the filename.</nobr><br><nobr>Note: Faulty, if the stamp is younger than 1st time-record.</nobr><br><nobr>Ambig., if the stamp is too coarse to resolve time-records.</nobr><br><nobr>''', '''The time of the file&apos;s start record is in conflict with the starttime of the file name. The max allowed difference depends on the step width.''' ] ,
 [ '96', 2, 'TIME', '''<nobr>from testParentChild.cpp: QC.testTimeStamp()</nobr><br><nobr>Filename time-stamp error (2nd date).</nobr><br><nobr>Note: Time record exceeds time-stamp of the filename.</nobr><br><nobr>''', '''The time of a file&apos;s record is not in the time span of the file name.''' ] ,
 [ '97', 2, 'TIME', '''<nobr>from testParentChild.cpp: QC.testTimeStamp()</nobr><br><nobr>Invalid time-range in filename.</nobr><br><nobr>''', '''The file name does not provide a legal (:= CMOR2 conform) start-stop time span (start>stop).''' ] ,
 [ '99', 2, 'GENE', '''<nobr>from testParentChild.cpp: QC.finally()</nobr><br><nobr>Status: apparently in progress.</nobr><br><nobr>Note: This indicates that no error occurred. But, the end time</nobr><br><nobr>of the input filename and the last time value in the data</nobr><br><nobr>did not match (with the uncertainty of 0.75 of a time step).</nobr><br><nobr>So, it is likely that the file is still in a stage of processing.</nobr><br><nobr>''', '''As these procedures are meant to run on continuously supplemented files, &lt;stop time of file name&gt; != &lt;time of last record&gt; might indicate that this file has not yet been readily filled.''' ] ,
 [ '111', 4, 'GENE', '''<nobr>from testParentChild.cpp: qc-main</nobr><br><nobr>The program exited without any exit code above and did not</nobr><br><nobr>produce a single file. This is an error.</nobr><br><nobr>''', '''A run that has not found any exception should have left a NetCDF file.''' ] 
]

# Version of  2012-07-05 20:46:18