Per #2897, update the User's Guide about -v 9 for Point-Stat

dtcenter · May 22, 2024 · 0da0706 · 0da0706
1 parent 6546e06
commit 0da0706
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 1 deletion.
diff --git a/docs/Users_Guide/appendixA.rst b/docs/Users_Guide/appendixA.rst
@@ -121,6 +121,11 @@ Q. How can I understand the number of matched pairs?
      in the configuration file. So all of the 1166 observations are rejected
      for the same reason.
 
+     In addition, running point_stat with at least verbosity level 9 (-v 9)
+     will result in a log message being printed to explain why each
+     observation is skipped or retained for each verification task.
+     This level of detail is intended only for debugging purposes.
+
 Q. What types of NetCDF files can MET read?
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

diff --git a/docs/Users_Guide/point-stat.rst b/docs/Users_Guide/point-stat.rst
@@ -264,7 +264,7 @@ Practical Information
 
 The Point-Stat tool is used to perform verification of a gridded model field using point observations. The gridded model field to be verified must be in one of the supported file formats. The point observations must be formatted as the NetCDF output of the point reformatting tools described in :numref:`reformat_point`. The Point-Stat tool provides the capability of interpolating the gridded forecast data to the observation points using a variety of methods as described in :numref:`matching-methods`. The Point-Stat tool computes a number of continuous statistics on the matched pair data as well as discrete statistics once the matched pair data have been thresholded.
 
-If no matched pairs are found for a particular verification task, a report listing counts for reasons why the observations were not used is written to the log output at the default verbosity level of 2. If matched pairs are found, this report is written at verbosity level 3. Inspecting these rejection reason counts is the first step in determining why Point-Stat found no matched pairs. The order of the log messages matches the order in which the processing logic is applied. Start from the last log message and work your way up, considering each of the non-zero rejection reason counts.
+If no matched pairs are found for a particular verification task, a report listing counts for reasons why the observations were not used is written to the log output at the default verbosity level of 2. If matched pairs are found, this report is written at verbosity level 3. Inspecting these rejection reason counts is the first step in determining why Point-Stat found no matched pairs. The order of the log messages matches the order in which the processing logic is applied. Start from the last log message and work your way up, considering each of the non-zero rejection reason counts. Verbosity level 9 prints a very detailed explanation about why each observation is used or skipped for each verification task.
 
 point_stat Usage
 ----------------