Skip to content

Commit

Permalink
updating questions into the TOC. test #1998
Browse files Browse the repository at this point in the history
  • Loading branch information
@lisagoodrich
lisagoodrich committed Feb 2, 2022
1 parent 3de7e2e commit 2a077af
Showing 1 changed file with 44 additions and 35 deletions.
79 changes: 44 additions & 35 deletions met/docs/Users_Guide/appendixA.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,8 @@ Frequently Asked Questions
File-IO
-------

**Q. File-IO - How do I improve the speed of MET tools using Gen-Vx-Mask?**
Q. File-IO - How do I improve the speed of MET tools using Gen-Vx-Mask?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
The main reason to run gen_vx_mask is to make the MET
Expand All @@ -24,7 +25,8 @@ recomputing the mask when each MET statistics tool is run. If the polyline
only contains a small number of points or the grid is sparse running
gen_vx_mask first would only save a second or two.

**Q. File-IO - How do I use map_data?**
Q. File-IO - How do I use map_data?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
The MET repository includes several map data files. Users can modify which
Expand Down Expand Up @@ -65,7 +67,8 @@ in the configuration string on the command line:
"${MET_BUILD_BASE}/data/map/admin_by_country/admin_China_data"; } \
]; }'
**Q. FILE-IO - How can I understand the number of matched pairs?**
Q. FILE-IO - How can I understand the number of matched pairs?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
Statistics are computed on matched forecast/observation pairs data.
Expand Down Expand Up @@ -114,7 +117,8 @@ none of the point observations match the variable name requested
in the configuration file. So all of the 1166 observations are rejected
for the same reason.

**Q. FILE-IO - What types of NetCDF files can MET read?**
Q. FILE-IO - What types of NetCDF files can MET read?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
There are three flavors of NetCDF that MET can read directly.
Expand All @@ -138,7 +142,8 @@ While MET's point2grid tool does support some satellite data inputs, it is
limited. Using python embedding is another option for handling new datasets
not supported natively by MET.

**Q. FILE-IO - How do I choose a time slice in a NetCDF file?**
Q. FILE-IO - How do I choose a time slice in a NetCDF file?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
When processing NetCDF files, the level information needs to be
Expand All @@ -158,7 +163,8 @@ Let's use plot_data_plane as an example:
Assuming that the first array is the time, this will select the 6-th
time slice of the APCP data and plot it since these indices are 0-based.

**Q. FILE-IO - How do I use the UNIX time conversion?**
Q. FILE-IO - How do I use the UNIX time conversion?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
Regarding the timing information in the NetCDF variable attributes:
Expand Down Expand Up @@ -196,7 +202,8 @@ subset the TRMM data if needed. Look for the section of it titled
"Output domain specification" and define the lat/lon's that needs
to be included in the output.

**Q. Does MET use a fixed-width output format for its ASCII output files?**
Q. Does MET use a fixed-width output format for its ASCII output files?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
MET does not use the Fortran-like fixed width format in its
Expand All @@ -219,7 +226,8 @@ If a fixed-width format is needed, the easiest option would be
writing a script to post-process the MET output into the fixed-width
format that is needed or that the code expects.

**Q. Do the ASCII output files created by MET use scientific notation?**
Q. Do the ASCII output files created by MET use scientific notation?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
By default, the ASCII output files created by MET make use of
Expand All @@ -236,10 +244,9 @@ is planned for a future release.
Gen-Vx-Mask
-----------

**Q. Gen-Vx-Mask - I have a list of stations to use for verification.
I also have a poly region defined. If I specify both of these should
the result be a union of them?**

Q. Gen-Vx-Mask - I have a list of stations to use for verification. I also have a poly region defined. If I specify both of these should the result be a union of them?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
These settings are defined in the "mask" section of the Point-Stat
configuration file. You can define masking regions in one of 3 ways,
Expand Down Expand Up @@ -267,7 +274,8 @@ If so, your options are:

Then aggregate the results together by running a Stat-Analysis job.

**Q. Gen-Vx-Mask - How do I define a masking region with a GFS file?**
Q. Gen-Vx-Mask - How do I define a masking region with a GFS file?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
Grab a sample GFS file:
Expand Down Expand Up @@ -304,7 +312,8 @@ to define that mask for Poland.
Grid-Stat
---------

**Q. Grid-Stat - How do I define a complex masking region?**
Q. Grid-Stat - How do I define a complex masking region?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
A user can define intersections and unions of multiple fields to define masks.
Expand Down Expand Up @@ -360,8 +369,8 @@ apply complex masking logic and then pass the output mask file
to Grid-Stat in its configuration file.


