Combined the Display and Radar Tools pages to one webpage

- update tools images

docs/cave/d2d-all-tools.md

@@ -1,4 +1,7 @@
-# Display Tools
+
+There are two main subsets of types of tools in CAVE: [Display Tools](#display-tools) and [Radar Tools](#radar-tools).
+
+## Display Tools
 
 The display tools are a subset of the tools available in CAVE.  These programs are accessible though the **Tools** dropdown menu.
 
@@ -6,11 +9,9 @@ The display tools are a subset of the tools available in CAVE.  These programs a
 
 Many of the tools listed under the Tools menu can be placed into an **editable state**. Do not enable the "Hide Legends" feature if you want to place a tool in an editable state, because access to editability is done by clicking the center mouse button, or right-clicking over the **Product Legend**.
 
-> **Note**: To see information about some of the other options in the Tools menu, check out the [**Radar Tools**](d2d-radar-tools) page.
-
 ---
 
-## Az/Ran Overlay
+### Az/Ran Overlay
 
 This tool displays a movable azimuth/range radar map overlay. The overlay is in the "editable" state when displayed, and can be relocated by clicking the right mouse button.
 
@@ -18,7 +19,7 @@ This tool displays a movable azimuth/range radar map overlay. The overlay is in
 
 ---
 
-## Baselines
+### Baselines
 
 Selecting Baselines displays 10 lines, labeled A-A' to J-J', along which cross-sections can be constructed from within the Volume Browser. Baselines come up editable.
 
@@ -28,7 +29,7 @@ Selecting Baselines displays 10 lines, labeled A-A' to J-J', along which cross-s
 
 ---
 
-## Choose By ID
+### Choose By ID
 
 Choose By ID, which is a function of DMD (Digital Mesocyclone Display), is a method of selecting feature locations. The tool is used to monitor the same feature at a certain location. Without the Choose By ID tool, a monitored feature (over a period of time) could move away from its monitored location and another feature could move in its place. You can use Choose By ID to set points, baselines, and "Home" for conventional locations like METARs and RAOBs (Radiosonde Observations), but its primary use is for the WSR-88D-identified mesocyclone locations. You can also access the Choose By ID tool from the Tools menu on the Volume Browser.
 
@@ -36,7 +37,7 @@ Choose By ID, which is a function of DMD (Digital Mesocyclone Display), is a met
 
 ---
 
-## Distance Bearing
+### Distance Bearing
 
 Selecting this tool displays six editable lines, each of which shows the azimuth and range of the labeled end of the line relative to the unlabeled end of the line. You can make the lines editable by clicking the center mouse button over the legend at the lower right of the display. Once in edit mode, a line can be moved as a unit and/or either of its end points can be adjusted.
 
@@ -44,7 +45,7 @@ Selecting this tool displays six editable lines, each of which shows the azimuth
 
 ---
 
-## Distance Speed
+### Distance Speed
 
 This tool can be used to determine the speed and direction of a storm or any other meteorological feature of interest. Selecting Distance Speed displays a Centroid Marker to move to the location of the storm or feature of interest in any two or more frames of displayed imagery (e.g., a satellite or radar loop). The system then displays a storm track with the direction (degrees) and speed (knots) of movement. When you select the Distance Speed option, the Distance Speed dialog box opens.
 
@@ -64,7 +65,7 @@ This tool can be used to determine the speed and direction of a storm or any oth
 
 ---
 
-## Distance Scale
+### Distance Scale
 
 Enabling this feature adds a scalebar to the bottom right hand of the main D2D display.  This tool can be used to determine the size of a storm or any other meteorological feature of interest.
 
@@ -72,7 +73,7 @@ Enabling this feature adds a scalebar to the bottom right hand of the main D2D d
 
 ---
 
-## Feature Following Zoom
+### Feature Following Zoom
 
 When you zoom in over a small area to be able to view a feature in detail, animation will often cause the feature to move into and then out of the field of view. This tool allows you to follow a feature of interest even when zoomed in to a small area.
 
@@ -80,14 +81,14 @@ To use this feature, first, you need to identify the location and motion of the
 
 ---
 
-## Home
+### Home
 
 Selecting the Home option displays a marker, which is an "X" with the word "Home" next to it.
 Clicking on the Home Location Legend with the center mouse button makes the marker editable; drag the "X" or click with the right mouse button to change its location. When the Home Marker is displayed, use the **Sample** feature (click and hold to access the menu to turn on sampling) to display the range in miles and azimuth (in degrees) of the pointer location relative to the Home location.
 
 ---
 
-## Points
+### Points
 
 The Points option initially displays a circular 10-point pattern, labeled A through J on the Map display. Points are used to generate model soundings, time-height cross-sections, time series, and variable vs. height plots using the Volume Browser. As with the Baselines, the locations of these Points can be edited in the following manner:
 
@@ -143,7 +144,7 @@ moved.
 
 ---
 
-## Put home cursor
+### Put home cursor
 
 The Put home cursor tool provides an easy way to locate a METAR observation station, a city and
 state, or a latitude/longitude coordinate. For Canada and Mexico, only the METAR observation stations and latitude/longitude coordinates are accessible. When you select Put home cursor from the Tools dropdown menu, the Home marker X is displayed and the Put Home Cursor dialog box opens.
@@ -159,7 +160,7 @@ Station, City/State, or Lat/Lon radio button, an Entry Box is activated next to
 
 ---
 
-## Range Rings
+### Range Rings
 
 The Range Rings Tool displays adjustable range rings around locations of interest to your local office. When you select Range Rings from the Tools dropdown menu, the Range Rings legend appears in the Main Display Pane. The tool comes up editable, and the rangeRing dialog box opens. (Clicking the middle mouse button over the legend toggles tool editability and closes/opens the rangeRing dialog box.) Within this dialog box, you can toggle on/off any of the target locations using the square selectors. Adjust the size of the radii (in nautical miles) by typing a new value in the entry boxes associated with each location and pressing the Apply button. You can also add labels at the center of the range ring and/or at any of the radial distances using the Labels Options menu associated with each location. Using the Movable Rings, you can add a new location at a specific point by using the Interactive Points Tool, or by typing in latitude/longitude coordinates. There is no practical limit on the number of new locations you can add to the display. The list of locations is pre-set but can be customized at a field site.
 
@@ -167,7 +168,7 @@ The Range Rings Tool displays adjustable range rings around locations of interes
 
 ---
 
-## Sunset/Sunrise
+### Sunset/Sunrise
 
 By typing a date, as well as the latitude and longitude of a location into the Sunrise/Sunset Tool dialog box, you can obtain the time (for any time zone) of sunrise and sunset, as well as the total length of daylight for that date. Additional features include the ability to calculate the sunrise/sunset in a different hemisphere, and the azimuthal angles, relative to true north, of the sunrise and sunset.
 
@@ -181,13 +182,13 @@ Selecting this option brings up a Text Display window that behaves in the same w
 
 ---
 
-## Time of Arrival / Lead Time
+### Time of Arrival / Lead Time
 
 Selecting the Time Of Arrival / Lead Time option displays a tracking line from a feature's initial starting point in a past frame to its final position in the current frame. Once the final position is set, an Arrival Point is displayed. You can drag this point anywhere along the line to get the Time Of Arrival / Lead Time and Distance. You can also change the Mode from Point to Circular Front or Polyline anywhere along the line to better represent the feature(s).
 
 ---
 
-## Units Calculator
+### Units Calculator
 
 This tool converts the units of the first column into differing units of the second column. The units are grouped into temperature, speed, distance, time, and atmospheric pressure. First, simply type the number and select the units of the value you wish to convert in the firstcolumn entry box. Then in the second column, select the desired units to which you want the original value converted. The new value will appear in the second column entry box.
 
@@ -195,8 +196,104 @@ This tool converts the units of the first column into differing units of the sec
 
 ---
 
-## Text Workstation
+### Text Workstation
 
 By selecting one of the "Text" buttons, a text window opens up. In National Weather Service operations, the text workstation is used to edit new warning text as well as look up past warnings, METARs, and TAFs. This functionality is **disabled** in the Unidata AWIPS version.
 
 ![](../images/textWorkstation.png)
+
+---
+
+## Radar Tools
+
+The radar tools are a subset of the tools available in CAVE. These programs are accessible though the **Tools** dropdown menu, and in individual site radar menus.
+
+![image](../images/toolsMenuRadarTools.png)
+
+---
+
+### Estimated Actual Velocity (EAV)
+
+A velocity (V) display from the radar shows only the radial component of the wind, so the indicated speed depends on the direction of the wind and the azimuth (direction) from the radar. Consider, for example, a north wind. Straight north of the radar, the full speed of the wind will be seen on the V product. As one moves around to the east of the radar, the radial component gets smaller, eventually reaching zero straight east of the radar. If the wind direction is known, then the actual wind speed can be computed by dividing the observed radial speed by the cosine of the angle between the radar radial and the actual direction. The EAV tool allows you to provide that angle and use the sampling function of the display to show the actual wind speed.
+
+![image](../images/estimatedActualVelocity.gif)
+
+---
+
+### Radar Display Controls
+
+<span style="float:right;">
+![image](../images/radarDisplayControls.png)
+</span>
+
+The Radar Display Controls dialog box is derived from the Radar Tools submenu and provides options that control the appearance of the Storm Track Information (STI), the Hail Index (HI), the Tornado Vortex Signature (TVS), the Digital Mesocyclone Display (DMD) products, the Microburst Alert (MBA) products, the Storm Relative Motion (SRM), and the SAILS products. The Radar Display Controls dialog box options are described below.
+
+> **Note**: Our version of CAVE may not have all the products that these options are applicable to.
+
+The Radar Display Controls dialog box is divided into eight sections: [STI](#sti-storm-track-information), [HI](#hi-hail-index), [TVS](#tvs-tornado-vortex-signature), [DMD/MD/TVS](#dmd-md-tvs), [DMD](#dmd-digital-mesocyclone-display), [MBA](#mba-microburst-alert), [SRM](#srm-storm-relative-motion), and [SAILS](#sails-supplemental-adaptive-intra-volume-low-level-scan). Each section has the following options:
+
+#### STI (Storm Track Information)
+
+This section has options to adjust the appearance of the STI graphic product.
+
+* **Number of storms to show**: This slider bar lets you choose the maximum number of storms (0 to 100) you wish to display on the STI product. The default value is 20 storms.
+* **Type of track to show**: This options menu allows you to choose the type of storm track that you want displayed.
+
+#### HI (Hail Index)
+
+This portion of the Radar Display Controls dialog box contains options that alter the appearance of the HI radar graphic product. You can set the low and high algorithm thresholds of the Probability of Hail (POH) and the Probability of Severe Hail (POSH). Storms that meet the low POH threshold are indicated by small open triangles, while small solid triangles mark those that meet the high POH threshold. Similarly, large open triangles or solid triangles are plotted for the POSH low and high thresholds, respectively.
+
+* **Low hail probability (POH)**: The storms that meet or exceed the threshold are indicated by small open triangles. The default setting is 30.
+* **Low severe hail probability (POSH)**: The storms that meet or exceed the threshold are indicated by large open triangles. The default setting is 30.
+* **High hail probability**: The storms that meet or exceed the threshold are indicated by small solid triangles. The default setting is 50.
+* **High severe hail probability**: The storms that meet or exceed the threshold are indicated by small solid triangles. The default setting is 50.
+
+#### TVS (Tornado Vortex Signature)
+
+There is one option in this section of the Radar Display Controls dialog box.
+
+* **Show elevated TVS**: This toggle button lets you control the appearance of the elevated TVS radar graphic product.
+
+#### DMD, MD, TVS
+
+There is one option in this section of the Radar Display Controls dialog box.
+
+* **Show extrapolated features**: With this option, you can choose whether to show the time-extrapolated features using DMD, MD, or TVS.
+
+#### DMD (Digital Mesocyclone Display)
+
+* **Minimum feature strength**:  A mesocyclone clutter filter which specifies the minimum 3D strength rank use to display a mesocyclone (default is 5).
+* **Show overlapping Mesos**:  Toggles whether to show overlapping mesocyclones.
+* **Type of track to show**:  This dropdown has option available for whether to display past and/or forcast tracks.
+
+#### MBA (Microburst Alert)
+
+* **Show Wind Shear**:  This option allows you to choose whether to display wind shear associated with microburts alerts.
+
+#### SRM (Storm Relative Motion)
+
+The first three options in the SRM section allow you to choose where you want to derive the storm motion from.
+
+* **Storm Motion from WarnGen Track**:  Selecting this option will display the storm motion from a WarnGen Track.
+* **Average Storm Motion from STI**:  Selecting this option will display the average storm motion from from the storm track information (STI).
+* **Custom Storm Motion**:  Selecting this option allows you to specify a custom storm motion with the selections below.
+    - **Direction**: This slider allows you to choose the direction (in degrees??) of the storm motion.
+    - **Speed**:  This slider allows you to specify the speed (in mph??) of the storm motion.
+
+#### SAILS (Supplemental Adaptive Intra-Volume Low Level Scan)
+
+* **Enable SAILS Frame Coordinator**:  
+**Enabled (default)**: keyboard shortcuts change where tilting up from 0.5 degree SAILS tilt will step to the next higher tilt (similar to GR2 Analyst) and Ctrl right arrow will step to the most recent tilt available for any elevation angle.  
+**Disabled**: keyboard shortcuts change where tilting up from 0.5 degree SAILS tilt will not go anywhere (old confusing behavior) and Ctrl right arrow will step to the most recent time of the current tilt.
+
+---
+
+### VR - Shear
+
+This tool is used in conjunction with Doppler velocity data to calculate the velocity difference (or "shear") of the data directly under the end points. As with the Baselines, this feature comes up editable and the end points can be dragged to specific gates of velocity data. When in place, the speed difference (kts), distance between end points (nautical miles), shear (s-1), and distance from radar (Nmi) are automatically plotted next to the end points and in the upper left corner of the Main Display Pane. A positive shear value indicates cyclonic shear, while a negative value indicates anticyclonic shear. If either end point is not directly over velocity data, the phrase "no data" is reported for the shear value. This tool is also useful in determining gate-to-gate shear. Simply place the two end points directly over adjacent gates of velocity data.
+
+* **"Snapping" VR Shear**: If you are zoomed in over an area when you load VR - Shear, and the VR - Shear Baseline does not appear, click the right mouse button to "snap" the Baseline to where the mouse cursor is located.
+* **VR - Shear in 4 Panel**: You can use the VR - Shear Tool when the large display is in 4 panel
+mode. The VR - Shear overlay is loaded in different colors for each panel. There are actually
+four copies of the program running, and each behaves independently. This means that you can
+get accurate readings in any one of the four panels — one VR - Shear panel is editable at a time. To activate, click the center mouse button on the VR - Shear legend in the desired panel and position the query line to the echoes of interest.

docs/cave/d2d-radar-tools.md

@@ -1,93 +0,0 @@
-# Radar Tools
-
-The radar tools are a subset of the tools available in CAVE. These programs are accessible though the **Tools** dropdown menu, and in individual site radar menus.
-
-![image](../images/toolsMenuRadarTools.png)
-
----
-
-## Estimated Actual Velocity (EAV)
-
-A velocity (V) display from the radar shows only the radial component of the wind, so the indicated speed depends on the direction of the wind and the azimuth (direction) from the radar. Consider, for example, a north wind. Straight north of the radar, the full speed of the wind will be seen on the V product. As one moves around to the east of the radar, the radial component gets smaller, eventually reaching zero straight east of the radar. If the wind direction is known, then the actual wind speed can be computed by dividing the observed radial speed by the cosine of the angle between the radar radial and the actual direction. The EAV tool allows you to provide that angle and use the sampling function of the display to show the actual wind speed.
-
-![image](../images/estimatedActualVelocity.gif)
-
----
-
-## Radar Display Controls
-
-<span style="float:right;">
-![image](../images/radarDisplayControls.png)
-</span>
-
-The Radar Display Controls dialog box is derived from the Radar Tools submenu and provides options that control the appearance of the Storm Track Information (STI), the Hail Index (HI), the Tornado Vortex Signature (TVS), the Digital Mesocyclone Display (DMD) products, the Microburst Alert (MBA) products, the Storm Relative Motion (SRM), and the SAILS products. The Radar Display Controls dialog box options are described below.
-
-> **Note**: Our version of CAVE may not have all the products that these options are applicable to.
-
-The Radar Display Controls dialog box is divided into eight sections: [STI](#sti-storm-track-information), [HI](#hi-hail-index), [TVS](#tvs-tornado-vortex-signature), [DMD/MD/TVS](#dmd-md-tvs), [DMD](#dmd-digital-mesocyclone-display), [MBA](#mba-microburst-alert), [SRM](#srm-storm-relative-motion), and [SAILS](#sails-supplemental-adaptive-intra-volume-low-level-scan). Each section has the following options:
-
-### STI (Storm Track Information)
-
-This section has options to adjust the appearance of the STI graphic product.
-
-* **Number of storms to show**: This slider bar lets you choose the maximum number of storms (0 to 100) you wish to display on the STI product. The default value is 20 storms.
-* **Type of track to show**: This options menu allows you to choose the type of storm track that you want displayed.
-
-### HI (Hail Index)
-
-This portion of the Radar Display Controls dialog box contains options that alter the appearance of the HI radar graphic product. You can set the low and high algorithm thresholds of the Probability of Hail (POH) and the Probability of Severe Hail (POSH). Storms that meet the low POH threshold are indicated by small open triangles, while small solid triangles mark those that meet the high POH threshold. Similarly, large open triangles or solid triangles are plotted for the POSH low and high thresholds, respectively.
-
-* **Low hail probability (POH)**: The storms that meet or exceed the threshold are indicated by small open triangles. The default setting is 30.
-* **Low severe hail probability (POSH)**: The storms that meet or exceed the threshold are indicated by large open triangles. The default setting is 30.
-* **High hail probability**: The storms that meet or exceed the threshold are indicated by small solid triangles. The default setting is 50.
-* **High severe hail probability**: The storms that meet or exceed the threshold are indicated by small solid triangles. The default setting is 50.
-
-### TVS (Tornado Vortex Signature)
-
-There is one option in this section of the Radar Display Controls dialog box.
-
-* **Show elevated TVS**: This toggle button lets you control the appearance of the elevated TVS radar graphic product.
-
-### DMD, MD, TVS
-
-There is one option in this section of the Radar Display Controls dialog box.
-
-* **Show extrapolated features**: With this option, you can choose whether to show the time-extrapolated features using DMD, MD, or TVS.
-
-### DMD (Digital Mesocyclone Display)
-
-* **Minimum feature strength**:  A mesocyclone clutter filter which specifies the minimum 3D strength rank use to display a mesocyclone (default is 5).
-* **Show overlapping Mesos**:  Toggles whether to show overlapping mesocyclones.
-* **Type of track to show**:  This dropdown has option available for whether to display past and/or forcast tracks.
-
-### MBA (Microburst Alert)
-
-* **Show Wind Shear**:  This option allows you to choose whether to display wind shear associated with microburts alerts.
-
-### SRM (Storm Relative Motion)
-
-The first three options in the SRM section allow you to choose where you want to derive the storm motion from.
-
-* **Storm Motion from WarnGen Track**:  Selecting this option will display the storm motion from a WarnGen Track.
-* **Average Storm Motion from STI**:  Selecting this option will display the average storm motion from from the storm track information (STI).
-* **Custom Storm Motion**:  Selecting this option allows you to specify a custom storm motion with the selections below.
-    - **Direction**: This slider allows you to choose the direction (in degrees??) of the storm motion.
-    - **Speed**:  This slider allows you to specify the speed (in mph??) of the storm motion.
-
-### SAILS (Supplemental Adaptive Intra-Volume Low Level Scan)
-
-* **Enable SAILS Frame Coordinator**:  
-**Enabled (default)**: keyboard shortcuts change where tilting up from 0.5 degree SAILS tilt will step to the next higher tilt (similar to GR2 Analyst) and Ctrl right arrow will step to the most recent tilt available for any elevation angle.  
-**Disabled**: keyboard shortcuts change where tilting up from 0.5 degree SAILS tilt will not go anywhere (old confusing behavior) and Ctrl right arrow will step to the most recent time of the current tilt.
-
----
-
-## VR - Shear
-
-This tool is used in conjunction with Doppler velocity data to calculate the velocity difference (or "shear") of the data directly under the end points. As with the Baselines, this feature comes up editable and the end points can be dragged to specific gates of velocity data. When in place, the speed difference (kts), distance between end points (nautical miles), shear (s-1), and distance from radar (Nmi) are automatically plotted next to the end points and in the upper left corner of the Main Display Pane. A positive shear value indicates cyclonic shear, while a negative value indicates anticyclonic shear. If either end point is not directly over velocity data, the phrase "no data" is reported for the shear value. This tool is also useful in determining gate-to-gate shear. Simply place the two end points directly over adjacent gates of velocity data.
-
-* **"Snapping" VR Shear**: If you are zoomed in over an area when you load VR - Shear, and the VR - Shear Baseline does not appear, click the right mouse button to "snap" the Baseline to where the mouse cursor is located.
-* **VR - Shear in 4 Panel**: You can use the VR - Shear Tool when the large display is in 4 panel
-mode. The VR - Shear overlay is loaded in different colors for each panel. There are actually
-four copies of the program running, and each behaves independently. This means that you can
-get accurate readings in any one of the four panels — one VR - Shear panel is editable at a time. To activate, click the center mouse button on the VR - Shear legend in the desired panel and position the query line to the echoes of interest.

docs/index.md

@@ -25,9 +25,6 @@ AWIPS takes a unified approach to data ingest, where most data ingested into the
 
 Unidata supports two data visualization frameworks: [CAVE](install/install-cave) (an Eclipse-built Java application which runs on Linux, Mac, and Windows), and [python-awips](python/overview) (a python package).
 
-> **Note**: Our version of CAVE is a **non-operational** version.  It does not support some features of NWS AWIPS.  Warnings and alerts cannot be issued from Unidata's CAVE.  Additional functionality may not be available as well.
-
-
 ![CAVE](images/Unidata_AWIPS2_CAVE.png)
 
 ---

docs/mkdocs.yml

@@ -45,8 +45,9 @@ nav:
       - GOES 16/17: cave/goes-16-17-satellite.md
       - GIS and Shapefiles: cave/d2d-gis-shapefiles.md
       - Volume Browser: cave/d2d-gridded-models.md
-      - Display Tools: cave/d2d-tools.md
+      - Tools: cave/d2d-all-tools.md
-      - Radar Tools: cave/d2d-radar-tools.md
+      # - Display Tools: cave/d2d-tools.md
+      # - Radar Tools: cave/d2d-radar-tools.md
       - Editing Menus: cave/d2d-edit-menus.md
       - Change Localization: cave/cave-localization.md
       - Import/Export: cave/import-export.md

docs/pdf/index.md

@@ -1,14 +0,0 @@
----
-layout: default
-type: guide
-title: NWS Release Documentation
----
-
-
-* [AWIPS System Manager’s Manual: Operational Build 16.2.2](OB16.2.2_SMM_without_Redlines.pdf)
-* [AWIPS CAVE D2D User Manual](AUM16.1.1-Book.pdf)
-* [AWIPS Site Migration Guide](A2_Site__Migration__Guide_v25_OB15.1.1.pdf)
-* [AWIPS Flow Tag Instructions: ADE Setup](AWP.FT.SWCTR.ADE-12.00.pdf)
-* [AWIPS Operational Build 16.2.2 Final Release Notes](AWP.RLSN.OB16.2.2_Final.pdf)
-
-> From [http://collaborate2.nws.noaa.gov/partners/](http://collaborate2.nws.noaa.gov/partners/)

mkdocs.yml

@@ -45,8 +45,9 @@ nav:
       - GOES 16/17: cave/goes-16-17-satellite.md
       - GIS and Shapefiles: cave/d2d-gis-shapefiles.md
       - Volume Browser: cave/d2d-gridded-models.md
-      - Display Tools: cave/d2d-tools.md
+      - Tools: cave/d2d-all-tools.md
-      - Radar Tools: cave/d2d-radar-tools.md
+      # - Display Tools: cave/d2d-tools.md
+      # - Radar Tools: cave/d2d-radar-tools.md
       - Editing Menus: cave/d2d-edit-menus.md
       - Change Localization: cave/cave-localization.md
       - Import/Export: cave/import-export.md