AWIPS Tips: Creating a User Override

AWIPS Tips

Welcome back to AWIPS Tips!

Is there a configuration that you want changed, but not affect others? In this blog, we’ll show an example of how you can create a user configuration override. In this example, we are going to change the displayed units for Wind Speed Arrows from knots to mph.

We will start by opening up the localization perspective in CAVE > Perspective > Localization. This should remove your D2D (map) perspective and now show file navigation on the left hand side.

Open up D2D > Style Rules > d2dArrowStyleRules.xml

NOTE: Depending on if you are trying to change contours vs images vs arrows, you’ll have to select the correct styleRule to edit.

You’ll see there’s probably just a BASE file listed there. Remember from the last blog, users shouldn’t (and can’t) edit the BASE file, so you’ll need to create a user override.

Right click on BASE and select Copy To > User. You should now see a new file appear as USER with your username@computer.

Double click on that file, and it should open up the file in the center of your screen. You can tell which version (BASE or USER) of the file you are editing by looking at the tab on the top.

Localization Perspective

NOTE: If you are not seeing what looks like an xml file, in the bottom left click the source tab


Source

Look through the file to find the variable you are looking for (sometimes they may be abbreviated). Here we’re looking for “Wind” and “Gust”. You should see the styleRule tag for this around line 127.


Localization Perspective Wind properties

We can then change the displayUnits from kts to mph.

As a best practice, since this is the only styleRule we want to change, we should remove the rest of the styleRules in this file. If you recall, as a user override file, this will override ALL changes in BASE (and SITE), so if the base file gets updated for another parameter we won’t see that change. This type of CAVE configuration file is an incremental override file, indicating that the files at different localization levels will be combined (as stated in the xml comments at the beginning of the file).

Once you have saved your changes, switch back to the D2D perspective, clear your map, and reload the data (Models > GFS 20km > Sfc Temperature and Wind). You should see that your wind arrows are now displaying in mph without having to restart CAVE!

Wind Arrows mph

Check back in two weeks for the next blog post, where we’ll look into regional obs surface plots in python-awips.


To view archived blogs, visit the AWIPS Tips blog tag, and get notified of the latest updates from the AWIPS team by signing up for the AWIPS mailing list. Questions or suggestions for the team on future topics? Let us know at support-awips@unidata.ucar.edu

Comments:

Post a Comment:
  • HTML Syntax: Allowed
News@Unidata
News and information from the Unidata Program Center
News@Unidata
News and information from the Unidata Program Center

Welcome

FAQs

Developers’ blog

Recent Entries:
Take a poll!

What if we had an ongoing user poll in here?

Browse By Topic
Browse by Topic
« November 2022
SunMonTueWedThuFriSat
  
3
4
5
6
7
8
9
10
11
12
13
14
15
17
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today