RAC Procedures - Warning Decision Training Division (WDTD)

Procedures and Colormaps Instructions (Last Updated 2/27/2024)

Procedures
RACSevereProcedures-FY23.xml
RAC-FF-Warning-Ops.xml 

Colormaps - Severe
1024 Z.cmap
1024 Velocity.cmap
HailMeteorTrail.cmap

Colormaps - Flash Flood
flashSoilM.cmap
V12-CRESTUnitQ.cmap
streamflow flash exp2.cmap
mrmsQPEDP-MatchSTA.cmap

StyleRules
gridImageryStyleRules.xml
precipRateImageryStyleRules.xml

Python3 Programs - for automating the conversion of the bundles to local radars
Main.py
loadLocalizationInfo.py
displayLayout.py
bundleModify.py
RadarProducts.csv
ReadMe.txt

------------------------

Colorblind Procedures & Files
RACSevereProcedures-FY23-ColorBlind.xml
alternate 8 bit.cmap

------------------------

Download Files

1. Make a new folder to download files and not have them conflict with previously downloaded files (e.g. mkdir proc-3-1-2023), and cd into that folder (e.g. cd proc-3-1-2023). Run pwd in the terminal and hit enter to identify the full path to the folder.
2. Right click on each of the files above (2 procedures, 7 colormaps, 2 StyleRules, and 4 Python programs, a .csv file , and a ReadMe.txt file) and select Save Link As to save to the folder created in step 1.
   1. Note: you will have problems if there are existing files of the same name. The indexed files won't run, and things won't work.
3. Have your ITO or AWIPS Focal Point install the Local File Installer and Near Storm Environment Awareness Tool from the SCP following the documentation in the downloaded ReadMe.txt. If the ITO is going to run all of the procedure commands to build the bundles, then the ITO should coordinate with the forecaster on the order of the radars provided to the python program for the four-panel radar bundles. 
4. Recreate the RAC bundles using one of the methods below:
   1. Severe
      1. Mostly Automated (recommended) - using a Python3 program with command-line arguments to create all bundles
      2. Manual - copy the bundle into the localization perspective and alter and re-center
   2. Flash Flood
      1. Mostly Automated (recommended) - using a Python3 program with command-line arguments to create all bundles
      2. Manual - copy the bundle into the localization perspective and alter and re-center 

Severe Option 2 (Manual)

Download Files and Copy into Localization Perspective

1. On your Linux desktop locate the Downloads folder using the File Browser (e.g. double click on your Home icon), and identify all of the files you downloaded.
2. Launch CAVE.
3. Open the Localization perspective (e.g. Left click on the Open Perspective icon in the CAVE toolbar and select Localization).
4. Double click on the CAVE folder to identify the Color Maps subfolder to be used in step 5.
5. In the Downloads folder on your Linux desktop from step 1, select the 1024 Z.cmap and 1024 Velocity.cmap files by holding down the Ctrl button and left clicking on the icons. Then perform a “drag and drop” into the CAVE -> Color Maps folder from step 4.
6. Double click on the CAVE -> Color Maps folder and drag the slider bar down to identify the mrms subfolder to be used in the next step (if mrms does not exist you will need to get with your local AWIPS focal point to create it, otherwise some bundles will not display some data).
7. In the Downloads folder on your Linux desktop from step 1, select the HailMeteorTrail.cmap file by holding down the Ctrl button and left clicking on the icon. Then perform a “drag and drop” into the CAVE -> Color Maps -> mrms folder from step 6.
8. Collapse the Color Maps folder in the localization perspective by clicking on the triangle to the left of the name.
9. Collapse the CAVE folder in the localization perspective by clicking on the triangle to the left of the name.
10. Double click on the D2D folder in the Localization perspective.
11. Select the RACSevereProcedures-FY23.xml files from the Downloads folder using Ctrl + left click and perform a “drag and drop” into the D2D -> Procedures folder.

Modify Severe Weather Bundle

