853 lines
29 KiB
HTML
853 lines
29 KiB
HTML
|
<html>
|
||
|
|
<title>GFESuite Documentation - Smart Tools</title>
|
||
|
|
<body>
|
||
|
|
<h1 align=center>Smart Tools Appendix: Point-based Tools</h1>
|
||
|
|
|
||
|
|
<p> <a href="#PB-Arguments">Point-based
|
||
|
|
Arguments</a>
|
||
|
|
<br>
|
||
|
|
<a href="#PB-Reserved">Reserved Methods</a>
|
||
|
|
<br>
|
||
|
|
<a href="#PPEx1">Exercise Point-based-1 --
|
||
|
|
Creating a Tool</a>
|
||
|
|
<br>
|
||
|
|
<a href="#PPEx2">Exercise Point-based-2 --
|
||
|
|
Modifying a Tool</a>
|
||
|
|
<br>
|
||
|
|
<a href="#PPEx3">Exercise Point-based-3 --
|
||
|
|
Using VariableLists</a>
|
||
|
|
<br>
|
||
|
|
<a href="#Wx">Working With Point-based Weather</a>
|
||
|
|
<br>
|
||
|
|
<a href="#PP-SS1">Exercise Point-based
|
||
|
|
SmartScript-1
|
||
|
|
-- Accessing Grids Directly</a>
|
||
|
|
<br>
|
||
|
|
<a href="#PP-SS2">Exercise Point-based
|
||
|
|
SmartScript-2
|
||
|
|
-- Accessing Variable Grids Directly</a>
|
||
|
|
<br>
|
||
|
|
<a href="#PP-SS3">Exercise Point-based
|
||
|
|
SmartScript-3
|
||
|
|
-- Making and Accessing Soundings</a>
|
||
|
|
<br>
|
||
|
|
<a href="#PB-Answers">Answers to Point-based
|
||
|
|
Exercises</a>
|
||
|
|
<br>
|
||
|
|
</p>
|
||
|
|
<hr width="100%">
|
||
|
|
|
||
|
|
<div class="3Heading">
|
||
|
|
<h1><a name="Point-based"></a>Appendix -- Point-based Tools</h1>
|
||
|
|
Prior to the introduction of Numeric Python, Smart Tools were
|
||
|
|
Point-based
|
||
|
|
i.e. the "execute" method of the tool was called for each point of the
|
||
|
|
grid. Point-based tools are much slower than their Numeric
|
||
|
|
counterparts.
|
||
|
|
However, for backward compatibility, Point-based tools are still
|
||
|
|
supported.
|
||
|
|
In some cases, they are easier to write since if-then-else logic
|
||
|
|
can be used for assigning values instead of "where" statements.
|
||
|
|
This
|
||
|
|
section discusses the differences between Point-based and Numeric Smart
|
||
|
|
Tools and contains exercises to illustrate how to write Point-based
|
||
|
|
tools.
|
||
|
|
<h2><a name="PB-Arguments"></a>Point-based Arguments</h2>
|
||
|
|
The arguments to point-based tools differ slightly from those to
|
||
|
|
numeric
|
||
|
|
tools. The differences are listed below:
|
||
|
|
<ul>
|
||
|
|
<li class="Bulleted"><weName> -- the value for one point of the
|
||
|
|
given weather
|
||
|
|
element.
|
||
|
|
Weather element values are as follows:</li>
|
||
|
|
<br>
|
||
|
|
<ul>
|
||
|
|
<li>Scalar value: floating point value,</li>
|
||
|
|
<li>Vector value: two-tuple of magnitude and direction, for example:</li>
|
||
|
|
<br>
|
||
|
|
mag = Wind[0] <br>
|
||
|
|
dir = Wind[1] <li>Weather value: text string indicating
|
||
|
|
weather
|
||
|
|
Coverage:Type:Intensity:Visibility:Attributes.
|
||
|
|
See the <a href="#Wx">"Working With Point-based Weather"</a> section
|
||
|
|
for
|
||
|
|
more information.</li>
|
||
|
|
</ul>
|
||
|
|
</ul>
|
||
|
|
<ul>
|
||
|
|
<li class="Bulleted">Topo -- this will give you the topography
|
||
|
|
information i.e. the
|
||
|
|
elevation
|
||
|
|
at each point.</li>
|
||
|
|
<li class="Bulleted">variableElement-- the grid point value for the
|
||
|
|
editable weather element
|
||
|
|
in the GFE.</li>
|
||
|
|
<li class="Bulleted"><weName>_Grid -- the entire Grid for the
|
||
|
|
given element. weName
|
||
|
|
can be
|
||
|
|
"variableElement", "Topo", or a weather element name. A time-weighted
|
||
|
|
average
|
||
|
|
of grid values is given. To access grid values, use x and y coordinates
|
||
|
|
(see below) as follows:</li>
|
||
|
|
<br>
|
||
|
|
value = T_Grid[x][y] <li class="Bulleted">x -- the
|
||
|
|
x coordinate for the grid point being
|
||
|
|
changed</li>
|
||
|
|
<li class="Bulleted">y -- the y coordinate for the grid point being
|
||
|
|
changed</li>
|
||
|
|
<li class="Bulleted">lat -- the latitude for the x,y coordinates for
|
||
|
|
the grid point being
|
||
|
|
changed</li>
|
||
|
|
<li class="Bulleted">lon -- the longitude for the x,y coordinates for
|
||
|
|
the grid point being
|
||
|
|
changed</li>
|
||
|
|
<li class="Bulleted"><weName>_MaxGrid -- a grid of maximum
|
||
|
|
values for the element over
|
||
|
|
the
|
||
|
|
GridTimeRange</li>
|
||
|
|
<li class="Bulleted"><weName>_MinGrid -- a grid of minimum
|
||
|
|
values for the elementover
|
||
|
|
the
|
||
|
|
GridTimeRange</li>
|
||
|
|
<li class="Bulleted"><weName>_SumGrid -- a grid of the sum of
|
||
|
|
values for the element
|
||
|
|
over
|
||
|
|
the GridTimeRange</li>
|
||
|
|
<li class="Bulleted">GridHistory is not available for point-based
|
||
|
|
tools.</li>
|
||
|
|
</ul>
|
||
|
|
<h2>
|
||
|
|
<a name="PB-Reserved"></a>Reserved Methods</h2>
|
||
|
|
Some methods have reserved names and meanings. To understand the
|
||
|
|
framework,
|
||
|
|
recall that a Point-based Smart Tool may operate over a time range
|
||
|
|
which
|
||
|
|
may include multiple grids. The mandatory "execute" method is called
|
||
|
|
for
|
||
|
|
each grid to be modified. Sometimes, you may wish to set up information
|
||
|
|
before or after this point-by-point processing occurs. If so, you may
|
||
|
|
use
|
||
|
|
the following methods:
|
||
|
|
<ul>
|
||
|
|
<li>preProcessTool: Called once at beginning of the Tool,
|
||
|
|
before
|
||
|
|
any grids are processed.</li>
|
||
|
|
<li>postProcessTool: Called once at end of the Tool,
|
||
|
|
after all
|
||
|
|
grids are processed.</li>
|
||
|
|
<li>preProcessGrid: Called once at the beginning of each
|
||
|
|
Grid.</li>
|
||
|
|
<li>postProcessGrid: Called once at the end of each Grid.</li>
|
||
|
|
</ul>
|
||
|
|
Of course, these methods will be called only if you supply them in your
|
||
|
|
tool. They are included as comments in the Smart Tool template that
|
||
|
|
appears
|
||
|
|
when you create a new tool and are documented there. The possible
|
||
|
|
arguments
|
||
|
|
to these methods will vary according to the logic of when they are
|
||
|
|
called.
|
||
|
|
<h3 class="3Heading"><a name="PPEx1"></a>Exercise Point-based-1 --
|
||
|
|
Creating a new tool</h3>
|
||
|
|
<div class="Body">Create a Smart Tool to yield a SnowAmt equal to the
|
||
|
|
current
|
||
|
|
QPF value multiplied by 10.</div>
|
||
|
|
<div class="Step-First">
|
||
|
|
<ol>
|
||
|
|
<li>Select GFE -> Define SmartTools. The Localization perspective will open
|
||
|
|
with the SmartTools folder selected. Select MB3 and click New.
|
||
|
|
The
|
||
|
|
New
|
||
|
|
Tool Dialog appears into which you will enter:</li>
|
||
|
|
</ol>
|
||
|
|
<ul>
|
||
|
|
<li class="Bullet-List">Name of the Tool: The Name of the Tool cannot
|
||
|
|
have spaces or special
|
||
|
|
characters
|
||
|
|
except an underline. Enter the name: SnowAmt_LearningTool.</li>
|
||
|
|
<li class="Bullet-List">The Weather Element it modifies. Select
|
||
|
|
SnowAmt.</li>
|
||
|
|
</ul>
|
||
|
|
<div class="Step">
|
||
|
|
<ol start="2">
|
||
|
|
<li>Press OK and a Python Editor will appear with a template Python
|
||
|
|
module
|
||
|
|
for your Tool.</li>
|
||
|
|
</ol>
|
||
|
|
<ul>
|
||
|
|
<li class="Bullet-List">There are lines to specify that this is a
|
||
|
|
"numeric" type tool and to
|
||
|
|
import
|
||
|
|
the Numeric library.</li>
|
||
|
|
<li class="Bullet-List">Another line specifies the
|
||
|
|
WeatherElementEdited. This may be changed if
|
||
|
|
you ever wish to modify the element edited by the tool.</li>
|
||
|
|
<li class="Bullet-List">Notice that the Python module has a class
|
||
|
|
named "Tool" and several
|
||
|
|
methods.
|
||
|
|
The "execute" method is mandatory and the one with which we will be
|
||
|
|
concerned.
|
||
|
|
The "execute" method may have weather element arguments plus various
|
||
|
|
special
|
||
|
|
arguments which will be supplied by the system when it is called.</li>
|
||
|
|
<li class="Bullet-List">You will notice a funny argument, "self".
|
||
|
|
This refers to this Tool
|
||
|
|
class
|
||
|
|
instance. You don't need to understand much about this now. All you
|
||
|
|
need
|
||
|
|
to do is make sure you leave it as the first argument to your "execute"
|
||
|
|
method.</li>
|
||
|
|
<li class="Bullet-List">If desired, a VariableList can define
|
||
|
|
run-time variables that will be
|
||
|
|
solicited
|
||
|
|
from the user when the Tool is executed. These variables will be passed
|
||
|
|
to the method.</li>
|
||
|
|
<li class="Bullet-List">We'll explore the various arguments and
|
||
|
|
VariableList later, but for
|
||
|
|
this
|
||
|
|
tool, you need only one argument (in addition to "self"): QPF.</li>
|
||
|
|
</ul>
|
||
|
|
<div class="Step">
|
||
|
|
<ol start="3">
|
||
|
|
<li>Remove the sample arguments from the "execute" definition, leave
|
||
|
|
the
|
||
|
|
"self"
|
||
|
|
argument, and enter the argument, QPF in the parentheses. When
|
||
|
|
the
|
||
|
|
tool executes, this argument will contain a Numeric Array representing
|
||
|
|
the Fcst QPF grid.</li>
|
||
|
|
<li class="Step">Type in a description of your tool below the
|
||
|
|
"execute" definition. This
|
||
|
|
description will appear when you click Button-3 --> Info over your
|
||
|
|
new
|
||
|
|
tool.</li>
|
||
|
|
<li class="Step">Insert a line to multiply the QPF values by 10:</li>
|
||
|
|
<div class="Step"> SnowAmt = QPF * 10</div>
|
||
|
|
<div class="Step">This line produces a Numeric Array named "SnowAmt"
|
||
|
|
which
|
||
|
|
has values 10 times the corresponding QPF values.</div>
|
||
|
|
<li class="Step">Save the Python module. Select File-->Save.</li>
|
||
|
|
<li class="Step">Execute the new tool to see that it works. If you
|
||
|
|
encounter errors when
|
||
|
|
executing your tool, a Dialog will appear to help you locate the
|
||
|
|
problem.
|
||
|
|
After successfully executing the tool, the QPF grid appears. Examine
|
||
|
|
the
|
||
|
|
data by sampling the QPF values and the SnowAmt values. If your
|
||
|
|
results
|
||
|
|
seem confusing, check to see</li>
|
||
|
|
<li class="Step">Close the Python Editor. Select File-->Close.</li>
|
||
|
|
</ol>
|
||
|
|
<div class="3Heading"> <a href="#PBAnswer1">Click
|
||
|
|
here for Answer to Exercise Point-based-1</a></div>
|
||
|
|
<h3 class="3Heading">
|
||
|
|
<a name="PPEx2"></a>Exercise Point-based-2 -- Modifying a Tool</h3>
|
||
|
|
<div class="Body">Modify your SnowAmt_LearningTool to base its new
|
||
|
|
value
|
||
|
|
based on temperature values. Use the following table:</div>
|
||
|
|
<table border="1">
|
||
|
|
<caption>
|
||
|
|
<h3 class="TableTitle"></h3>
|
||
|
|
</caption> <tbody>
|
||
|
|
<tr>
|
||
|
|
<th>
|
||
|
|
<div class="CellHeading">T</div>
|
||
|
|
</th>
|
||
|
|
<th>
|
||
|
|
<div class="CellHeading">Multiply QPF by</div>
|
||
|
|
</th>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>
|
||
|
|
<div class="CellBody">< 20</div>
|
||
|
|
</td>
|
||
|
|
<td>
|
||
|
|
<div class="CellBody">18</div>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>
|
||
|
|
<div class="CellBody">between 20 and 25</div>
|
||
|
|
</td>
|
||
|
|
<td>
|
||
|
|
<div class="CellBody">14</div>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>
|
||
|
|
<div class="CellBody">over 25</div>
|
||
|
|
</td>
|
||
|
|
<td>
|
||
|
|
<div class="CellBody">10</div>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
<div class="Step-First">
|
||
|
|
<ol>
|
||
|
|
<li>Select Modify... on the Button-3 popup over the
|
||
|
|
SnowAmt_LearningTool. A
|
||
|
|
dialog appears and you can change the Weather Element on which it
|
||
|
|
operates.
|
||
|
|
You are not allowed to change the name of the tool. Do not change
|
||
|
|
anything
|
||
|
|
for this example.</li>
|
||
|
|
<li>Select OK. This opens the Python Editor in which you can make
|
||
|
|
changes.
|
||
|
|
You will need the corresponding T grid, so add this as an argument to
|
||
|
|
your
|
||
|
|
method. Modify the Python code with if-elif-else statements to implement
|
||
|
|
the Temperature-based table.</li>
|
||
|
|
<li>Save the file. You can try your Tool without closing the editor
|
||
|
|
or
|
||
|
|
restarting
|
||
|
|
the GFE. The changes are effective as soon as you Save. Verify that the
|
||
|
|
tool worked by Sampling the SnowAmt and QPF grid values.</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<div class="3Heading"><a href="#PBAnswer2">Click here for Answer
|
||
|
|
to Exercise Point-based-2.</a></div>
|
||
|
|
<h3 class="3Heading">
|
||
|
|
<a name="PPEx3"></a>Exercise Point-based-3 -- Using VariableLists</h3>
|
||
|
|
<div class="Body">Modify your SnowAmt_LearningTool to adjust the QPF
|
||
|
|
only
|
||
|
|
in areas above a user-given elevation. To perform this exercise, we
|
||
|
|
will
|
||
|
|
need to define a variable for the user to input at execution time.
|
||
|
|
Remember
|
||
|
|
to include "varDict" in your argument list to get the value for the
|
||
|
|
user's
|
||
|
|
variable. You will also need to access the variable, Topo.</div>
|
||
|
|
<div class="Code"><a href="#PBAnswer3">Click here for Answer to
|
||
|
|
Exercise
|
||
|
|
Point-based-3.</a>
|
||
|
|
<br>
|
||
|
|
<h3 class="3Heading"><a name="Wx"></a>Working with Point-based Weather</h3>
|
||
|
|
<div class="Body">The Wx parameter is passed to Tools in a string
|
||
|
|
format
|
||
|
|
affectionately called the "ugly string." We will examine examples of
|
||
|
|
ugly
|
||
|
|
strings and how to manipulate them. The WxMethods utility provides some
|
||
|
|
"prettier", more convenient methods for working with Weather strings.
|
||
|
|
Using
|
||
|
|
these methods will make your tool run slower than one that works
|
||
|
|
directly
|
||
|
|
with the "ugly" string. However, you may want to develop your tool
|
||
|
|
using
|
||
|
|
the WxMethods and revert to "ugly" string manipulation after your
|
||
|
|
algorithm
|
||
|
|
is established if you find the performance to be unacceptable. As
|
||
|
|
processing
|
||
|
|
speed improves, this may become less of an issue. There are many
|
||
|
|
examples
|
||
|
|
of Wx-based Smart Tools in the examples/smartTools directory.</div>
|
||
|
|
<h4>
|
||
|
|
"Ugly" Weather Strings</h4>
|
||
|
|
<div class="Body">The "ugly string" format is:</div>
|
||
|
|
<ul>
|
||
|
|
<div class="Indented">Coverage:Type:Intensity:Visibility:Attributes</div>
|
||
|
|
</ul>
|
||
|
|
<div class="Body">Examples:</div>
|
||
|
|
<ul>
|
||
|
|
<div class="Indented">Iso:RW:-:<NoVis>:</div>
|
||
|
|
<div class="Indented">Wide:T:+:1SM:DmgW,HvyRain</div>
|
||
|
|
<div class="Indented"> </div>
|
||
|
|
</ul>
|
||
|
|
<div class="Body">Weather strings can be concatenated with the ^.</div>
|
||
|
|
<ul>
|
||
|
|
<div class="Indented">Iso:RW:--:<NoVis>:^Iso:T:--:<NoVis>:</div>
|
||
|
|
</ul>
|
||
|
|
<div class="Body">To create a Wx string simply assign a variable to the
|
||
|
|
string value. For example:</div>
|
||
|
|
<ul>
|
||
|
|
<div class="Indented">Wx =
|
||
|
|
"Iso:RW:--:<NoVis>:^Iso:T:--:<NoVis>:"</div>
|
||
|
|
<div class="Indented">Wx = "Wide:S:+:<NoVis>:"</div>
|
||
|
|
<div class="Indented"> </div>
|
||
|
|
</ul>
|
||
|
|
To examine the Wx string, you may use Python "string" commands. Here's
|
||
|
|
an example in which we are looking for a particular pattern:
|
||
|
|
<p> import string
|
||
|
|
<br>
|
||
|
|
import SmartScript
|
||
|
|
</p>
|
||
|
|
<p> class Tool
|
||
|
|
(SmartScript.SmartScript):
|
||
|
|
<br>
|
||
|
|
|
||
|
|
def __init__(self, dbss):
|
||
|
|
<br>
|
||
|
|
|
||
|
|
SmartScript.SmartScript.__init__(self, dbss)
|
||
|
|
<br>
|
||
|
|
|
||
|
|
def execute(self, Wx, varDict):
|
||
|
|
<br>
|
||
|
|
|
||
|
|
"Tool to calculate LAL from Wx"
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
if string.find(Wx, "Iso:T")>=0:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
LAL = 2
|
||
|
|
<br>
|
||
|
|
|
||
|
|
elif string.find(Wx, "Sct:T")>=0:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
LAL = 3
|
||
|
|
<br>
|
||
|
|
|
||
|
|
elif string.find(Wx, "Num:T")>=0:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
LAL = 4
|
||
|
|
<br>
|
||
|
|
|
||
|
|
elif string.find(Wx, "Wide:T")>=0:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
LAL = 5
|
||
|
|
<br>
|
||
|
|
|
||
|
|
else
|
||
|
|
<br>
|
||
|
|
|
||
|
|
LAL = 1
|
||
|
|
<br>
|
||
|
|
|
||
|
|
return LAL
|
||
|
|
<br>
|
||
|
|
</p>
|
||
|
|
<div class="Body">To look for a particular Coverage or Type in a Wx
|
||
|
|
string
|
||
|
|
you could use the string command as follows:
|
||
|
|
<p>
|
||
|
|
if string.find(Wx, ":R:")>=0:
|
||
|
|
</p>
|
||
|
|
<p>Note that we need to include the colons so that the test
|
||
|
|
distinguishes
|
||
|
|
between "R" and "RW". A similar confusion can arise when looking for
|
||
|
|
Coverages
|
||
|
|
such as "Sct" and "WSct" or "Chc" and "SChc". If you are looking for a
|
||
|
|
particular Coverage, you may want to use the simple (and fast)
|
||
|
|
WxMethod,
|
||
|
|
WxParts, to separate the string into a list of parts and then test for
|
||
|
|
inclusion. At the beginning of your tool, be sure to "import" the
|
||
|
|
WxMethods
|
||
|
|
utility as shown:
|
||
|
|
</p>
|
||
|
|
<p> from WxMethods import *
|
||
|
|
<br>
|
||
|
|
import SmartScript
|
||
|
|
</p>
|
||
|
|
<p> class Tool
|
||
|
|
(SmartScript.SmartScript):
|
||
|
|
<br>
|
||
|
|
|
||
|
|
def __init__(self, dbss):
|
||
|
|
<br>
|
||
|
|
|
||
|
|
SmartScript.SmartScript.__init__(self, dbss)
|
||
|
|
<br>
|
||
|
|
|
||
|
|
def execute(self, Wx, varDict):
|
||
|
|
<br>
|
||
|
|
|
||
|
|
"Tool to calculate PoP from Wx"
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
parts = WxParts(Wx)
|
||
|
|
<br>
|
||
|
|
|
||
|
|
if "Def" in parts:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
PoP = 100
|
||
|
|
<br>
|
||
|
|
|
||
|
|
elif "Wide" in parts:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
PoP = 90
|
||
|
|
<br>
|
||
|
|
|
||
|
|
elif "Ocnl" in parts:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
PoP = 80
|
||
|
|
<br>
|
||
|
|
|
||
|
|
elif "Lkly" in parts:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
PoP = 70
|
||
|
|
<br>
|
||
|
|
|
||
|
|
elif "Chc" in parts:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
PoP = 40
|
||
|
|
<br>
|
||
|
|
|
||
|
|
elif "SChc" in parts:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
PoP = 20
|
||
|
|
<br>
|
||
|
|
|
||
|
|
elif "Iso" in parts:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
PoP = 10
|
||
|
|
<br>
|
||
|
|
|
||
|
|
return PoP
|
||
|
|
</p>
|
||
|
|
<h4>"Prettier" Weather Methods</h4>
|
||
|
|
<div class="Body">Let's look at other WxMethods available and how they
|
||
|
|
are used.</div>
|
||
|
|
<div class="Step-First">
|
||
|
|
<ol>
|
||
|
|
<li>In Localization Perspective, drill down to the SITE or USER level of the PoP_SmartTool
|
||
|
|
and select Button-3-->Open over the PoP_SmartTool.</li>
|
||
|
|
<li>Examine the code to see the WxContains method in use.</li>
|
||
|
|
<li>In the EditAction Dialog, Select Windows --> Windows -->
|
||
|
|
Utilities.
|
||
|
|
Select Button-3-->Modify over WxMethods.</li>
|
||
|
|
<li>Look at the documentation for the WxContains method.</li>
|
||
|
|
<li>In Localization Perspective, drill down to the SITE or USER level of the Wx_SmartTool
|
||
|
|
and select Button-3-->Open over the Wx_SmartTool.py and examine
|
||
|
|
the code to see the WxString method in use.</li>
|
||
|
|
<li>Look at the documentation for the WxString method in WxMethods.</li>
|
||
|
|
<li>Finally, read the documentation for the WxModify.</li>
|
||
|
|
<li>Close the Python Editor windows.</li>
|
||
|
|
</ol>
|
||
|
|
<h2>
|
||
|
|
<a name="PP-SS1"></a>Exercise Point-based SmartScript-1 -- Accessing
|
||
|
|
Grids
|
||
|
|
Directly</h2>
|
||
|
|
In this exercise, we will access grid values directly from the Smart
|
||
|
|
Tool
|
||
|
|
instead of from the argument list.
|
||
|
|
<ol>
|
||
|
|
<li>In Localization Perspective, select
|
||
|
|
Utilities.
|
||
|
|
Drill down to BASE level and select MB-3-->Open over SmartScript.</li>
|
||
|
|
<li>Find the method, "getValue" and read the documentation.</li>
|
||
|
|
<li>Return to the Smart Tools Window and create a new smart tool
|
||
|
|
which
|
||
|
|
edits
|
||
|
|
QPF. Access both the current QPF value and the most
|
||
|
|
recent
|
||
|
|
D2D NAM12 tp (total precipitation) value directly using the "getValue"
|
||
|
|
method.
|
||
|
|
If the current QPF value is zero, assign the tp value to it. Otherwise,
|
||
|
|
return it as is.</li>
|
||
|
|
<li>Run and test your tool to make sure it works.</li>
|
||
|
|
</ol>
|
||
|
|
<a href="#PB-SSAnswer1">Click here for Answer to Exercise Point-based
|
||
|
|
SmartScript-1.</a>
|
||
|
|
<h2><a name="PP-SS2"></a>Exercise Point-based SmartScript-2 --
|
||
|
|
Accessing Variable
|
||
|
|
Grids Directly</h2>
|
||
|
|
Often, you will want to choose the model you want to work with at
|
||
|
|
run-time.
|
||
|
|
You can use a variable list to get the model and then access the grids
|
||
|
|
directly.
|
||
|
|
<ol>
|
||
|
|
<li>Modify your tool from Exercise SmartScript-1 to have a variable
|
||
|
|
D2D
|
||
|
|
model
|
||
|
|
from which to get the "tp" value.</li>
|
||
|
|
<li>Run and test your tool to make sure it works.</li>
|
||
|
|
</ol>
|
||
|
|
<a href="#PB-SSAnswer2">Click here for Answer to Exercise Point-based
|
||
|
|
SmartScript-2.</a>
|
||
|
|
<h2>
|
||
|
|
<a name="PP-SS3"></a>Exercise Point-based SmartScript-3 -- Making and
|
||
|
|
Accessing
|
||
|
|
Soundings</h2>
|
||
|
|
The Smart Script class has the capability to create a sounding and get
|
||
|
|
a value from the sounding based on a given elevation. In this
|
||
|
|
exercise,
|
||
|
|
we will create a sounding from model data and Topo information to
|
||
|
|
determine the surface temperature.
|
||
|
|
<ol>
|
||
|
|
<li>In the SmartScript class, find the method,
|
||
|
|
"getSoundingValue".
|
||
|
|
Read
|
||
|
|
the documentation to learn how to call this method.</li>
|
||
|
|
<li>Find the Unit Conversion methods section and examine the methods
|
||
|
|
available.</li>
|
||
|
|
<li>Create a new smart tool which edits T. Allow the user
|
||
|
|
to
|
||
|
|
set
|
||
|
|
the D2D model using a VariableList. Get the value from a sounding
|
||
|
|
made from the D2D model grids using the Topo information. You
|
||
|
|
will
|
||
|
|
have to convert Topo from feet to meters and temperature from K to F.</li>
|
||
|
|
<li>Run and test your tool to make sure it works.</li>
|
||
|
|
</ol>
|
||
|
|
<a href="#PB-SSAnswer3">Click here for Answer to Exercise Point-based
|
||
|
|
SmartScript-3.</a>
|
||
|
|
<br>
|
||
|
|
<br>
|
||
|
|
<br>
|
||
|
|
<h1>
|
||
|
|
<a name="PB-Answers"></a>Answers to Point-based Exercises</h1>
|
||
|
|
<h2>
|
||
|
|
<a name="PBAnswer1"></a>Answer to Exercise Point-based-1</h2>
|
||
|
|
import SmartScript
|
||
|
|
<p>class Tool (SmartScript.SmartScript):
|
||
|
|
<br>
|
||
|
|
def __init__(self, dbss):
|
||
|
|
<br>
|
||
|
|
SmartScript.SmartScript.__init__(self,
|
||
|
|
dbss)
|
||
|
|
</p>
|
||
|
|
<p> def execute(self, QPF):
|
||
|
|
<br>
|
||
|
|
"Tool to return QPF
|
||
|
|
multiplied
|
||
|
|
by 10"
|
||
|
|
</p>
|
||
|
|
<p> # Determine new value
|
||
|
|
<br>
|
||
|
|
SnowAmt = QPF * 10
|
||
|
|
</p>
|
||
|
|
<p> # Return the new value
|
||
|
|
<br>
|
||
|
|
return SnowAmt
|
||
|
|
</p>
|
||
|
|
<h2><a name="PBAnswer2"></a>Answer to Exercise Point-based-2</h2>
|
||
|
|
import SmartScript
|
||
|
|
<p>class Tool (SmartScript.SmartScript):
|
||
|
|
<br>
|
||
|
|
def __init__(self, dbss):
|
||
|
|
<br>
|
||
|
|
SmartScript.SmartScript.__init__(self,
|
||
|
|
dbss)
|
||
|
|
</p>
|
||
|
|
<p> def execute(self, QPF, T):
|
||
|
|
<br>
|
||
|
|
"Tool to calculate SnowAmt"
|
||
|
|
</p>
|
||
|
|
<p> if T < 20:
|
||
|
|
<br>
|
||
|
|
SnowRatio
|
||
|
|
= 18
|
||
|
|
<br>
|
||
|
|
elif T < 25:
|
||
|
|
<br>
|
||
|
|
SnowRatio
|
||
|
|
= 14
|
||
|
|
<br>
|
||
|
|
else:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
SnowRatio = 10
|
||
|
|
<br>
|
||
|
|
# Determine new value
|
||
|
|
<br>
|
||
|
|
SnowAmt = QPF * SnowRatio
|
||
|
|
</p>
|
||
|
|
<p> # Return the new value
|
||
|
|
<br>
|
||
|
|
return SnowAmt
|
||
|
|
</p>
|
||
|
|
<h2><a name="PBAnswer3"></a>Answer to Exercise Point-based-3</h2>
|
||
|
|
import SmartScript
|
||
|
|
<p>class Tool (SmartScript.SmartScript):
|
||
|
|
<br>
|
||
|
|
def __init__(self, dbss):
|
||
|
|
<br>
|
||
|
|
SmartScript.SmartScript.__init__(self,
|
||
|
|
dbss)
|
||
|
|
</p>
|
||
|
|
<p> def execute(self, QPF, T, Topo, varDict):
|
||
|
|
<br>
|
||
|
|
"Tool to calculate SnowAmt"
|
||
|
|
</p>
|
||
|
|
<p> # Set up Variables from
|
||
|
|
the
|
||
|
|
varDict
|
||
|
|
<br>
|
||
|
|
elevation = varDict["Enter
|
||
|
|
elevation"]
|
||
|
|
</p>
|
||
|
|
<p> if T < 20:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
SnowRatio = 18
|
||
|
|
<br>
|
||
|
|
elif T < 25:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
SnowRatio = 14
|
||
|
|
<br>
|
||
|
|
else:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
SnowRatio = 10
|
||
|
|
</p>
|
||
|
|
<p> # Determine new value
|
||
|
|
<br>
|
||
|
|
if Topo > elevation:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
SnowAmt = SnowRatio * QPF
|
||
|
|
<br>
|
||
|
|
else:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
SnowAmt = 0
|
||
|
|
</p>
|
||
|
|
<p> # Return the new value
|
||
|
|
<br>
|
||
|
|
return
|
||
|
|
SnowAmt
|
||
|
|
</p>
|
||
|
|
<p>VariableList = [
|
||
|
|
<br>
|
||
|
|
("Enter elevation" , 5000,
|
||
|
|
"numeric"),
|
||
|
|
<br>
|
||
|
|
]
|
||
|
|
<br>
|
||
|
|
|
||
|
|
</p>
|
||
|
|
<h2><a name="PB-SSAnswer1"></a>Answer to Exercise Point-based
|
||
|
|
SmartScript-1</h2>
|
||
|
|
import SmartScript
|
||
|
|
<p>class Tool (SmartScript.SmartScript):
|
||
|
|
<br>
|
||
|
|
def __init__(self, dbss):
|
||
|
|
<br>
|
||
|
|
SmartScript.SmartScript.__init__(self,
|
||
|
|
dbss)
|
||
|
|
</p>
|
||
|
|
<p> def execute(self, x, y,
|
||
|
|
GridTimeRange):
|
||
|
|
<br>
|
||
|
|
"This
|
||
|
|
tool accesses QPF and tp grids directly"
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
# Get QPF and tp values
|
||
|
|
<br>
|
||
|
|
|
||
|
|
qpf = self.getValue("Fcst", "QPF", "SFC", x, y, GridTimeRange)
|
||
|
|
<br>
|
||
|
|
|
||
|
|
tp = self.getValue("BOU_D2D_NAM12", "tp","SFC", x, y, GridTimeRange)
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
if qpf == 0:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
return tp
|
||
|
|
<br>
|
||
|
|
|
||
|
|
else:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
return qpf
|
||
|
|
</p>
|
||
|
|
<h2><a name="PB-SSAnswer2"></a>Answer to Exercise Point-based
|
||
|
|
SmartScript-2</h2>
|
||
|
|
import SmartScript
|
||
|
|
<p>VariableList = [("Model:" , "", "D2D_model")]
|
||
|
|
<br>
|
||
|
|
class Tool (SmartScript.SmartScript):
|
||
|
|
<br>
|
||
|
|
def __init__(self, dbss):
|
||
|
|
<br>
|
||
|
|
SmartScript.SmartScript.__init__(self,
|
||
|
|
dbss)
|
||
|
|
</p>
|
||
|
|
<p> def execute(self, x, y,
|
||
|
|
GridTimeRange,
|
||
|
|
varDict):
|
||
|
|
<br>
|
||
|
|
"This
|
||
|
|
tool accesses QPF and tp grids directly"
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
model = varDict["Model:"]
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
# Get QPF and tp values
|
||
|
|
<br>
|
||
|
|
|
||
|
|
qpf = self.getValue("Fcst", "QPF", "SFC", x, y, GridTimeRange)
|
||
|
|
<br>
|
||
|
|
|
||
|
|
tp = self.getValue(model, "tp","SFC", x, y, GridTimeRange)
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
if qpf == 0:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
return tp
|
||
|
|
<br>
|
||
|
|
|
||
|
|
else:
|
||
|
|
<br>
|
||
|
|
|
||
|
|
return qpf
|
||
|
|
<br>
|
||
|
|
|
||
|
|
</p>
|
||
|
|
<h2><a name="PB-SSAnswer3"></a>Answer to Exercise Point-based
|
||
|
|
SmartScript-3</h2>
|
||
|
|
import SmartScript
|
||
|
|
<p>VariableList = [("Model:" , "", "D2D_model")]
|
||
|
|
</p>
|
||
|
|
<p>class Tool (SmartScript.SmartScript):
|
||
|
|
<br>
|
||
|
|
def __init__(self, dbss):
|
||
|
|
<br>
|
||
|
|
|
||
|
|
SmartScript.SmartScript.__init__(self,
|
||
|
|
dbss)
|
||
|
|
</p>
|
||
|
|
<p> def execute(self, Topo, x, y, GridTimeRange,
|
||
|
|
varDict):
|
||
|
|
<br>
|
||
|
|
"This tool initializes T
|
||
|
|
based on model temperature soundings"
|
||
|
|
<br>
|
||
|
|
model = varDict["Model:"]
|
||
|
|
</p>
|
||
|
|
<p> # Make a sounding for T
|
||
|
|
at
|
||
|
|
this point
|
||
|
|
<br>
|
||
|
|
# Height will increase in
|
||
|
|
the sounding
|
||
|
|
<br>
|
||
|
|
levels =
|
||
|
|
["MB1000","MB950","MB900","MB850","MB800",
|
||
|
|
<br>
|
||
|
|
|
||
|
|
"MB750","MB700","MB650","MB600"]
|
||
|
|
<br>
|
||
|
|
topo_M =
|
||
|
|
self.convertFtToM(Topo)
|
||
|
|
<br>
|
||
|
|
T_K =
|
||
|
|
self.getSoundingValue(model,
|
||
|
|
"t", levels, x, y, GridTimeRange, topo_M)
|
||
|
|
</p>
|
||
|
|
<p> T_F =
|
||
|
|
self.convertKtoF(T_K)
|
||
|
|
</p>
|
||
|
|
<p> # Return the new value
|
||
|
|
<br>
|
||
|
|
return T_F
|
||
|
|
<br>
|
||
|
|
<br>
|
||
|
|
</p>
|