**Q. Grid-Stat - How do I use neighborhood methods to compute fraction
skill score?**
Q. Grid-Stat - How do I use neighborhood methods to compute fraction skill score?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
A common application of fraction skill score (FSS) is comparing forecast
Expand Down Expand Up @@ -401,8 +410,8 @@ Setting vld_thresh = 1.0 will ensure that FSS will only be computed at
points where all NxN values contain valid data. Setting it to 0.5 only
requires half of them.

**Q. Grid-Stat - Is an example of verifying forecast probabilities?**

Q. Grid-Stat - Is an example of verifying forecast probabilities?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A.
There is an example of verifying probabilities in the test scripts
included with the MET release. Take a look in:
Expand Down Expand Up @@ -444,8 +453,8 @@ values between 0 and 1. Note that if the probability data contains
values from 0 to 100, MET automatically divides by 100 to rescale to
the 0 to 1 range.

**Q. What is an example of using Grid-Stat with regridding and masking
turned on?**
Q. What is an example of using Grid-Stat with regridding and masking turned on?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
Run Grid-Stat using the following commands and the attached config file
Expand Down Expand Up @@ -504,9 +513,9 @@ gen_vx_mask tool and pass the NetCDF output of that tool to grid_stat.
The advantage to gen_vx_mask is that it will make grid_stat run a
bit faster. It can be used to construct much more complex masking areas.

**Q. How do I use one mask for the forecast field and a different
mask for the observation field??**

Q. How do I use one mask for the forecast field and a different mask for the observation field?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A.
You can't define different
masks for the forecast and observation fields in MET tools. MET only lets you
Expand Down Expand Up @@ -580,7 +589,8 @@ where gen_vx_mask has masked out the grid point.
Pcp-Combine
-----------

**Q. Pcp-Combine - How do I add and subtract with Pcp-Combine?**
Q. Pcp-Combine - How do I add and subtract with Pcp-Combine?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
An example of running the MET pcp_combine tool to put NAM 3-hourly
Expand Down Expand Up @@ -617,9 +627,8 @@ same file format, and can use the same configuration file settings for
the other MET tools (grid_stat, mode, etc.). If the NAM files are a mix
of GRIB and NetCDF, the logic would need to be a bit more complicated.

**Q. Pcp-Combine - How do I combine 12-hour accumulated precipitation
from two different initialization times?**

Q. Pcp-Combine - How do I combine 12-hour accumulated precipitation from two different initialization times?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A.
The "-sum" command assumes the same initialization time. Use the "-add"
option instead.
Expand Down Expand Up @@ -659,7 +668,8 @@ Here are 3 commands you could use to plot these data files:
plot_data_plane sum.nc sum.ps 'name="APCP_24"; level="(*,*)";'
**Q. Pcp-Combine - How do I correct a precipitation time range?**
Q. Pcp-Combine - How do I correct a precipitation time range?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A.
Typically, accumulated precipitation is stored in GRIB files using an
Expand Down Expand Up @@ -708,9 +718,8 @@ Here is an example:
The resulting file should have the accumulation listed at 24h rather than 0-24.

**Pcp-Combine - How do I use Pcp-Combine as a pass-through to simply reformat
from GRIB to NetCDF or to change output variable name?**

Q. Pcp-Combine - How do I use Pcp-Combine as a pass-through to simply reformat from GRIB to NetCDF or to change output variable name?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A.
The pcp_combine tool is typically used to modify the accumulation interval
of precipitation amounts in model and/or analysis datasets. For example,
Expand Down Expand Up @@ -746,8 +755,8 @@ appear in the output of downstream tools:
'name="REFC"; level="L0"; GRIB1_ptv=129; lead_time="120000";' \
forecast.nc -name CompositeReflectivity
**Q. Pcp-Combine - How do I use “-pcprx" to run a project faster?**

Q. Pcp-Combine - How do I use “-pcprx" to run a project faster?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A.
To run a project faster, the “-pcprx” option may be used to narrow the
search down to whatever regular expression you provide. Here are a two
Expand All @@ -766,8 +775,8 @@ examples:
-pcpdir /scratch4/BMC/shout/ptmp/Andrew.Kren/pre2016c3_corr/temp \
-pcprx 'pgbq[0-9][0-9].gfs.2016022118' -v 3
**Q. Pcp-Combine - How do I enter the time format correctly?**

Q. Pcp-Combine - How do I enter the time format correctly?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A.
Here is an **incorrect example** of running pcp_combine with sub-hourly
accumulation intervals:
Expand Down

0 comments on commit 2a077af

Please sign in to comment.