1. In the Localization perspective D2D -> Procedures folder select RACSevereProcedures-FY23.xml and double click on USER to modify the user override.
2. Click on the "Source" tab at the bottom of the editor window to view the full document source xml.
3. With your cursor inside the window, use Ctrl F to launch the find/replace window and enter SGF in the Find: box and your CWA in all upper case (e.g. PAH) in the Replace with: box. Click the Replace All button.
4. Save the procedure by using Ctrl-S or use File-Save. You should see the * disappear from the procedure tab name in the top left of the display.
5. Switch back to the D2D perspective by clicking on the D2D label in the CAVE toolbar.
6. From the File menu in the D2D Perspective, select Procedures, then select Open.
7. From the USER pulldown menu, double click on RACSevereProcedures-FY23.xml.
8. Select SRAD MRMS and then left click on the Load button at the bottom of the Procedure window (or double click on bundle name). The data will likely not display completely yet.
9. From the CAVE Scales menu, select WFO. This should re-center the display over your CWA.
10. Now you are ready to copy this into a local procedure to save. Open a new procedure (File -> Procedures -> New), and in the Procedures window, left click on Copy In.
11. Left click on Save As and give the new procedure a name (e.g. FY23RAC-severe-local.xml) and click OK.
12. Change to the Localization perspective and in D2D -> Procedures select RACSevereProcedures-FY23.xml and double click on USER to modify the user override.
13. Select the Source tab at the bottom, and open the Find/Replace tool (Ctrl F). Enter keax in the Find: box and the radar you want in the upper left panel in the Replace with: box (ideally the most northwest radar). Then click the Replace All button.
14. Select the Source tab at the bottom, and open the Find/Replace tool (Ctrl F). Enter klsx in the Find: box and the radar you want in the upper right panel in the Replace with: box (ideally the most northeast radar). Then click the Replace All button.
15. Select the Source tab at the bottom, and open the Find/Replace tool (Ctrl F). Enter kinx in the Find: box and the radar you want in the lower right panel in the Replace with: box (ideally the most southwest radar). Then click the Replace All button.
16. Select the Source tab at the bottom, and open the Find/Replace tool (Ctrl F). Enter ksgf in the Find: box and the radar you want in the lower left panel in the Replace with: box (ideally the most southeast radar). Then click the Replace All button.
17. Save the procedure by using Ctrl-S or use File-Save. You should see the * disappear from the procedure tab name in the top left of the display.
18. Switch back to the D2D perspective and load the SRAD Single bundle in the Procedure window (you may need to close and re-open the RAC-FY19-GIDSevere.xml window for your changes to appear).
19. From the CAVE Scales menu, select WFO. This should re-center the display over your CWA. If your local CWA boundary doesn't appear, reload it.
20. Now you are ready to copy this into your local procedure (e.g. FY23RAC-severe-local.xml) to save. Open your local Procedure window, left click on Copy In. Click Save.
21. Select one of the four kxxx 4 Pnl All-Tilts type bundles (should be your local radars) from the RACSevereProcedures-FY23.xml procedure.
22. From the CAVE Scales menu, select WFO. This should re-center the display over your CWA. If your local CWA boundary doesn't appear, reload it.
23. In the new procedure window (e.g. FY23RAC-severe-local.xml) click Copy In then click Save.
24. Once you have a radar bundle created for one of your four local radars centered on your WFO, you can use the Alter button to load it with another local radar and rename the bundle and save the procedure. Or you can load and re-center the other existing bundles.
    • In the Alter Bundle on Loading window, select the Radar check box, and then click on the button to the right to select the local radar you want to use. Click Load. Then Copy In the bundle to your procedure and use the Rename button to rename the bundle with the new radar name and click Save.
    • In the kxxx 4 Pnl All-Tilts bundles, the lower-right panel may not have any SW/ZDR data for your dial radars if you do not have SW data. You can right click on the lower-right panel and select Load To This Panel and manually load ZDR(All) from your kxxx/kxxx ZDR radar menu (or Radar->Dial Radars menu). You might also want to right click on the Velocity legend text to change it to white like the others. Once you fix any bundles you will have to copy the bundle back in to your procedure and delete the previous version.  Note once you have a new bundle created you can use the Alter button in the procedures window to apply this format to other dial radars that don't have SW data rather than manually doing this step for each radar.
    • TDWRs will not work well with any of the all-tilts procedures, as they will not load data on any panel with dual pol, SW, or other 88D-specific products.
