Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature #2750 mtd_docs #3014

Merged
merged 4 commits into from
Nov 14, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified docs/Flowchart/MET_flowchart.pptx
Binary file not shown.
Binary file added docs/Flowchart/MET_flowchart_v12.0.0.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions docs/Users_Guide/ensemble-stat.rst
Original file line number Diff line number Diff line change
Expand Up @@ -533,10 +533,10 @@ The format of the STAT and ASCII output of the Ensemble-Stat tool are described
- Version number
* - 2
- MODEL
- User provided text string designating model name
- User-provided text string designating model name
* - 3
- DESC
- User provided text string describing the verification task
- User-provided text string describing the verification task
* - 4
- FCST_LEAD
- Forecast lead time in HHMMSS format
Expand Down
Binary file modified docs/Users_Guide/figure/overview-figure.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions docs/Users_Guide/grid-stat.rst
Original file line number Diff line number Diff line change
Expand Up @@ -509,10 +509,10 @@ The format of the STAT and ASCII output of the Grid-Stat tool are the same as th
- Version number
* - 2
- MODEL
- User provided text string designating model name
- User-provided text string designating model name
* - 3
- DESC
- User provided text string describing the verification task
- User-provided text string describing the verification task
* - 4
- FCST_LEAD
- Forecast lead time in HHMMSS format
Expand Down Expand Up @@ -551,7 +551,7 @@ The format of the STAT and ASCII output of the Grid-Stat tool are the same as th
- Selected Vertical level for observations
* - 16
- OBTYPE
- User provided text string designating the observation type
- User-provided text string designating the observation type
* - 17
- VX_MASK
- Verifying masking region indicating the masking grid or polyline region applied
Expand Down
126 changes: 45 additions & 81 deletions docs/Users_Guide/mode-td.rst
Original file line number Diff line number Diff line change
Expand Up @@ -397,10 +397,10 @@ The contents of the OBJECT_ID and OBJECT_CAT columns identify the objects using
- Version number
* - 2
- MODEL
- User provided text string giving model name
- User-provided text string giving model name
* - 3
- DESC
- User provided text string describing the verification task
- User-provided text string describing the verification task
* - 4
- FCST_LEAD
- Forecast lead time in HHMMSS format
Expand Down Expand Up @@ -482,40 +482,22 @@ The contents of the OBJECT_ID and OBJECT_CAT columns identify the objects using
- Time index of slice
* - 26
- AREA
- 2D cross-sectional area
* - 27
- CENTROID_X
- x coordinate of centroid
* - 28
- CENTROID_Y
- y coordinate of centroid
* - 29
- CENTROID_LAT
- Latitude of centroid
* - 30
- CENTROID_LON
- Longitude of centroid
- 2D cross-sectional area (in grid squares)
* - 27-28
- CENTROID_X,_Y
- Location of centroid (in grid units)
* - 29-30
- CENTROID_LAT,_LON
- Location of centroid (in lat/lon degrees)
* - 31
- AXIS_ANG
- Angle that the axis makes with the grid x direction
* - 32
- INTENSITY_10
- :math:`\text{10}^{th}` percentile intensity in time slice
* - 33
- INTENSITY_25
- :math:`\text{25}^{th}` percentile intensity in time slice
* - 34
- INTENSITY_50
- :math:`\text{60}^{th}` percentile intensity in time slice
* - 35
- INTENSITY_75
- :math:`\text{75}^{th}` percentile intensity in time slice
* - 36
- INTENSITY_90
- :math:`\text{90}^{th}` percentile intensity in time slice
- Angle that the axis makes with the grid x direction (in degrees)
* - 32-36
- INTENSITY_10,_25,_50,_75,_90
- 10th, 25th, 50th, 75th, and 90th percentile intensity in time slice (various units)
* - 37
- INTENSITY_*
- User-specified percentile intensity in time slice
- INTENSITY_NN
- User-specified percentile intensity in time slice (various units)

.. _table_mtd-3D-single-attributes:

