837 lines
28 KiB
HTML
837 lines
28 KiB
HTML
<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type"
|
|
content="text/html; charset=iso-8859-1">
|
|
<meta name="GENERATOR"
|
|
content="Mozilla/4.79 [en] (X11; U; Linux 2.4.9-34smp i686) [Netscape]">
|
|
<title>GFESuite Documentation - ButtonBarDialogs</title>
|
|
</head>
|
|
<body bgcolor="#ffffff">
|
|
<h1 class="3Heading">
|
|
<a name="ButtonBarDialogs"></a>Button Bar Dialogs</h1>
|
|
The following dialogs are invoked directly or indirectly from the
|
|
Button
|
|
Bar:
|
|
<br>
|
|
<ul>
|
|
<li> <a href="#EditActionsDialog">Edit Actions Dialog</a></li>
|
|
<li> <a href="#PickUpValueDialog">PickUp Value Dialog</a></li>
|
|
<li> <a href="#DeltaValueDialog">Delta Value Dialog</a></li>
|
|
<li> <a href="#EditAreaQueryDialog">Edit Area and Query Dialog</a></li>
|
|
<li> <a href="#SaveEditAreaDialog">Save Edit Area Dialog</a></li>
|
|
<li> <a href="#DeleteEditAreaDialog">Delete Edit Area Dialog</a></li>
|
|
<li> <a href="#SaveEditAreaGroupDialog">Save Edit Area Group Dialog</a></li>
|
|
<li> <a href="#DeleteEditAreaGroupDialog">Delete Edit Area Group
|
|
Dialog</a></li>
|
|
</ul>
|
|
<br>
|
|
<hr width="100%">
|
|
<h1 class="3Heading"><a name="EditActionsDialog"></a>Edit Actions Dialog</h1>
|
|
The Edit Actions dialog is opened from the Button Bar.
|
|
It allows you to create, modify, and invoke a variety
|
|
of Spatial Editor Smart Tools. Please refer to the Smart Tool Training
|
|
Guide to understand the concepts of Smart Tools and for instruction on
|
|
modifying and creating your own.
|
|
<p><img src="images/DialogEditAction.jpg" nosave=""></p>
|
|
<p>The Edit Action Dialog description is divided into three sections:
|
|
</p>
|
|
<ul>
|
|
<li> <a href="#PullDownMenus">Pull-Down Menus</a></li>
|
|
<li> <a href="#ScrollWindow">Scroll Window</a></li>
|
|
<li> <a href="#ActionButtons">Action Buttons</a></li>
|
|
</ul>
|
|
<ul>
|
|
<br>
|
|
<hr width="100%">
|
|
<h3><a name="PullDownMenus"></a>Pull-Down Menus</h3>
|
|
One pull-down menu appears at the top of the Edit Actions Dialog:
|
|
<ul>
|
|
<li> <a href="#FileMenu">File Menu</a></li>
|
|
</ul>
|
|
<hr width="100%">
|
|
<h4 class="4Heading"><a name="FileMenu"></a>File Menu</h4>
|
|
<div class="4Heading">The File Menu opens a sub-menu with the
|
|
following
|
|
entries:</div>
|
|
<div class="Body">
|
|
<ul>
|
|
<br>
|
|
<li>Screen Smart Tools -- If on, only the smart
|
|
tools
|
|
that edit
|
|
the active weather element will be displayed in the Smart Tools window.</li>
|
|
<li>Close -- Closes the window.</li>
|
|
<br>
|
|
</ul>
|
|
<hr width="100%">
|
|
<h3><a name="ScrollWindow"></a>Scroll Window</h3>
|
|
The Smart Tools window is the default display of the Edit Actions
|
|
window.
|
|
The Smart Tools window allows you to select and activate Smart Tools by
|
|
pressing MB1 on the action. In general, to activate a Smart Tool,
|
|
follow
|
|
these steps:
|
|
<ol>
|
|
<li>Make a Weather Element editable</li>
|
|
<li>Set the Edit Area</li>
|
|
<li>MB1-click over the Tool name </li>
|
|
</ol>
|
|
<div class="Body">
|
|
<div class="Body">
|
|
<p></p>
|
|
<hr width="100%">
|
|
<h3><a name="ActionButtons"></a>Action Buttons</h3>
|
|
The following action buttons appear at the bottom of the Edit Actions
|
|
dialog:
|
|
<ul>
|
|
<li>Pickup Value -- Opens the <a
|
|
href="#PickUpValueDialog">Pickup
|
|
Value Dialog</a> which allows you to set the
|
|
value of the Assign Value Tool.</li> <li>Delta
|
|
Value -- Opens the <a
|
|
href="#DeltaValueDialog">Delta
|
|
Value Dialog</a> which allows you to set the
|
|
value of the AdjustValue_Up and AdjustValue_Down tools.
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</ul>
|
|
<br>
|
|
<hr width="100%">
|
|
<h1 class="3Heading"><a name="PickUpValueDialog"></a>Pickup Value Dialog</h1>
|
|
<a name="pgfId=176376"></a>The Pickup Value dialog is opened from the
|
|
Edit
|
|
Actions Dialog. It allows you to set the value that will be
|
|
used by Assign Value Tool for any loaded Weather Element. Optionally,
|
|
you
|
|
can choose to Assign the value you have chosen by clicking on the
|
|
"Assign"
|
|
button.
|
|
<p>The dialog displays a color scale, and the name of the Weather
|
|
Element
|
|
is shown at the top of the dialog. There are four different types
|
|
of dialogs: Scalar, Vector, Weather, and Discrete.
|
|
</p>
|
|
<h2><a name="ScalarPickUpValueDialog"></a>Scalar PickUp Value Dialog</h2>
|
|
There are two ways to set the current pickup value. MB1 click or drag
|
|
will
|
|
set the pickup value to whatever value you clicked. Or, if you
|
|
click
|
|
MB1 in the box labeled "Enter Value", you can enter a value using the
|
|
keyboard.
|
|
<p><img src="images/DialogPickUpValueScalar.jpg" nosave=""></p>
|
|
<p>The scaling can be changed by MB2 click over the scale. The
|
|
MB3
|
|
Pop-Up menu that allows you to modify the display of the color scale is currently
|
|
not available from the Pickup Value dialog.
|
|
Select one of the follow Pop-Up menu items to modify the scale display
|
|
accordingly.
|
|
</p>
|
|
<h2><a name="VectorPickUpValueDialog"></a>Vector PickUp Value Dialog</h2>
|
|
The vector pick up value dialog contains an entry field for direction
|
|
and
|
|
magnitude, selectors for the <a
|
|
href="GFEMainMenu.html#EditingPreferences">vector
|
|
edit mode</a>, and a graphical entry for direction and magnitude.
|
|
The direction and magnitude may be entered in the entry fields at any
|
|
time,
|
|
regardless of the vector edit mode. The vector edit mode affects the
|
|
way
|
|
the direction and magnitude are specified using the graphical entry
|
|
method
|
|
and the way some edit tools behave when editing vector data.
|
|
<p>The graphical entry contains a circle representing the current
|
|
magnitude,
|
|
a wind barb and arrow representing both magnitude and direction, and a
|
|
meter readout also representing both magnitude and direction.
|
|
</p>
|
|
<p>The user can choose to set the direction through the graphical entry
|
|
in either the "to" or the "from" direction by starting the operation in
|
|
the appropriate hemisphere. If you start the entry operation
|
|
within
|
|
90 degrees of either side of the arrow, then you are specifying the
|
|
"to"
|
|
direction. If you start the entry operation within 90 degrees of
|
|
either
|
|
side of the wind barb, then you are specifying the "from" direction.
|
|
</p>
|
|
<p>Clicking or dragging in the graphic entry will set the magnitude and
|
|
direction, if the <a href="GFEMainMenu.html#EditingPreferences">vector
|
|
edit mode</a> is set to Both. If the vector edit mode is set to
|
|
Magnitude
|
|
Only, then only the magnitude may be set. If the vector edit mode
|
|
is set to Direction Only, then only the direction may be set. The
|
|
direction is determined by the angle from the center of the
|
|
circle.
|
|
The magnitude is determined by the distance your cursor is from the
|
|
center
|
|
of the circle.
|
|
</p>
|
|
<p><img src="images/DialogPickUpValueVector.jpg" nosave=""><br>
|
|
</p>
|
|
<h2><a name="WeatherPickUpValueDialog"></a>Weather PickUp Value Dialog</h2>
|
|
The Weather PickUp Value dialog allows the user to define a new weather
|
|
pick-up value, and optionally perform an Assign Value of the new value
|
|
on the spatial editor. The table below explains each control of this dialog:
|
|
<br><br>
|
|
<table nosave="" border="1" width="100%">
|
|
<tbody>
|
|
<tr>
|
|
<td>Current Value</td>
|
|
<td>Shows the current weather value for the dialog. The weather key
|
|
is a composite of all of the weather type entry frames. Note that
|
|
certain coverages, probabilities, and intensities may be combined into
|
|
a more significant key. For example, if you have Sct RW- in one
|
|
entry frame and Sct RW + in another, the resulting value will be the more
|
|
significant event, which will be Sct RW +. Coverages and probabilities are
|
|
also combined in the same manner.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Reset to No Weather</td>
|
|
<td>Resets the entry fields back to No Weather.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Add New Weather Type Entry Frame</td>
|
|
<td>Adds a new weather type entry frame to allow the user to
|
|
specify an
|
|
additional weather type.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Toggle Replace/Combine Mode</td>
|
|
<td>If the Assign Value button is pressed, the current weather
|
|
key is assigned
|
|
to the active edit area. In replace mode, any existing data will
|
|
be replaced in the active edit area. In combine mode, the new
|
|
weather
|
|
will be combined with any existing weather.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Add to session</td>
|
|
<td>Adds the currently displayed value to the list of
|
|
user-defined session
|
|
values. This is useful to set up a sequence of pick up values
|
|
which
|
|
can later be accessed from the <a
|
|
href="Button3Popups.html#SpatialEditorColorBarPopupMenu">color
|
|
bar pull-down menu</a>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Edit Data</td>
|
|
<td>Runs the "Assign Value" tool on the active edit area.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Weather Type</td>
|
|
<td>The weather type field consists of No Weather, precipitation,
|
|
and obstructions
|
|
to vision. The weather type should always be chosen first.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Coverage/Probability</td>
|
|
<td>The coverage and probabilities option menu contents depends
|
|
upon the
|
|
weather type chosen. The <a
|
|
href="gfeConfig.html#WeatherSetValueDialogDefaultValues">default</a>
|
|
may be specified in the GFE configuration file for each weather
|
|
type.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Intensity</td>
|
|
<td>The intensity option menu contents depends upon the weather
|
|
type chosen.
|
|
Some weather types don't have a valid intensity and thus the
|
|
<NoInten>
|
|
must be chosen. The <a
|
|
href="gfeConfig.html#WeatherSetValueDialogDefaultValues">default</a>
|
|
may be specified in the GFE configuration file for each weather type.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Visibility</td>
|
|
<td>The visibility option menu is fixed for all weather
|
|
types. The
|
|
selection of <NoVis> indicates that no visibility has been
|
|
defined.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Optional Attributes</td>
|
|
<td>The list of optional attributes is weather type
|
|
dependent.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<br>
|
|
<p><img src="images/DialogPickUpValueWeather.jpg" nosave=""></p>
|
|
<p>The user may also control the <a
|
|
href="GFEMainMenu.html#EditingPreferences">Weather/Discrete
|
|
Combine Mode</a> by using the Combine pushbutton.
|
|
"Description" information about each entry is available through the <a
|
|
href="GFEMainMenu.html#WxDiscreteDescription">GFE -> Viewing
|
|
Preferences -> Wx/Discrete: Show Description</a> menu option.<br>
|
|
</p>
|
|
<h2><a name="DiscretePickUpValueDialog"></a>Discrete PickUp Value Dialog</h2>
|
|
The Discrete PickUp Value dialog allows the user to define a new
|
|
discrete
|
|
pick-up value, and optionally perform an Assign Value of the new value
|
|
on the spatial editor. The table below explains each control of
|
|
this
|
|
dialog:
|
|
<br>
|
|
<table nosave="" border="1" width="100%">
|
|
<tbody>
|
|
<tr>
|
|
<td>Current Value</td>
|
|
<td>Shows the current discrete value for the dialog. The
|
|
discrete
|
|
key is a composite of all of the discrete value frames. For
|
|
non-overlapping,
|
|
there is only 1 frame available.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Reset</td>
|
|
<td>Resets the entry fields back the default value (1st entry
|
|
defined in
|
|
the discrete key definition in serverConfig)</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Add New Entry Frame</td>
|
|
<td>Adds a new weather type entry frame to allow the user to
|
|
specify an
|
|
additional discrete type. This may not appear for all weather
|
|
elements since some weather elements are not defined to allow for
|
|
overlapping types.<br>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Toggle Replace/Combine Mode</td>
|
|
<td>If the Assign Value button is pressed, the current discrete
|
|
key is
|
|
assigned to the active edit area. In replace mode, any existing
|
|
data
|
|
will be replaced in the active edit area. In combine mode, the
|
|
new
|
|
discrete value will be combined with any existing discrete value.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Add to session</td>
|
|
<td>Adds the currently displayed value to the list of
|
|
user-defined session
|
|
values. This is useful to set up a sequence of pick up values
|
|
which
|
|
can later be accessed from the <a
|
|
href="Button3Popups.html#SpatialEditorColorBarPopupMenu">color
|
|
bar pull-down menu</a>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Edit Data</td>
|
|
<td>Runs the "Assign Value" tool on the active edit area.</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="vertical-align: top;">Base Type<br>
|
|
</td>
|
|
<td style="vertical-align: top;">This is the base type of the
|
|
discrete value.<br>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="vertical-align: top;">Aux Data<br>
|
|
</td>
|
|
<td style="vertical-align: top;">The aux data field is
|
|
optional. If enabled, only a certain width entry is
|
|
allowed. The purpose for the aux data is specific to the discrete
|
|
element.<br>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p><img alt="" src="images/DialogPickUpValueDiscrete.png" nosave="">
|
|
<br>
|
|
</p>
|
|
<p>The user may also control the <a
|
|
href="GFEMainMenu.html#EditingPreferences">Weather/Discrete
|
|
Combine Mode</a> by using the Combine pushbutton.
|
|
"Description" information about each entry is available through the <a
|
|
href="GFEMainMenu.html#WxDiscreteDescription">GFE
|
|
-> Viewing Preferences -> Wx/Discrete: Show Description</a> menu
|
|
option.<br>
|
|
<br>
|
|
</p>
|
|
<div class="Body">
|
|
<br>
|
|
<hr width="100%"></div>
|
|
</div>
|
|
<h1 class="3Heading">
|
|
<a name="DeltaValueDialog"></a>Delta Value Dialog</h1>
|
|
<a name="pgfId=176376"></a>The Delta Value Dialog is opened from the
|
|
Edit
|
|
Actions Dialog. It allows you to set the delta value of the
|
|
AdjustValue_Up
|
|
and AdjustValue_Down tools. Optionally, you can adjust the grid values
|
|
down or up by clicking on the "Adjust Down" or "Adjust Up" buttons.
|
|
<p>Type in the delta value and click OK or use the slider to set the
|
|
value.
|
|
</p>
|
|
<p>At any time you can click Cancel to cancel the operation and close
|
|
the
|
|
dialog.
|
|
</p>
|
|
<div class="Body">
|
|
<br>
|
|
<img src="images/DialogDelta.jpg" nosave="">
|
|
<div class="Body">
|
|
<hr width="100%"></div>
|
|
</div>
|
|
<div class="Body"></div>
|
|
</div>
|
|
<h1 class="3Heading">
|
|
<a name="EditAreaQueryDialog"></a>Edit Area and Query Dialog</h1>
|
|
Opens a dialog that allows you to load previously defined edit areas,
|
|
and
|
|
construct query expressions that create edit areas. One way to
|
|
define
|
|
an edit area is by defining a query. A query is a mathematical
|
|
expression
|
|
that describes one or more weather conditions (T < 32, Rain, Hail,
|
|
Snow,
|
|
and so forth).
|
|
<p>When a query is applied against a particular grid, its weather
|
|
conditions
|
|
are searched for. The result is a new edit area that consists of all
|
|
the
|
|
areas that match the query's weather conditions.
|
|
</p>
|
|
<p><img src="images/DialogEditArea.jpg" nosave=""><br>
|
|
</p>
|
|
<h2>Main Window</h2>
|
|
There are several windows and buttons on the Edit Area and Query
|
|
Dialog:
|
|
<ul>
|
|
<li class="4Heading">Query -- The query expression.</li>
|
|
<li>Groups -- Edit Area Group(s). You may select which edit
|
|
areas you
|
|
wish to view in the Edit Areas window. Edit Areas that are not part of
|
|
any group are displayed under "Misc".</li>
|
|
<li>Edit Areas -- Named edit areas that have been saved.</li>
|
|
<li>Weather Elements -- Weather elements that can be used in
|
|
the
|
|
query
|
|
expression.</li>
|
|
<li>Active Edit Area -- Displays the current edit area. If it
|
|
is a query,
|
|
the expression will be shown. If it is simply polygons, the word
|
|
"Polygon"
|
|
will be displayed.</li>
|
|
<li>Clear Query -- Clears the query expression.</li>
|
|
<li>Recall Query -- Displays a list of past queries (limit 10).
|
|
If
|
|
chosen,
|
|
the query will appear in the Query window. The list will not contain
|
|
duplicates.</li>
|
|
<li>Undo Edit Area -- Reverts to previous edit area.</li>
|
|
<li>Convert to Location -- If the current edit area is defined
|
|
by a
|
|
query,
|
|
converts it to a polygon. After this operation, the edit area is a
|
|
static
|
|
set of points and will not change with the data.</li>
|
|
<li>Submit -- Submit the query for evaluation. Clears the query
|
|
expression.</li>
|
|
<li>Cancel -- Cancel and close the dialog.</li>
|
|
</ul>
|
|
<h2>
|
|
Save/Delete Menu</h2>
|
|
The Save/Delete Menu at the top of the Dialog allows you to:
|
|
<ul>
|
|
<li class="4Heading">Save the Active Edit Area via the <a
|
|
href="#SaveEditAreaDialog">Save
|
|
Edit
|
|
Area Dialog.</a></li>
|
|
<li class="4Heading">Delete any Edit Area via the <a
|
|
href="#DeleteEditAreaDialog">Delete
|
|
Edit
|
|
Area Dialog.</a></li>
|
|
<li class="4Heading">Save Edit Area Groups via the <a
|
|
href="#SaveEditAreaGroupDialog">Save
|
|
Edit
|
|
Area Groups Dialog.</a></li>
|
|
<li class="4Heading">Delete Edit Area Groups via the <a
|
|
href="#DeleteEditAreaGroupDialog">Delete
|
|
Edit Area Groups Dialog</a></li>
|
|
</ul>
|
|
<h2 class="4Heading">
|
|
<a name="pvm"></a>Pickup Value Menu</h2>
|
|
<div class="4Heading">The PickupValue Menu at the top of the Dialog
|
|
lists
|
|
each of the weather elements that are currently loaded into the
|
|
GFE.
|
|
Selecting one of these will paste its current pickup value into the
|
|
query
|
|
area.
|
|
<br>
|
|
<h2><a name="wdvm"></a>Wx/Dis Values Menu</h2>
|
|
</div>
|
|
<div class="4Heading">The Wx/Dis Values brings up a menu with the
|
|
weather
|
|
and discrete weather elements listed. Choosing one of these will
|
|
bring up the Weather Value Dialog or Discrete Value Dialog. For
|
|
weather
|
|
elements, the user specifies the type, coverage/probability, intensity,
|
|
visibility, and any optional attributes. The edit area string will
|
|
then contain the "ugly" string for the comparison. See the <a
|
|
href="#WeatherPickUpValueDialog">Weather
|
|
Pick Up Dialog</a> for more details on how to use the dialog.</div>
|
|
<img src="images/DialogSetWeather.jpg" nosave="">
|
|
<p><a name="DiscreteSetValDialog"></a>For Discrete elements, the user
|
|
specifies
|
|
the key. See the <a href="#DiscretePickUpValueDialog">Discrete Pick Up
|
|
Dialog</a> more more detailed on how to use the dialog.
|
|
</p>
|
|
<p><img alt="Set Discrete Dialog" src="images/SetDiscreteDialog.png"><br>
|
|
<br>
|
|
</p>
|
|
<h2 class="4Heading"><a name="cmm"></a>Create Mask Menu</h2>
|
|
<div class="4Heading">The Create Mask menu entry brings up a menu with
|
|
the weather and discrete weather elements listed. Choosing one of
|
|
these will bring up the Weather Contains or Discrete Contains
|
|
Dialog.
|
|
These dialogs allow you to choose a combination of various values and
|
|
the
|
|
query will include all grid points that contain ANY of the items
|
|
selected
|
|
in the dialog.</div>
|
|
<div class="4Heading">For weather elements, the dialog presents choices
|
|
for the coverages, types, intensities, visibilities, and attributes.</div>
|
|
<p><br>
|
|
<img src="images/DialogWeatherContains.jpg" nosave=""></p>
|
|
<p>For discrete, the options are simply a list of the possible discrete
|
|
types:
|
|
</p>
|
|
<p><img src="images/DialogDiscreteContains.jpg" nosave=""><br>
|
|
</p>
|
|
<h3><a name="coq"></a>Components of Queries</h3>
|
|
You can create a new query by entering one or more weather conditions.
|
|
Query values can combine any number of the following:
|
|
<ul>
|
|
<li>Named Edit Areas</li>
|
|
<li>Weather Element relational­expressions</li>
|
|
<li>Weather type relational­expressions</li>
|
|
</ul>
|
|
Queries are written in numerical python, and thus the syntax is similar
|
|
to <a href="SmartTools.html">smart tools</a> and <a
|
|
href="SmartInit.html">smart
|
|
initialization</a>. An edit area and a weather element are
|
|
basically
|
|
Python variables. An edit area is represented by a mask of bits
|
|
which
|
|
make up the edit area. A weather element is a numerical grid for
|
|
SCALAR, a tuple of two numerical grids for VECTOR, and a grid and a key
|
|
for both WEATHER and DISCRETE.
|
|
<p>Parenthesis are very important when using the OR ('|') or AND
|
|
('&')
|
|
operators since these operators have a high order of precedence.
|
|
The following statements are not equal:
|
|
</p>
|
|
<center>
|
|
<p>T > 32 | Topo > 7000
|
|
<br>
|
|
(T > 32> | (Topo > 7000)</p>
|
|
</center>
|
|
<p>The following are valid queries for SCALAR data:
|
|
<br>
|
|
|
|
<table nosave="" border="1" width="100%">
|
|
<tbody>
|
|
<tr>
|
|
<td>T > 32</td>
|
|
<td>Temperature greater than 32</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T < 32</td>
|
|
<td>Temperature less than 32</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T == 32</td>
|
|
<td>Temperature equal to 32 (exactly)</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T != 32</td>
|
|
<td>Temperature not equal to 32 (exactly)</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T >= 32</td>
|
|
<td>Temperature greater than or equal to 32</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T <= 32</td>
|
|
<td>Temperature less than or equal to 32</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</p>
|
|
<p>More complicated queries may also be performed such as the following
|
|
on SCALAR data (note that parenthesis must be provided):
|
|
<br>
|
|
<br>
|
|
<table nosave="" border="1" width="100%">
|
|
<tbody>
|
|
<tr>
|
|
<td>T - Td > 10</td>
|
|
<td>Dew Point Depression is greater than 10</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T - 10 > Td</td>
|
|
<td>Dew Point Depression is greater than 10</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(QPF > 0.10) & (PoP < 70)</td>
|
|
<td>QPF greater than 0.10" and PoP less than 70%</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(T > 32) & (Topo > 5000) & (Topo < 7000)
|
|
& Colorado</td>
|
|
<td>Temperatures less than 32, with topography between 5000ft and
|
|
7000ft,
|
|
in the state of Colorado.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</p>
|
|
<p>Vector queries can be done on the magnitude and the direction
|
|
component,
|
|
note that Wind[0] refers to the magnitude and Wind[1] refers to the
|
|
direction,
|
|
as in smart initialization and smart tools:
|
|
<br>
|
|
<br>
|
|
<table nosave="" border="1" width="100%">
|
|
<tbody>
|
|
<tr>
|
|
<td>Wind[0] > 25</td>
|
|
<td>Wind speed greater than 25</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(Wind[0] > 25 & (Wind[0] < 40)</td>
|
|
<td>Wind speed between 25 and 40</td>
|
|
</tr>
|
|
<tr>
|
|
<td>(Wind[0] > 25 & (Wind[1] > 90 & (Wind[1] <
|
|
180)</td>
|
|
<td>Wind speed greater than 25, with the direction between 90 and
|
|
180.
|
|
The direction is the "FROM" direction.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</p>
|
|
<p>Weather and Discrete queries are performed using the <b><i>mask</i></b>
|
|
function. The mask button on the dialog simply saves you from
|
|
typing
|
|
the word mask. The mask function is in this form:
|
|
mask(weatherElementName,
|
|
stringMatch, regExpressionYesNo). Normally you don't provide a
|
|
regular
|
|
expression so the mask is in this form: mask(weatherElementName,
|
|
stringMatch). Here are some examples of using the mask function
|
|
for
|
|
Weather and Discrete:
|
|
<br>
|
|
<br>
|
|
<table nosave="" border="1" width="100%">
|
|
<tbody>
|
|
<tr>
|
|
<td>mask(Wx, ":R:")</td>
|
|
<td>Wx with Rain (R), with any coverage, visibility,
|
|
attributes.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>mask(Wx, ":R:") | mask(Wx, ":RW:")</td>
|
|
<td>Wx with Rain (R) or Rain Showers (RW)</td>
|
|
</tr>
|
|
<tr>
|
|
<td>mask(Wx, "Sct:RW:")</td>
|
|
<td>Wx with Scattered Rain Showers</td>
|
|
</tr>
|
|
<tr>
|
|
<td>mask(Highlights, "WntrStmWRN")</td>
|
|
<td>Highlights with Winter Storm Warning</td>
|
|
</tr>
|
|
<tr>
|
|
<td>mask(Wx, "Sct:RW:+:<NoVis>")</td>
|
|
<td>Wx with Scattered Heavy Rain Showers, No Visibility</td>
|
|
</tr>
|
|
<tr>
|
|
<td>mask(wx, "^Sct:RW:+:<NoVis>:\Z", 1)</td>
|
|
<td>Wx with ONLY Scattered Heavy Rain Showers, No Visibility.
|
|
Note that
|
|
this is regular expression syntax with the '^' matching the beginning
|
|
of
|
|
the phrase and the '\Z' matching the end of the phrase.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</p>
|
|
<p>The mask function uses substring searches of the keys to determine
|
|
what
|
|
grid points match the query. The PickUp Value and Wx/Dis Values
|
|
menus
|
|
provide a quick way to enter the pick up value or an exact match for
|
|
weather
|
|
and discrete weather elements. Note that since substring
|
|
comparisions
|
|
are performed, providing a query of mask(Wx, "Sct:RW:+:") will match
|
|
any
|
|
grid point that has Sct:RW:+: in it, so it will also match grid points
|
|
that have a weather key of:
|
|
"Iso:T:<NoInten>:<NoVis>:^Sct:RW:+:<NoVis>".
|
|
The only way to find grid points that ONLY have the Sct:RW:+: in it
|
|
without
|
|
others is to use the regular expression option as shown above in the
|
|
table.
|
|
</p>
|
|
<p>The create mask menu option provides an easy way to select a set of
|
|
Wx or Discrete characteristics to search.
|
|
</p>
|
|
<p>Combining queries are performed through the "|" OR and
|
|
"&"
|
|
AND operators. Since the syntax in the query is numpy, there
|
|
are many other possibilities for the syntax. Here is an example
|
|
of
|
|
using the python absolute() function to calculate the absolute value of
|
|
an expression. In this case, we are selecting all T grid points
|
|
that
|
|
differ from the AVN model greater than 5 degrees:
|
|
</p>
|
|
<p><b><tt>absolute(T - T_SFC__AVN) > 5</tt></b>
|
|
</p>
|
|
<p>The name in the query, e.g., T, can be one of several forms:
|
|
<br>
|
|
<br>
|
|
<table nosave="" border="1" width="100%">
|
|
<tbody>
|
|
<tr>
|
|
<td>T</td>
|
|
<td>Refers to T_SFC_Fcst_00000000_0000 (Fcst database)</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T_3K</td>
|
|
<td>Refers to T @ 3K, for the Fcst database</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T_SFC__NAM</td>
|
|
<td>Refers to T @ SFC, from the latest run of the NAM model</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T_SFC__NAM_20030310_1200</td>
|
|
<td>Refers to T @ SFC, from the March 10th, 12z, run of the NAM
|
|
model</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T_SFC_BOU_GRID__NAM</td>
|
|
<td>Same as T_SFC__NAM (The BOU_GRID is optional)</td>
|
|
</tr>
|
|
<tr>
|
|
<td>T_SFC_BOU_GRID__NAM_20030310_1200</td>
|
|
<td>Same as T_SFC__NAM_20030310_1200 (The BOU_GRID is optional.)</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</p>
|
|
<p></p>
|
|
<hr width="100%"></div>
|
|
</div>
|
|
<h1 class="3Heading">
|
|
<a name="SaveEditAreaDialog"></a>Save Edit Area Dialog</h1>
|
|
<a name="pgfId=176376"></a>The Save Edit Area Dialog allows you to name
|
|
and save the Active Edit Area. You may also designate which Edit Area
|
|
Group(s)
|
|
will include the Edit Area.
|
|
<p>To save the Active Edit Area, type a name in the Identifier box.
|
|
Select
|
|
the Edit Area Group(s) that are to include the Edit Area. If you want
|
|
the
|
|
area included in a new Group, simply type in the New Group name. No
|
|
Group(s)
|
|
need be selected -- including the Edit Area in Groups is optional and
|
|
can
|
|
be changed later using this or the
|
|
<a href="#SaveEditAreaGroupDialog">Save
|
|
Edit Area Groups Dialog.</a> Click "Save" to save the Edit Area. You
|
|
may
|
|
Cancel the dialog at any time.
|
|
</p>
|
|
<p><img src="images/DialogEditAreaSave.jpg" nosave=""><br>
|
|
</p>
|
|
</div>
|
|
</div>
|
|
<hr width="100%"></div>
|
|
</div>
|
|
<h1 class="3Heading">
|
|
<a name="DeleteEditAreaDialog"></a>Delete Edit Area Dialog</h1>
|
|
<a name="pgfId=176376"></a>The Delete Edit Area Dialog allows you to
|
|
delete
|
|
a saved Edit Area.
|
|
<p>To delete a saved Edit Area, click on its name which will appear in
|
|
the Identifier box and click "Delete." You may Cancel the dialog at any
|
|
time.
|
|
</p>
|
|
<p><img src="images/DialogEditAreaDelete.jpg" nosave=""><br></p>
|
|
</div>
|
|
</div>
|
|
<hr width="100%"></div>
|
|
</div>
|
|
<h1 class="3Heading">
|
|
<a name="SaveEditAreaGroupDialog"></a>Save Edit Area Group Dialog</h1>
|
|
<a name="pgfId=176376"></a>The Save Edit Area Group Dialog is
|
|
accessible
|
|
from the <a href="#EditAreaQueryDialog">Edit Area and Query Dialog</a>.
|
|
It allows you to name and save an Edit Area Group. You will designate
|
|
which
|
|
Edit Area(s) will be included in the Edit Area Group. These Groups can
|
|
then be used to filter the display in the <a
|
|
href="#EditAreaQueryDialog">Edit
|
|
Area and Query Dialog.</a> or to limit the user selections when
|
|
generating
|
|
products.
|
|
<p>To save an Edit Area Group, type a name in the Identifier box or
|
|
select
|
|
a Group from the left-hand list box. Select/deselect the Edit Area(s)
|
|
that
|
|
are to be included the Edit Area Group. Click "Save" to save the Edit
|
|
Area
|
|
Group.
|
|
</p>
|
|
<p>You may Cancel the dialog at any time.</p>
|
|
</div>
|
|
<img src="images/DialogEditAreaSaveGroup.jpg" nosave=""></div>
|
|
<hr width="100%"></div>
|
|
<h1 class="3Heading">
|
|
<a name="DeleteEditAreaGroupDialog"></a>Delete Edit Area Group Dialog</h1>
|
|
<a name="pgfId=176376"></a>The Delete Edit Area Group Dialog is
|
|
accessible
|
|
from the <a href="#EditAreaQueryDialog">Edit Area and Query Dialog</a>.
|
|
It allows you to delete an Edit Area Group.
|
|
<p>To delete a saved Edit Area Group, click on its name which will
|
|
appear
|
|
in the Identifier box and click "Delete Group." The Edit Areas included
|
|
in the Group will NOT be deleted unless you specifically choose to do
|
|
so
|
|
by checking the "Delete All Areas within Group" button. These areas
|
|
will
|
|
also then be deleted from any other groups in which they belong. If the
|
|
"With Verification" button is on, a dialog will appear for each Edit
|
|
Area
|
|
deleted so you can verify that you want it deleted.
|
|
</p>
|
|
<p>You may Cancel the dialog at any time.
|
|
</p>
|
|
<p><img src="images/DialogEditAreaDeleteGroup.jpg" nosave=""><br>
|
|
<br>
|
|
</p>
|
|
<p></p>
|
|
<hr width="100%">
|
|
<center><a href="#ButtonBarDialogs">Back To Top</a>
|
|
<a href="GFESuite.html#TableOfContents">Back To TOC</a></center>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|