25. Perform the load, re-center, copy in, and save steps for all the remaining bundles 
    • In the kxxx 9pnl All-Tilts bundle, if you do not have raw CC on your RPS list, then the middle panel will show up without any data loaded. If you don't have raw CC on your RPS list, then you will need to right click in the middle panel and select Load To This Panel and manually load CC(All) from your radar's CC menu (e.g. kxxx/kxxx CC). You might also want to right click on the CC legend text to change it to white like the others. Once you fix any bundles you will have to copy the bundle back in to your procedure.
26. For the MESO-CAPE/SRH CIN Obs RALA bundle, after loading you will need to re-select the State scale, Copy In, and click Save in your new procedure.
27. Once you have all bundles saved into your new procedure, you can load them into other procedures and new tabs in your Perspective Displays.
28. Close the RACSevereProcedures-FY23.xml Procedure window.

Flash Flood Option 1 (Mostly Automated)

Create All New Bundles With a Python3 Program

1. Open a terminal window (e.g. right click on Linux desktop background and select Open Terminal).
2. Change directory to the download location you downloaded the files to (e.g. cd /Downloads/RAC).
3. Run "python Main.py --wfo $your_3letter_CWA_id --radars $radar1 $radar2 $radar3 $radar4 --autoGuess", where radar1 is the upper-left panel, radar2 is the upper-right panel (***NOTE: the python program uses the second radar in the list as your primary radar, choose the radar with the best coverage in your CWA as the second radar), radar3 is the lower-right panel, and radar4 is the lower-left panel (must be 4 radars and should be arranged based off of relative position to each other).
   • e.g. python Main.py --wfo OUN --radars kvnx ktlx kinx kfdr --autoGuess
   • Follow any instructions when prompted by the program. You will need to choose a satellite option for east versus west, but most prompts you can just accept what the program recommends.
   • The program needs to be run for each procedure file. Re-run and select the second hydro procedure after finishing with the first severe procedure.
4. Launch CAVE.
5. Open the Localization perspective (e.g. Left click on the Open Perspective icon in the CAVE toolbar and select Localization).
6. Double click on the CAVE folder to identify the Color Maps subfolder to be used in the next step.
7. In the Downloads folder on your Linux desktop from Step 2, select the mrmsDPQPE-MatchSTA.cmap file and then perform a “drag and drop” into the CAVE->Color Maps folder from Step 6.
8. Double click on the CAVE Color Maps folder and drag the slider bar down to identify the mrms subfolder to be used in the next step (if mrms does not exist you will need to get with your local AWIPS focal point to create it, otherwise some bundles will not display some data).
9. In the Downloads folder on your Linux desktop from Step 2, select the flashSoilM.cmap, V12-CRESTUnitQ.cmap, and streamflow flash exp2.cmap files by holding down the Ctrl button and left clicking on the icons. Then perform a “drag and drop” into the CAVE->Color Maps/mrms folder.
10. Collapse the Color Maps folder in the localization perspective by clicking on the triangle to the left of the name.
11. Select gridImageryStyleRules.xml and precipRateImageryStyleRules.xml from the Downloads folder and "drag and drop" into CAVE->Style Rules folder.
12. Collapse the CAVE folder in the localization perspective by clicking on the triangle to the left of the name.
13. Double click on the D2D folder in the Localization perspective.
14. Select the new procedure files you created in Step 2 from the Downloads folder using Ctrl + left click and perform a “drag and drop” into the D2D->Procedures folder. 
15. MODIFIED_4xRAC-FF-Warning-Ops.xml is the default name if you didn't change it
16. Click on the D2D perspective icon in the upper-right part of CAVE and then restart CAVE to be able to see the new colormaps and procedures.
17. In D2D, open up the procedure you just added in step 13 and load the bundles.

