From 280bf57fa0d5a15bd436891150e8406a240952a3 Mon Sep 17 00:00:00 2001 From: Lisa Goodrich Date: Mon, 23 Oct 2023 11:15:46 -0600 Subject: [PATCH 01/12] fixing headers, adding Contributors Guide to the index file --- docs/Contributors_Guide/index.rst | 5 ++--- docs/Contributors_Guide/testing.rst | 23 ++++++++++++----------- docs/index.rst | 20 ++++++++++---------- 3 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/Contributors_Guide/index.rst b/docs/Contributors_Guide/index.rst index a1ddc46f..b08361e8 100644 --- a/docs/Contributors_Guide/index.rst +++ b/docs/Contributors_Guide/index.rst @@ -1,7 +1,6 @@ - -=================== +################### Contributor's Guide -=================== +################### .. toctree:: :titlesonly: diff --git a/docs/Contributors_Guide/testing.rst b/docs/Contributors_Guide/testing.rst index 78f7da56..6a64b28a 100644 --- a/docs/Contributors_Guide/testing.rst +++ b/docs/Contributors_Guide/testing.rst @@ -1,8 +1,9 @@ +************** Testing Module -============== +************** -Testing example - install and run on dakota -------------------------------------------- +Testing Example - Install and Run on dakota +=========================================== **Testing directory and branch information** @@ -45,8 +46,8 @@ stored in the `git store `_ . Also, **auto_test.sh** should be modified to send emails with testing results. -Testing - capture ------------------ +Testing - Capture +================= The testing module is used to execute the regression testing of a specified version of METviewer. The capture tool is invoked by using the mv_test.sh @@ -173,13 +174,13 @@ directory structure might look like this, for example... ... -Testing - verify ----------------- +Testing - Verify +================ The mv_compare.sh script accepts a branch and a tag that it uses to identify a test subdirectory and a second "expected" branch and tag that it uses to identify a comparison test directory. If tags are omitted the HEAD is used. The compare script looks for corresponding image files in the corresponding plots directories and does a binary comparison of the corresponding files. Differences will be reported as errors. -auto test ---------- +Auto Test +========= The auto_test.sh script defines the branch, optionally a tag, directories, and database credentials for a version under test and a comparison version. It performs the following steps. @@ -286,8 +287,8 @@ to pass, produced and expected files should be byte identical. NOTE: R scripts create visually similar results but bitwise different image files on different platforms. -Testing submodules ------------------- +Testing Submodules +================== **LoadDataTest** recreates and refills the mv_test database with MET output data and compares the number of rows in each table with the expected number. diff --git a/docs/index.rst b/docs/index.rst index f4333c92..c513547a 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,12 +1,14 @@ -=========================== +########################### METviewer version |version| -=========================== +########################### + Developed by the `Developmental Testbed Center `_, Boulder, CO .. image:: _static/METplus_banner_photo_web.png History -------- +======= + The Model Evaluation Tools (MET) were developed by the Developmental Testbed Center (DTC) and released in January 2008. The goal of the tools was to provide the community with a platform independent and extensible @@ -35,7 +37,8 @@ It is being actively developed by NCAR, ESRL, EMC and is open to community contributions. METplus Concept ---------------- +=============== + METplus is the overarching, or umbrella, repository and hence framework for the Unified Forecast System verification capability. It is intended to be extensible through adding additional capability developed by the community. @@ -74,7 +77,7 @@ that are developed and managed independently. Each component also may have additional "external" dependencies that need to be maintained independently. Acronyms --------- +======== * **MET** - Model Evaluation Tools * **DTC** - Developmental Testbed Center @@ -91,7 +94,7 @@ Acronyms * **GSD** - Global Systems Division Authors -------- +======= Many authors, listed below in alphabetical order, have contributed to the documentation of METplus. To cite this documentation in publications, please refer to the METviewer User's Guide :ref:`Citation Instructions`. @@ -112,12 +115,9 @@ To cite this documentation in publications, please refer to the METviewer User's :caption: METviewer Users_Guide/index + Contributors_Guide/index Index ===== * :ref:`genindex` - - - - From daeade26e97cb7ab6c2fca0b82d12e55510cb267 Mon Sep 17 00:00:00 2001 From: Lisa Goodrich Date: Mon, 23 Oct 2023 11:23:17 -0600 Subject: [PATCH 02/12] removing Contributors Guide. It crashed. --- docs/index.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/index.rst b/docs/index.rst index c513547a..9ad12fdb 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -115,7 +115,6 @@ To cite this documentation in publications, please refer to the METviewer User's :caption: METviewer Users_Guide/index - Contributors_Guide/index Index ===== From f785521868a5340b6c70eb3e1b742a00a608dbf2 Mon Sep 17 00:00:00 2001 From: Lisa Goodrich Date: Mon, 23 Oct 2023 14:11:38 -0600 Subject: [PATCH 03/12] updating headers and some titles with capitalizing --- docs/Users_Guide/barplots.rst | 9 ++++--- docs/Users_Guide/batch.rst | 10 +++++--- docs/Users_Guide/boxplot.rst | 9 ++++--- docs/Users_Guide/common.rst | 3 ++- docs/Users_Guide/contourplot.rst | 9 ++++--- docs/Users_Guide/database_loading.rst | 8 +++--- docs/Users_Guide/database_scrubbing.rst | 5 ++-- docs/Users_Guide/eclvplots.rst | 12 +++++---- docs/Users_Guide/etb_plot.rst | 9 ++++--- docs/Users_Guide/index.rst | 4 +-- docs/Users_Guide/installation.rst | 12 +++++---- docs/Users_Guide/overview.rst | 34 ++++++++++++------------- docs/Users_Guide/perfdiag.rst | 12 +++++---- docs/Users_Guide/references.rst | 3 ++- docs/Users_Guide/reliabilityplots.rst | 13 ++++++---- docs/Users_Guide/rocplot.rst | 12 +++++---- docs/Users_Guide/scorecard.rst | 16 +++++++----- docs/Users_Guide/seriesplots.rst | 9 ++++--- docs/Users_Guide/spreadskillplot.rst | 9 ++++--- docs/Users_Guide/taylordiag.rst | 12 +++++---- docs/Users_Guide/web_service.rst | 18 +++++++------ 21 files changed, 129 insertions(+), 99 deletions(-) diff --git a/docs/Users_Guide/barplots.rst b/docs/Users_Guide/barplots.rst index 32e65f76..3c263781 100644 --- a/docs/Users_Guide/barplots.rst +++ b/docs/Users_Guide/barplots.rst @@ -1,8 +1,9 @@ +********* Bar Plots -========= +********* Description ------------ +=========== A bar plot shows comparisons among discrete categories. One axis of the chart shows the specific categories being compared, while the other @@ -22,7 +23,7 @@ Bar plots often represent counts or frequencies, however, bar plots can represent means, medians, standard deviations, or any other statistic. How-To -------- +====== Selection of options to produce the plot proceeds approximately counter-clockwise around the METviewer window. The steps to create a series @@ -92,7 +93,7 @@ plot are: There are many other options for plots, but these are the basics. Example --------- +======= The image below shows an example of the plot and set-up options for a series plot in METviewer. This example uses the database diff --git a/docs/Users_Guide/batch.rst b/docs/Users_Guide/batch.rst index 63e719cc..fdbf23dd 100644 --- a/docs/Users_Guide/batch.rst +++ b/docs/Users_Guide/batch.rst @@ -1,5 +1,6 @@ +********************* Batch Plotting Module -===================== +********************* The batch plotting system is used to generate a number of plots of data in the METviewer database. The usage statement: @@ -439,10 +440,11 @@ starting at 1 for each fcst_var. | MODE Statistics ---------------- +=============== Single Object Statistics -~~~~~~~~~~~~~~~~~~~~~~~~ +------------------------ + MODE statistics are broken up into two categories: single and pair statistics. Single statistics are suffixed with a three letter code which indicates the group of objects over which the statistic should be calculated @@ -597,7 +599,7 @@ RATIO\_ with AREARAT\_ and OBJ with OBJA. - OBJFBIAS Pair Object Statistics -~~~~~~~~~~~~~~~~~~~~~~ +---------------------- MODE object pair statistics are specified using the following format: STATNAME_CC where STATNAME is one of the Object Pair Statistics in the diff --git a/docs/Users_Guide/boxplot.rst b/docs/Users_Guide/boxplot.rst index a5cb6d26..e505dc15 100644 --- a/docs/Users_Guide/boxplot.rst +++ b/docs/Users_Guide/boxplot.rst @@ -1,8 +1,9 @@ +********* Box Plots -========= +********* Description ------------ +=========== Box plots, or box and whisker plots, are a way to summarize a distribution of values using Tukey's 5-number summary @@ -27,7 +28,7 @@ threshold. Here, each forecast and observation is binary, but the verification statistic is continuous. How-To ---------- +====== Selection of options to produce the plot proceeds approximately counter-clockwise around the METviewer window. The steps to create a @@ -105,7 +106,7 @@ There are many other options for plots, but these are the basics. Example --------- +======= The example below shows a boxplot of the RMSE for 2m temperature over the CONUS. Many of the standard METviewer plotting options are available diff --git a/docs/Users_Guide/common.rst b/docs/Users_Guide/common.rst index 0245046d..891cc6a7 100644 --- a/docs/Users_Guide/common.rst +++ b/docs/Users_Guide/common.rst @@ -1,5 +1,6 @@ +********************* Common XML Structures -===================== +********************* The database loading module and batch plotting module both use XML input files. Some XML structures can be used in either input file. These common structures are documented below. diff --git a/docs/Users_Guide/contourplot.rst b/docs/Users_Guide/contourplot.rst index 6dc62863..debd71eb 100644 --- a/docs/Users_Guide/contourplot.rst +++ b/docs/Users_Guide/contourplot.rst @@ -1,8 +1,9 @@ +************* Contour Plots -============= +************* Description ------------ +=========== Contour plots are a very general plot type somewhat similar to a scatter plot. The axes are specified by the user, and any will do so long as the @@ -13,7 +14,7 @@ examine the difference in statistics between two NWP models as a contour plot, as is shown in the example below. How-To -------- +====== Selection of options to produce the plot proceeds approximately counter-clockwise around the METviewer window. The steps to create a contour @@ -76,7 +77,7 @@ plot are: There are many other options for plots, but these are the basics. Example --------- +======= The example is a contour plot of temperature mean error (bias) for one model at different pressure levels over a range of initialization times. diff --git a/docs/Users_Guide/database_loading.rst b/docs/Users_Guide/database_loading.rst index 74c26e6b..39b0d761 100644 --- a/docs/Users_Guide/database_loading.rst +++ b/docs/Users_Guide/database_loading.rst @@ -1,5 +1,6 @@ +*********************** Database Loading Module -======================= +*********************** The database loading module is used to insert, update, and delete MET output data in the database. The tool is invoked using the mv_load.sh script. The @@ -134,7 +135,7 @@ change it to Example -------- +======= Here is a simple example: @@ -203,7 +204,8 @@ specified by the named folder_dates. ... Troubleshooting ---------------- +=============== + .. _test: .. list-table:: diff --git a/docs/Users_Guide/database_scrubbing.rst b/docs/Users_Guide/database_scrubbing.rst index 01f3ff05..956114b1 100644 --- a/docs/Users_Guide/database_scrubbing.rst +++ b/docs/Users_Guide/database_scrubbing.rst @@ -1,5 +1,6 @@ +************************* Database Scrubbing Module -========================= +************************* The database scrubbing utility is used to to delete data from METviewer databases that meets some user-specified selection criteria. The usage @@ -58,7 +59,7 @@ performed (**FALSE**). | Examples --------- +======== **Example 1: Prune by describing the data ()** diff --git a/docs/Users_Guide/eclvplots.rst b/docs/Users_Guide/eclvplots.rst index 1f1f94ad..2bf1bccf 100644 --- a/docs/Users_Guide/eclvplots.rst +++ b/docs/Users_Guide/eclvplots.rst @@ -1,8 +1,9 @@ +****************************** Economic Cost/Loss Value Plots -============================== +****************************** Description ------------ +=========== The Economic Cost Loss Value statistic is sometimes also called the Relative value score (:ref:`Richardson, 2000`; @@ -23,11 +24,12 @@ The ECLV score can range from -:math:`\infty` to 1. Like ROC diagrams, it gives information that can be used in decision making. Line Type ---------- +========= + ECLV requires the ECLV line type generated by either Point-Stat or Grid-Stat. How-To ------- +====== Selection of options to produce the ECLV plot proceeds approximately counter-clockwise around the METviewer window. @@ -81,7 +83,7 @@ counter-clockwise around the METviewer window. Example --------- +======= The figure below shows an ECLV plot. In this example, three different forecasting systems are used to predict precipitation at two different diff --git a/docs/Users_Guide/etb_plot.rst b/docs/Users_Guide/etb_plot.rst index 01159734..1ae97729 100644 --- a/docs/Users_Guide/etb_plot.rst +++ b/docs/Users_Guide/etb_plot.rst @@ -1,8 +1,9 @@ +******************************** Equivalence Testing Bounds Plots -================================ +******************************** Description ------------ +=========== A statistical hypothesis is an assertion about the distribution function for one or more random variables. Generally, two hypotheses are considered, a null hypothesis denoted by H0, and an alternative denoted by @@ -32,7 +33,7 @@ In this case, H0 is accepted if the CI bounds fall completely between the tolera and H0 is rejected otherwise. How-To -------- +====== Selection of options to produce the plot proceeds approximately counter-clockwise around the METviewer window. The steps to create a @@ -104,7 +105,7 @@ There are many other options for plots, but these are the basics. Example --------- +======= The image below shows an example of the plot and set-up options for a series plot in METviewer. This example uses the database diff --git a/docs/Users_Guide/index.rst b/docs/Users_Guide/index.rst index 237d3271..c7553d0e 100644 --- a/docs/Users_Guide/index.rst +++ b/docs/Users_Guide/index.rst @@ -1,6 +1,6 @@ -============ +############ User's Guide -============ +############ **Foreword: A note to METviewer users** diff --git a/docs/Users_Guide/installation.rst b/docs/Users_Guide/installation.rst index 00ac5e20..ce9eee8b 100644 --- a/docs/Users_Guide/installation.rst +++ b/docs/Users_Guide/installation.rst @@ -1,17 +1,18 @@ .. _install: +**************************** METviewer Installation Guide -============================ +**************************** Introduction ------------- +============ This chapter describes how to install METviewer. METviewer has been developed and tested on Linux operating systems. Support for additional platforms and compilers may be added in future releases. Installing METviewer --------------------- +==================== METviewer relies on the following tools. These must be installed and tested prior to installing METviewer: @@ -118,7 +119,7 @@ clone `METdataio repository `_ git clone https://github.com/dtcenter/METdataio.git Configure and build METviewer -_____________________________ +----------------------------- #. Configure the batch and loading tools: @@ -225,7 +226,8 @@ _____________________________ ln -s /d3/projects/METViewer/src_dev/apps/verif/metviewer/sql/mv_mysql.sql mv_mysql.sql Making a Database Accessible in the METviewer Web Application -------------------------------------------------------------- +============================================================= + To make a new database accessible in the METviewer Web Application click on "Reload list of databases" button in the upper right corner of the main JSP page. The list of available databases should be updated and a diff --git a/docs/Users_Guide/overview.rst b/docs/Users_Guide/overview.rst index 5b494767..10826d6a 100644 --- a/docs/Users_Guide/overview.rst +++ b/docs/Users_Guide/overview.rst @@ -1,9 +1,9 @@ +********************* Overview of METviewer -===================== +********************* - -Purpose and organization of the User's Guide --------------------------------------------- +Purpose and Organization of the User's Guide +============================================ The goal of this User's Guide is to provide basic information for users of the METviewer database and display system to enable users to create plots @@ -13,7 +13,7 @@ The METviewer User's Guide is organized as follows. The Developmental Testbed Center (DTC) --------------------------------------- +====================================== METviewer has been developed, and will be maintained and enhanced, by the Developmental Testbed Center (`DTC `_ ). The main @@ -34,8 +34,8 @@ modeling community for testing and evaluation of new model capabilities, applications in new environments, and so on. -METviewer goals and design philosophy -------------------------------------- +METviewer Goals and Design Philosophy +===================================== The METviewer tool reads MET verification statistics output from a database and creates plots using the R statistical package. The tool includes a web @@ -55,7 +55,7 @@ private sector, and operational modeling and prediction centers. METviewer Requirements ----------------------- +====================== METviewer requires installation of Java, Apache / Tomcat, MySQL, and R statistics. @@ -70,7 +70,7 @@ statistics. .. _userspec: METviewer User Specifications ------------------------------ +============================= The top menu allows the user to select a database and type for the plot. @@ -121,7 +121,7 @@ trying to compare the skill of one or more predictions. METviewer Output ----------------- +================ METviewer output all appears in the tabbed boxes at the top right quadrant of the web browser. The plot will show by default, but the user can click any @@ -160,7 +160,7 @@ recommended that the user click through at least the plot and xml windows and save this output. METviewer Plot Formatting Specifications ----------------------------------------- +======================================== METviewer plot formatting options appear in the tabbed boxes at the bottom right quadrant of the web browser. The “Titles & Labels” tab will show by @@ -193,7 +193,7 @@ reset all options to the defaults. METviewer Series Formatting Specifications ------------------------------------------- +========================================== At the bottom of the METviewer window is the series formatting box. It allows the user to control the minute details of each line on a plot, including @@ -205,7 +205,7 @@ place (so subsequent plots are identical in format). METviewer History Menu ----------------------- +====================== Along the left of the METviewer GUI, hidden by default, is the history menu. To open this menu, click the arrow at the top left side right underneath @@ -215,8 +215,8 @@ from this menu to recover plots they may have neglected to save. Clicking on the button showing loads the plot. -Future development plans ------------------------- +Future Development Plans +======================== METviewer is an evolving verification database and display software package. New capabilities are planned in controlled, successive version releases. Bug @@ -226,8 +226,8 @@ releases of METviewer. Additionally, updates to accommodate new features of the MET software are often required. -Code support ------------- +Code Support +============ METviewer support is provided through the `METplus GitHub Discussions Forum `_. diff --git a/docs/Users_Guide/perfdiag.rst b/docs/Users_Guide/perfdiag.rst index 7fae76d7..055547ec 100644 --- a/docs/Users_Guide/perfdiag.rst +++ b/docs/Users_Guide/perfdiag.rst @@ -1,8 +1,9 @@ +******************** Performance Diagrams -==================== +******************** Description ------------ +=========== Performance diagrams are used to show the relationship between categorical statistics, with axes representing detection and success (1 - false alarm) @@ -23,7 +24,8 @@ to the right side. CSI amounts are listed to the right side of the plot, with better values falling closer to the top. Line Type ---------- +========= + Performance requires categorical statistics generated by either Point-Stat or Grid-Stat. These are: @@ -32,7 +34,7 @@ or Grid-Stat. These are: * CTS How-To -------- +====== Selection of options to produce the reliability diagram proceeds approximately counter-clockwise around the METviewer window. @@ -84,7 +86,7 @@ approximately counter-clockwise around the METviewer window. There are many other options for plots, but these are the basics. Example --------- +======= The reliability diagram shown below is for 3 hour accumulated precipitation over the CONUS for 8 ensemble members at the 18 hour diff --git a/docs/Users_Guide/references.rst b/docs/Users_Guide/references.rst index c42baaf8..1eb12194 100644 --- a/docs/Users_Guide/references.rst +++ b/docs/Users_Guide/references.rst @@ -1,5 +1,6 @@ +********** References -========== +********** .. _Hoaglin: diff --git a/docs/Users_Guide/reliabilityplots.rst b/docs/Users_Guide/reliabilityplots.rst index f6ba23d6..cda0ff25 100644 --- a/docs/Users_Guide/reliabilityplots.rst +++ b/docs/Users_Guide/reliabilityplots.rst @@ -1,8 +1,10 @@ + +***************** Reliability Plots -================= +***************** Description ------------ +=========== Reliability (or attributes) diagrams are used to show the conditional bias of probabilistic forecasts. If a probability forecast is reliable, then @@ -26,13 +28,14 @@ Reliability diagrams can be used to make adjustments to the conditional bias of the forecast probabilities. Line Type ---------- +========= + Reliability diagrams require the probability statistics (PCT line type) generated by either Point-Stat or Grid-Stat. How-To -------- +====== Selection of options to produce the reliability diagram proceeds approximately counter-clockwise around the METviewer window. @@ -101,7 +104,7 @@ There are many other options for plots, but these are the basics. Example --------- +======= The reliability diagram shown below is for the probability of 24 hour precipitation with accumulations greater than or equal to 12.7 cm occurring diff --git a/docs/Users_Guide/rocplot.rst b/docs/Users_Guide/rocplot.rst index 3e942f6c..004db4c7 100644 --- a/docs/Users_Guide/rocplot.rst +++ b/docs/Users_Guide/rocplot.rst @@ -1,8 +1,9 @@ +********************************************* Receiver Operating Characteristic (ROC) Plots -============================================== +********************************************* Description ------------ +=========== MET produces a hit rate (Probability of Detection; POD) and Probability of False Detection (POFD) values for each user-specified threshold of a forecast @@ -24,7 +25,8 @@ conditioned on the forecasts. Line Type ---------- +========= + ROC requires probability statistics generated by either Point-Stat or Grid-Stat. These line types are: @@ -33,7 +35,7 @@ Grid-Stat. These line types are: * CTC How-To -------- +====== Selection of options to produce the ROC plot proceeds approximately counter-clockwise around the METviewer window. @@ -100,7 +102,7 @@ There are many other options for plots, but these are the basics. Example --------- +======= The plot shown below is for two different probability of precipitation forecasts. The dashed diagonal line represents the no-skill line. Ideal diff --git a/docs/Users_Guide/scorecard.rst b/docs/Users_Guide/scorecard.rst index 37413d85..708ef122 100644 --- a/docs/Users_Guide/scorecard.rst +++ b/docs/Users_Guide/scorecard.rst @@ -1,16 +1,17 @@ +********** Scorecards -========== +********** Description ------------ +=========== A scorecard is a graphical representation of significance and performance of a comparison, normally a comparison between two models. The scorecard can only be produced using xml code. The xml code specifications are listed in the detail below. There is no GUI interface. -EMC vs. NCAR method of determining p-values for Aggregation statistics ----------------------------------------------------------------------- +EMC vs. NCAR Method of Determining p-values for Aggregation Statistics +====================================================================== In statistics, the p-value represents the probability of a statistic having a value at least as extreme as observed, in this case a difference between two @@ -42,7 +43,8 @@ compared to a resampled distribution rather than a known, theoretical distribution. Line Type ---------- +========= + Scorecards can be run with either summary or aggregation logic. Aggregation logic is the default and generally, the better choice. The following are line types scorecards support: @@ -70,7 +72,7 @@ line types scorecards support: * RPS How-To -------- +====== The scorecard module is used to generate a scorecard PNG and HTML images using data in the METviewer database. The usage statement: @@ -316,7 +318,7 @@ system folders. image. Default value: Verification Scorecard Example -------- +======= The image below shows the output of scorecard_example.xml. diff --git a/docs/Users_Guide/seriesplots.rst b/docs/Users_Guide/seriesplots.rst index cefc74b2..c045928e 100644 --- a/docs/Users_Guide/seriesplots.rst +++ b/docs/Users_Guide/seriesplots.rst @@ -1,8 +1,9 @@ +************ Series Plots -============ +************ Description ------------ +=========== The series plot is the most general of all the METviewer plotting options. A series plot is really just a special case of a scatter plot, where the @@ -15,7 +16,7 @@ lead times or thresholds (on the X-axis). The tremendous flexibility of this plot means that the user must specify many options. How-To -------- +====== Selection of options to produce the plot proceeds approximately counter-clockwise around the METviewer window. The steps to create a @@ -93,7 +94,7 @@ There are many other options for plots, but these are the basics. Example --------- +======= The image below shows an example of the plot and set-up options for a series plot in METviewer. This example uses the database diff --git a/docs/Users_Guide/spreadskillplot.rst b/docs/Users_Guide/spreadskillplot.rst index 2ef6ad66..d4308029 100644 --- a/docs/Users_Guide/spreadskillplot.rst +++ b/docs/Users_Guide/spreadskillplot.rst @@ -1,8 +1,9 @@ +********************** Spread vs. Skill Plots -======================= +********************** Description ------------ +=========== Spread vs. Skill plots are widely used to evaluate the quality of ensemble forecasting systems. One goal of ensemble forecasting is to have the @@ -17,7 +18,7 @@ ratio is 1. How-To -------- +====== Selection of options to produce the spread vs. skill plot proceeds approximately counter-clockwise around the METviewer window. @@ -89,7 +90,7 @@ approximately counter-clockwise around the METviewer window. There are many other options for plots, but these are the basics. Example --------- +======= This example shows the 2-m temperature RMSE and spread for a series of forecast lead times for an ensemble. Plotted are the spread and the skill. diff --git a/docs/Users_Guide/taylordiag.rst b/docs/Users_Guide/taylordiag.rst index 9b1d4e67..b3ff159f 100644 --- a/docs/Users_Guide/taylordiag.rst +++ b/docs/Users_Guide/taylordiag.rst @@ -1,8 +1,9 @@ +*************** Taylor Diagrams -=============== +*************** Description ------------ +=========== Taylor diagrams are used to show a relationship between continuous statistics (:ref:`Taylor, 2001`). This type of plot is used to @@ -32,12 +33,13 @@ So, better forecasts lie closer on the Taylor diagram to observation point, while worse forecasts lie further away. Line Type ---------- +========= + Taylor requires continuous statistics, SL1L2, generated by either Point-Stat or Grid-Stat. How-To -------- +====== Selection of options to produce the Taylor diagram proceeds approximately counter-clockwise around the METviewer window. @@ -90,7 +92,7 @@ There are many other options for plots, but these are the basics. Example -------- +======= The example Taylor diagram below shows the downward longwave radiation flux (DLWRF) correlation and standard deviation for one model and seven diff --git a/docs/Users_Guide/web_service.rst b/docs/Users_Guide/web_service.rst index 1b269694..b78c0e88 100644 --- a/docs/Users_Guide/web_service.rst +++ b/docs/Users_Guide/web_service.rst @@ -1,5 +1,6 @@ +********************* METviewer Web Service -===================== +********************* The METviewer web service is a web-server driven API that parses XML requests and returns results in an XML structure. All calls are @@ -33,13 +34,13 @@ loose ordering: #. Plot request for user selected database and plot information API Request/Response Formats ----------------------------- +============================ The following sections each describe a web service API function in terms of the request/response XML structure. List Databases -~~~~~~~~~~~~~~ +-------------- List the METviewer databases that are available on the system for access through the web app. The returned list reflects the contents of the @@ -64,7 +65,7 @@ Response: List Values -~~~~~~~~~~~ +----------- The list_val request is used to conditionally list the distinct values in the stat_header table of the selected database. The stat_field element @@ -148,7 +149,7 @@ vice versa. List Statistics -~~~~~~~~~~~~~~~ +--------------- The list_stat request builds a list of all statistics available in the METviewer database for the specified fcst_var. It is primarily used to @@ -182,7 +183,7 @@ criteria is not supported in list_stat requests. Generate Plot -~~~~~~~~~~~~~ +------------- Once a user has provided all the information for a complete plot specification, the plot request handles the parsing of the plot @@ -210,8 +211,9 @@ element. NAs produced by integer overflow -Open app with predefine database -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Open App with Predefine Database +-------------------------------- + Use this url to open METviewer main page with predefine database: http://www.dtcenter.org/met/metviewer/metviewer1.jsp?db=name_of_database From f3dd28398a42ccf05e5e64b416ee9c783e0cff08 Mon Sep 17 00:00:00 2001 From: lisagoodrich <33230218+lisagoodrich@users.noreply.github.com> Date: Tue, 24 Oct 2023 15:09:18 -0600 Subject: [PATCH 04/12] changing Template Formatting to it's own section --- docs/Users_Guide/batch.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/Users_Guide/batch.rst b/docs/Users_Guide/batch.rst index fdbf23dd..688ff52c 100644 --- a/docs/Users_Guide/batch.rst +++ b/docs/Users_Guide/batch.rst @@ -171,7 +171,8 @@ conceptually, a list of **** structures. | **:** Turns on a difference curve should be plotted for the y2 series; calculated as the pairwise difference between the members of the first series minus the second - example:list(c("series1","series2"), c("series3","series4")). | -**Template Formatting** +Template Formatting +=================== Template values have the syntax {var_name[?param1=val1[&param2=val2[...]]]}. For example, From a568946c93e2915e1a02c2f8c188dc092870bf80 Mon Sep 17 00:00:00 2001 From: Julie Prestopnik Date: Wed, 25 Oct 2023 14:05:52 -0600 Subject: [PATCH 05/12] Adding Contributors Guide to make it viewable --- docs/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/index.rst b/docs/index.rst index 9ad12fdb..c513547a 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -115,6 +115,7 @@ To cite this documentation in publications, please refer to the METviewer User's :caption: METviewer Users_Guide/index + Contributors_Guide/index Index ===== From e57138d2c4a89d0b6247a32dfa286ddb5428c4ae Mon Sep 17 00:00:00 2001 From: Julie Prestopnik Date: Wed, 25 Oct 2023 14:35:14 -0600 Subject: [PATCH 06/12] Removing Contributor's Guide from exclude_patterns --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index a198e896..f852d30b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -42,7 +42,7 @@ # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. # This pattern also affects html_static_path and html_extra_path. -exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'Contributors_Guide'] +exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] # Suppress certain warning messages suppress_warnings = ['ref.citation'] From ffd3904c5f2d0a53a1bbafc3818bb2de54015066 Mon Sep 17 00:00:00 2001 From: lisagoodrich <33230218+lisagoodrich@users.noreply.github.com> Date: Wed, 1 Nov 2023 11:15:18 -0600 Subject: [PATCH 07/12] Update docs/Users_Guide/installation.rst Co-authored-by: Julie Prestopnik --- docs/Users_Guide/installation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Users_Guide/installation.rst b/docs/Users_Guide/installation.rst index ce9eee8b..d368621d 100644 --- a/docs/Users_Guide/installation.rst +++ b/docs/Users_Guide/installation.rst @@ -118,7 +118,7 @@ clone `METdataio repository `_ git clone https://github.com/dtcenter/METdataio.git -Configure and build METviewer +Configure and Build METviewer ----------------------------- #. Configure the batch and loading tools: From b47ce88131273c95d109e6f928a50d29d5b7a6ca Mon Sep 17 00:00:00 2001 From: lisagoodrich <33230218+lisagoodrich@users.noreply.github.com> Date: Wed, 1 Nov 2023 11:15:37 -0600 Subject: [PATCH 08/12] Update docs/Users_Guide/web_service.rst Co-authored-by: Julie Prestopnik --- docs/Users_Guide/web_service.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Users_Guide/web_service.rst b/docs/Users_Guide/web_service.rst index b78c0e88..c3f68172 100644 --- a/docs/Users_Guide/web_service.rst +++ b/docs/Users_Guide/web_service.rst @@ -211,7 +211,7 @@ element. NAs produced by integer overflow -Open App with Predefine Database +Open App with Predefined Database -------------------------------- Use this url to open METviewer main page with predefine database: From 9db076c5a4eda69b960b470f73a08cc902f96234 Mon Sep 17 00:00:00 2001 From: lisagoodrich <33230218+lisagoodrich@users.noreply.github.com> Date: Wed, 1 Nov 2023 11:16:08 -0600 Subject: [PATCH 09/12] Update docs/Users_Guide/web_service.rst Co-authored-by: Julie Prestopnik --- docs/Users_Guide/web_service.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Users_Guide/web_service.rst b/docs/Users_Guide/web_service.rst index c3f68172..8a6306bc 100644 --- a/docs/Users_Guide/web_service.rst +++ b/docs/Users_Guide/web_service.rst @@ -214,7 +214,7 @@ element. Open App with Predefined Database -------------------------------- -Use this url to open METviewer main page with predefine database: +Use this url to open METviewer main page with predefined database: http://www.dtcenter.org/met/metviewer/metviewer1.jsp?db=name_of_database From 847625d0f9f30e10699791d1e6932bf109a8c749 Mon Sep 17 00:00:00 2001 From: Lisa Goodrich Date: Wed, 1 Nov 2023 11:21:08 -0600 Subject: [PATCH 10/12] fixing header underline --- docs/Users_Guide/web_service.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Users_Guide/web_service.rst b/docs/Users_Guide/web_service.rst index 8a6306bc..4d2e8d5b 100644 --- a/docs/Users_Guide/web_service.rst +++ b/docs/Users_Guide/web_service.rst @@ -212,7 +212,7 @@ element. Open App with Predefined Database --------------------------------- +--------------------------------- Use this url to open METviewer main page with predefined database: From f769435ad884486867a11fd47083dd3e71ec4e6c Mon Sep 17 00:00:00 2001 From: Lisa Goodrich Date: Wed, 1 Nov 2023 11:27:13 -0600 Subject: [PATCH 11/12] returning headers to their original state --- docs/index.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/index.rst b/docs/index.rst index c513547a..dcf39dff 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,13 +1,13 @@ -########################### +=========================== METviewer version |version| -########################### +=========================== Developed by the `Developmental Testbed Center `_, Boulder, CO .. image:: _static/METplus_banner_photo_web.png History -======= +------- The Model Evaluation Tools (MET) were developed by the Developmental Testbed Center (DTC) and released in January 2008. The goal of the tools @@ -37,7 +37,7 @@ It is being actively developed by NCAR, ESRL, EMC and is open to community contributions. METplus Concept -=============== +--------------- METplus is the overarching, or umbrella, repository and hence framework for the Unified Forecast System verification capability. It is intended to be @@ -77,7 +77,7 @@ that are developed and managed independently. Each component also may have additional "external" dependencies that need to be maintained independently. Acronyms -======== +-------- * **MET** - Model Evaluation Tools * **DTC** - Developmental Testbed Center @@ -94,7 +94,7 @@ Acronyms * **GSD** - Global Systems Division Authors -======= +------- Many authors, listed below in alphabetical order, have contributed to the documentation of METplus. To cite this documentation in publications, please refer to the METviewer User's Guide :ref:`Citation Instructions`. @@ -118,6 +118,6 @@ To cite this documentation in publications, please refer to the METviewer User's Contributors_Guide/index Index -===== +----- * :ref:`genindex` From 7dc115345cbe00aa5f968f03c325360b80c19987 Mon Sep 17 00:00:00 2001 From: Julie Prestopnik Date: Wed, 1 Nov 2023 12:25:43 -0600 Subject: [PATCH 12/12] Changing Index header back to its original state --- docs/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/index.rst b/docs/index.rst index dcf39dff..a2a4def7 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -118,6 +118,6 @@ To cite this documentation in publications, please refer to the METviewer User's Contributors_Guide/index Index ------ +===== * :ref:`genindex`