Expand All @@ -535,60 +517,42 @@ The contents of the OBJECT_ID and OBJECT_CAT columns identify the objects using
* - 24
- OBJECT_CAT
- Object category
* - 25
- CENTROID_X
- x coordinate of centroid
* - 26
- CENTROID_Y
- y coordinate of centroid
* - 25-26
- CENTROID_X,_Y
- Location of the centroid (in grid units)
* - 27
- CENTROID_T
- t coordinate of centroid
* - 28
- CENTROID_LAT
- Latitude of centroid
* - 29
- CENTROID_LON
- Longitude of centroid
- Time coordinate of centroid (in time steps)
* - 28-29
- CENTROID_LAT,_LON
- Location of the centroid (in lat/lon degrees)
* - 30
- X_DOT
- x component of object velocity
- X component of object velocity (in grid units per time step)
* - 31
- Y_DOT
- y component of object velocity
- Y component of object velocity (in grid units per time step)
* - 32
- AXIS_ANG
- Angle that the axis plane of an object makes with the grid x direction
- Angle that the axis plane of an object makes with the grid x direction (in degrees)
* - 33
- VOLUME
- Integer count of the number of 3D "cells" in an object
- 3D object volume (integer count of 3D spacetime cells)
* - 34
- START_TIME
- Object start time
- Object start time (in time steps)
* - 35
- END_TIME
- Object end time
- Object end time (in time steps)
* - 36
- CDIST_TRAVELLED
- Total great circle distance travelled by the 2D spatial centroid over the lifetime of the 3D object
* - 37
- INTENSITY_10
- :math:`\text{10}^{th}` percentile intensity inside object
* - 38
- INTENSITY_25
- :math:`\text{25}^{th}` percentile intensity inside object
* - 39
- INTENSITY_50
- :math:`\text{50}^{th}` percentile intensity inside object
* - 40
- INTENSITY_75
- :math:`\text{75}^{th}` percentile intensity inside object
* - 41
- INTENSITY_90
- :math:`\text{90}^{th}` percentile intensity inside object
- Total great circle distance travelled by the 2D spatial centroid over the lifetime of the 3D object (in kilometers)
* - 37-41
- INTENSITY_10,_25,_50,_75,_90
- 10th, 25th, 50th, 75th, and 90th percentile intensity in spacetime object (various units)
* - 42
- INTENSITY_*
- User-specified percentile intensity inside object
- INTENSITY_NN
- User-specified percentile intensity in spacetime object (various units)

.. _table_mtd-3D-Pair-Attribute:

Expand All @@ -610,37 +574,37 @@ The contents of the OBJECT_ID and OBJECT_CAT columns identify the objects using
- Object category
* - 25
- SPACE_CENTROID_DIST
- Spatial distance between :math:`(x,y)` coordinates of object spacetime centroid
- Cartesian distance between :math:`(x,y)` coordinates of object spacetime centroids (in grid units)
* - 26
- TIME_CENTROID_DELTA
- Difference in *t* index of object spacetime centroid
- Observation minus forecast difference in *t* temporal index of object spacetime centroid (in time steps)
* - 27
- AXIS_DIFF
- Difference in spatial axis plane angles
- Angle between the spatial axis plane angles (in degrees, from 0 to 90)
* - 28
- SPEED_DELTA
- Difference in object speeds
- Forecast minus observation speed difference (in grid units per time step)
* - 29
- DIRECTION_DIFF
- Difference in object direction of movement
- Difference in object direction of movement (in degrees, from 0 to 180)
* - 30
- VOLUME_RATIO
- Forecast object volume divided by observation object volume
- Forecast 3D object volume divided by observation 3D object volume (unitless)
* - 31
- START_TIME_DELTA
- Difference in object starting time steps
- Forecast minus observation starting time step (in time steps)
* - 32
- END_TIME_DELTA
- Difference in object ending time steps
- Forecast minus observation ending time step (in time steps)
* - 33
- INTERSECTION_VOLUME
- "Volume" of object intersection
- 3D object intersection volume (integer count of 3D spacetime cells)
* - 34
- DURATION_DIFF
- Difference in the lifetimes of the two objects
- Forecast minus observation difference in object lifetimes (in time steps)
* - 35
- INTEREST
- Total interest for this object pair
- Total interest for this object pair (unitless)

**NetCDF File**