Flash Flood Option 2 (Manual)

Download Files and Copy into Localization Perspective

1. On your Linux desktop locate the Downloads folder using the File Browser (e.g. double click on your Home icon), and identify all of the files you downloaded.
2. Launch CAVE.
3. Open the Localization perspective (e.g. Left click on the Open Perspective icon in the CAVE toolbar and select Localization).
4. Double click on the CAVE folder to identify the Color Maps subfolder (to be used in the next step).
5. In the Downloads folder on your Linux desktop (from Step 1), select the mrmsDPQPE-MatchSTA.cmap file and then perform a “drag and drop” into the CAVE->Color Maps folder.
6. Double click on the CAVE Color Maps folder and drag the slider bar down to identify the mrms subfolder to be used in the next step (if mrms does not exist you will need to get with your local AWIPS focal point to create it, otherwise some bundles will not display some data).
7. In the Downloads folder on your Linux desktop from Step 1, select the flashSoilM.cmap, V12-CRESTUnitQ.cmap, and streamflow flash exp2.cmap files by holding down the Ctrl button and left clicking on the icons. Then perform a “drag and drop” into the CAVE->Color Maps/mrms folder.
8. Collapse the Color Maps folder in the localization perspective by clicking on the triangle to the left of the name.
9. Select gridImageryStyleRules.xml and precipRateImageryStyleRules.xml from the Downloads folder and "drag and drop" into CAVE->Style Rules folder.
10. Collapse the CAVE folder in the localization perspective by clicking on the triangle to the left of the name.
11. Double click on the D2D folder in the Localization perspective.
12. Select RAC-FF-Warning-Ops.xml files from the Downloads folder and perform a “drag and drop” into the D2D->Procedures folder.

Modify Hydro Bundle

1. From the File menu in the D2D Perspective, select Procedures, then select Open.
2. From the USER pulldown menu, double click on RAC-FF-Warning-Ops.xml.
3. Bundle: 1. Environment: NSHARP Points and Radar
   1. In the procedure pop-up GUI, click on bundle 1. Environment: NSHARP Points and Radar and select Alter.
      1. Click the Radar selection box (eeri) to bring up a list of radars. Scroll to find and select your primary local radar and then click Load. From the Scales menu, select WFO to re-center the bundle over your CWA.
   2. Now you are ready to copy this into a local procedure to save.
      1. Open a new procedure (File->Procedures->New), and in the Procedures window, left click on Copy In.
      2. Left click on Save As and give the new procedure a name and click OK.
4. Bundle: 2. Soil Condition...
   1. Double click on bundle 2. Soil Conditions… to load.
      1. From the Scales menu, select WFO to re-center the bundle over your CWA. Click Copy In and Save.
5. Bundle: 2. Nearest Radar...
   1. Double click on bundle 2. Nearest Radar… to load.
      1. From the Scales menu, select WFO to re-center the bundle over your CWA.
      2. You’ll now need to manually add your WFO’s 4 closest radars and their associated melting layer overlays following these steps:
         1. In the upper-left panel, right-click to hold and select Load to this panel.
         2. From your Radar/Dial Radars menu, choose kxxx -> kxxx Z -> 0.5 Z best res where kxxx is one of your WFO’s dedicated radars. On that same panel, overlay kxxx -> kxxx Algorithm Overlays -> Melting Layer -> 0.5 ML.
         3. Repeat this process for the 3 other panels using your WFO’s closest radars (dedicated or dial radars) and their associated melting layer overlays.
         4. Click Copy In and Save.
6. Bundles: 3a, 3b, 3c, and 3d
   1. In the procedure pop-up GUI, click on a bundle and select Alter.
      1. Click the Radar selection box (eeri) to bring up a list of radars. Scroll to find and select the first of the four radars used in step 5 and then click Load. From the Scales menu, select WFO to re-center the bundle over your CWA. Repeat this step for each of the four radars used in step 5.
      2. Click Copy In and Save
      3. Repeat for each bundle.
7. Bundle: 4. FLASH...
   1. Double click on bundle 4. FLASH… to load.
      1. From the Scales menu, select WFO to re-center the bundle over your CWA. Click Copy In and Save.
8. Bundle: 5. Warnings...
   1. For bundle 5. Warnings, you’ll need to build these bundles from scratch following these steps:
      1. Repeat steps 1-13  below for each of your four radars:
         1. Start with a blank CAVE editor. From the Scales menu, select WFO to re-center over your CWA.
         2. Under the Scan menu, choose your radar of choice (kxxx) -> then select FFMP kxxx Table/Basins DPR Display.
         3. Once FFMP finishes loading, right-click and hold on the FFMP legend text and check Editable. Note that the FFMP legend text will now say (Editable).
         4. Right-click and hold again on the FFMP legend text, go to Imaging, and decrease the Brightness to 80%.
         5. Click on the Toggle Image Combination (Insert) button.
         6. Under the MRMS menu, go to FLASH Products, and select CREST Unit Streamflow.
            1. You should now be able to toggle between CREST Unit Streamflow and FFMP by hitting the “period/Delete” key. If not, swap panes on your editor and then try toggling again.
         7. Right-click and hold on the “CREST Unit Streamflow” text legend, go to Change Colormap, click on Colormap options, and make sure the colormap name is “V12-CRESTUnitQ.” If not, under the colormap options, go to SITE -> your WFO -> mrms -> V12-CRESTUnitQ.
         8. Toggle OFF the Toggle Image Combination (Insert) button.
         9. Overlay your local radar reflectivity by going to kxxx menu -> kxxx Z -> 0.5 Z best res.
            1. The “2” key on your keypad should now toggle on and off this reflectivity layer. 
         10. Next, overlay your local flash flood warnings by going to Obs -> Local CWA Flood Warnings.
             1. Right-click and hold on the “Local Flash Flood Warnings” text legend and change Line Width = 2 pixels.
         11. Once finished, change the frame count to 10 by going to Frames -> 10.
         12. Lastly, from the Maps menu, load Cities, County Names, County Warning Areas, and Interstates with the below specifications:
             1. Cities: Color = White; Magnification = 1.5; Density = 0.33
             2. County Names: Color = Yellow; Magnification = 1.25; Density = 1
             3. County Warning Areas: Color = White; Line Style = Dashed; Line Width = 4 pixels
             4. Interstates: Color = Orange Red; Line Style = Solid; Line Width = 2 pixels
         13. Now you are ready to save this bundle. In your new procedures window, Copy In and Save.
             1. Note: The FFMP bundle is designed so you can load Hazard Services on top of it. When Hazard Services is on, it will affect the editability of FFMP. You can change between which tool is "Editable" in one of two ways:
                1. Middle-click on either legend to toggle on/off the editability.
                2. Right-click and hold on either legend and check/uncheck the "Editable" checkbox.
      2. Repeat the above steps for creating FFMP bundles for both HPE and MRMS sources(***NOTE:  HPE and MRMS FFMP sources with not be made for each of the four radars because they are both mosaic products.)
         1. Under SCAN -> choose HPE or MRMS 
         2. Note: If there is no precip in your CWA, then HPE won’t load so you’ll need precip around to make this bundle. 
            Once done, remember to Copy In and Save both your HPE FFMP and MRMS FFMP bundles.

Note: many offices implemented the original FLASH capability using NSSL's instructions that provided FLASH streamflow in metric units and not the cfs values in the latest AWIPS baseline. If you have metric units for streamflow and unit streamflow then remove the /awips2/edex/data/utility/common_static/site/$CWA/grib/tables/161/0/4.2.209.12.table and restart EDEX (where $CWA is your CWA identifier like BOX).

Contact: Michael.Lowe@noaa.gov and Katy.Christian@noaa.gov