Expand Down
20 changes: 10 additions & 10 deletions docs/Users_Guide/mode.rst
Original file line number Diff line number Diff line change
Expand Up @@ -590,16 +590,16 @@ The MODE tool creates two ASCII output files. The first ASCII file contains cont
- Version number
* - 2
- MODEL
- User provided text string designating model name
- User-provided text string giving model name
* - 3
- N_VALID
- Number of valid data points
* - 4
- GRID_RES
- User provided nominal grid resolution
- User-provided nominal grid resolution
* - 5
- DESC
- User provided text string describing the verification task
- User-provided text string describing the verification task
* - 6
- FCST_LEAD
- Forecast lead time in HHMMSS format
Expand All @@ -620,13 +620,13 @@ The MODE tool creates two ASCII output files. The first ASCII file contains cont
- Observation accumulation time in HHMMSS format
* - 12
- FCST_RAD
- Forecast convolution radius in grid squares
- Forecast convolution radius in grid units
* - 13
- FCST_THR
- Forecast convolution threshold
* - 14
- OBS_RAD
- Observation convolution radius in grid squares
- Observation convolution radius in grid units
* - 15
- OBS_THR
- Observation convolution threshold
Expand All @@ -650,7 +650,7 @@ The MODE tool creates two ASCII output files. The first ASCII file contains cont
- Observation vertical level
* - 22
- OBTYPE
- User provided observation type
- User-provided observation type
* - 23
- FIELD
- Field type for this line:* RAW for the raw input fields * OBJECT for the resolved object fields
Expand Down Expand Up @@ -790,16 +790,16 @@ The contents of the columns in this ASCII file are summarized in :numref:`MODE_o
- Version number
* - 2
- MODEL
- User provided text string designating model name
- User-provided text string designating model name
* - 3
- N_VALID
- Number of valid data points
* - 4
- GRID_RES
- User provided nominal grid resolution
- User-provided nominal grid resolution
* - 5
- DESC
- User provided text string describing the verification task
- User-provided text string describing the verification task
* - 6
- FCST_LEAD
- Forecast lead time in HHMMSS format
Expand Down Expand Up @@ -850,7 +850,7 @@ The contents of the columns in this ASCII file are summarized in :numref:`MODE_o
- Observation vertical level
* - 22
- OBTYPE
- User provided observation type
- User-provided observation type
* - 23
- OBJECT_ID
- Object numbered from 1 to the number of objects in each field
Expand Down
4 changes: 2 additions & 2 deletions docs/Users_Guide/point-stat.rst
Original file line number Diff line number Diff line change
Expand Up @@ -539,10 +539,10 @@ The first set of header columns are common to all of the output files generated
- Version number
* - 2
- MODEL
- User provided text string designating model name
- User-provided text string designating model name
* - 3
- DESC
- User provided text string describing the verification task
- User-provided text string describing the verification task
* - 4
- FCST_LEAD
- Forecast lead time in HHMMSS format
Expand Down
2 changes: 1 addition & 1 deletion docs/Users_Guide/tc-gen.rst
Original file line number Diff line number Diff line change
Expand Up @@ -506,7 +506,7 @@ TC-Gen produces output in STAT and, optionally, ASCII and NetCDF formats. The AS
- Current ATCF Technique name
* - 3
- DESC
- User provided text string describing the "filter" options
- User-provided text string describing the "filter" options
* - 4
- FCST_LEAD
- Forecast lead time in HHMMSS format
Expand Down
2 changes: 1 addition & 1 deletion docs/Users_Guide/tc-rmw.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ TC-RMW Tool
Introduction
============

The TC-RMW tool regrids tropical cyclone model data onto a moving range-azimuth grid centered on points along the storm track provided in ATCF format, most likely the adeck generated from the file. The radial grid spacing can be defined in kilometers or as a factor of the radius of maximum winds (RMW). The azimuthal grid spacing is defined in degrees clockwise from due east. If wind vector fields are specified in the configuration file, the radial and tangential wind components will be computed. Any regridding method available in MET can be used to interpolate data on the model output grid to the specified range-azimuth grid. The regridding will be done separately on each vertical level. The model data files must coincide with track points in a user provided ATCF formatted track file.
The TC-RMW tool regrids tropical cyclone model data onto a moving range-azimuth grid centered on points along the storm track provided in ATCF format, most likely the adeck generated from the file. The radial grid spacing can be defined in kilometers or as a factor of the radius of maximum winds (RMW). The azimuthal grid spacing is defined in degrees clockwise from due east. If wind vector fields are specified in the configuration file, the radial and tangential wind components will be computed. Any regridding method available in MET can be used to interpolate data on the model output grid to the specified range-azimuth grid. The regridding will be done separately on each vertical level. The model data files must coincide with track points in a user-provided ATCF formatted track file.

Practical Information
=====================
Expand Down
6 changes: 3 additions & 3 deletions docs/Users_Guide/wavelet-stat.rst
Original file line number Diff line number Diff line change
Expand Up @@ -345,10 +345,10 @@ The format of the STAT and ASCII output of the Wavelet-Stat tool is similar to t
- Version number
* - 2
- MODEL
- User provided text string designating model name
- User-provided text string designating model name
* - 3
- DESC
- User provided text string describing the verification task
- User-provided text string describing the verification task
* - 4
- FCST_LEAD
- Forecast lead time in HHMMSS format
Expand Down Expand Up @@ -387,7 +387,7 @@ The format of the STAT and ASCII output of the Wavelet-Stat tool is similar to t
- Selected Vertical level for observations
* - 16
- OBTYPE
- User provided text string designating the observation type
- User-provided text string designating the observation type
* - 17
- VX_MASK
- Verifying masking region indicating the masking grid or polyline region applied
Expand Down