WRF Domain Wizard for LAPS

GUI for editing namelist.wps and generating nest7grid.parms (and nests)
Version 2.84 for Linux, AIX, Mac, and Windows - released August 15, 2013


Domain Wizard for LAPS is a graphical user interface (GUI) for editing nest7grid.parms and nests (named nest7grid_d01.parm, nest7grid_d02.parm, etc.). It enables users to easily define and localize domains (cases) by selecting a region of the Earth and choosing a map projection. Users can also define nests using the nests editor.

Source Code is available here.
What's new in the latest version

Run WRF Domain Wizard for LAPS (Download file, Unzip and Run)

Download WRFDomainWizard-LAPS.zip

Simply download the WRF Domain Wizard zip file into a directory of your choosing (e.g. /home/jsmith/WRFDomainWizard) and unzip it. Then run "run_DomainWizard" to launch the program (you will have to do a chmod +x on the file first).

Requirements to run Domain Wizard

  • Minimum: Java 1.5
  • Recommended: Java 1.6 (Java 6) for much better performance
  • 675 MB of RAM (memory) available
  • 1024 x 768 (or better) video display

What's New?

Version 2.84 -Support for HWRF v3.5, updates for Java 7 update 25, fixed bug for NMM domains where nx,ny weren't set correctly after a domain was resized and re-opened.
Version 2.83 -Implemented the new HWRF 3.4 program logic (e.g., 2 nests now instead of 1 nest). fixed bug where setting "io_form_history" had no effect (it always got reset to "2")
fixed bug where loading domain after loading HWRF domain resulted in the screen not displaying new domain (no refresh seemed to occur).
Version 2.82 -Fixed bug where WRF lat-lon regional and global domains were sometimes getting improperly cropped.
Version 2.81 -Fixed bug where map scale wasn't saved correctly for some domains causing a problem when re-loading the domain. Added error check to prevent users from entering their local computer name as an alias for a remote computer. Portal now defaults the date initially displayed in calendar component to the date string in the edit component (if date string exists), otherwise it defaults to current date.
Version 2.80 -Modified the launching of WDW so it now allocates 675 MB of RAM on startup. This fixes the problem where sometimes WDW ran out of memory when rendering certain domains. Fixed WDW bug where, under some conditions, rendering the domain would freeze at 30% complete.
Version 2.75 -Doubled the resolution of world maps (see the difference here).
Version 2.71 -Updated SQL library.
Version 2.70 -improved AIX support, support for running Panoply (NetCDF/GRIB viewer) on Mac computers, improved login window for token (crypto card) based systems, other minor bug fixes
Version 2.50 -fixed WDW Polar Stereographic projection bug over either pole (gridpt distance was set to zero). Improved the precision of grid placement after doing Polar Stereographic projection over either pole. Improved WDW memory management (occasionally some JVMs were running out of stack memory and hanging during a map projection)
Version 2.35 -Fixed bug related to domains straddling the intl date line (180E) -- sometimes user drawn rectangle disappeared and domains weren't centered properly in some cases. Improved accuracy of placement of center of grid on large domains. Improved user friendliness of the login dialog window.
Version 2.31 -fixed bug where changing the geog dir in Domain Wizard Config dialog didn't update existing domains. Improved info messages when running WPS.
Version 2.30 -Added support for Ubuntu. Improved accuracy of HWRF domains, added support for a wider variety of Linux based systems with different shells and configurations. Improved error messages.
Version 2.19 -now defaults the geographic spatial resolution to reasonable value depending on the grid point spacing. Nests now default to the setting of their parent. Fixed glitch where nests weren't 100% centered in parent domain. Also added feature where holding down Ctrl-key while resizing a nest locks the nest in place (a particularly useful feature for NMM domains where you want the nest exactly centered over the parent).
Version 2.14 -Improved File Browser, added support for LAPS
Version 2.01 -Updated 4 namelist.input parameters in the namelist GUI editor
Version 2.00 -Updated to support WRF 3.2, including new namelist.input options in WRF 3.2. Updated to Panoply 2.94--note, existing users of WDW need to delete their /</home/user>/.gissjava directory in order to force a download of the new version of Panoply. But if you don't do this, the old version should continue working just fine. Added Hurricane WRF support. Improved reliability of SSH operations within WDW. Fixed numerous minor bugs.
Version 1.43 -Non LEAD version of WDW-added additional display support files for Panoply viewer (color tables and map overlays)
Version 1.42 -Cosmetic improvements to WDW Horiz Editor. For non-LEAD version of WDW--new version of Panoply NetCDF/GRIB/HDF viewer tool creates Google Earth (.kmz) files! From the Panoply window, choose a field to view in the map window, then go to "File" menu, "Export KMZ As." to export it to a Google Earth .kmz file. You can then load that .kmz file in Google Earth.
Version 1.41 -Namelist.input editor now initializes additional nests correctly when you add a nest to an existing domain
-WDW-centerpt lat/lon controls are now enabled after projection chosen. Also added centerpt lat/lon to Nests table.
-The SSH dialog displays the name of the local computer and adds that computer name to the drop down box (so users can choose it). If the user chooses the local computer name, the username/password boxes are disabled.
-Added Hurricane WRF (HWRF) support for WRF Domain Wizard (still under testing)
Version 1.40 - Added non-linear vertical grid stretcher window to the namelist.input editor screen, other minor improvements to namelist.input editor. Added error checking for invalid parent grid ratios, improved suggested timestep value in namelist.input for NMM domains
Version 1.39 - Fixed bug related to loading NMM domains with multiple nests
Version 1.38 - Added more error checking to namelist.input editor
Version 1.37 - Improved the accuracy of displaying the main grid when standardLon is different than centerPtLon
Version 1.36 - Improved the accuracy of displaying the main grid and nests over the map
Version 1.35 - Fixed bug related to saving namelist.input, add dx-degrees and dy-degrees columns to the nests editor in WDW, minor Mac UI improvements, default computer mistakenly reset when running WDW inside WRF Portal, other minor UI fixes
Version 1.34 - NMM projection bug, visualizing NMM files including nests, set WPS dir button in DW config dialog didn't work in some situations, namelist.input editor didn't set max_dom correctly sometimes, other minor UI fixes
Version 1.33 - Created special version for LEAD project, fixed bug where following namelist.wps parameters were not being saved: ungribOutFormat, ungribPrefix, metgridFgName, metgridIoFormMetgrid
Version 1.32 - Fixed bug where parent_ids weren't being set correctly in namelist.input file
Version 1.31 - Fixed directory name bug (for loading domains) that, apparently, only afflicted Mac users
Version 1.30 - Added GUI editor for namelist.input, fixed NMM projection bugs, improved global domain support, fixed nesting offset bug, increased precision of coordinates by decimal place, improved resolution of thumbnail images, improved Linux support --AIX-Ubuntu-Debian, other minor enhancements
Version 1.25 - higher quality jpegs, error msg and instructions if Panoply download fails due to firewall, minor gui improvements
Version 1.24 - Updated ssh library, new code for loading/saving jpeg images
Version 1.23 - support for WRF 3 namelist.input, WPS 3 "lat-lon" regional and global domains, and visualizing NetCDF files in IDV and Google Earth.

Domain Wizard Help

Our support page

Troubleshooting Tips

If Domain Wizard won't start after you click the "launch" link above, you probably don't have Java installed on your computer. The software requires Java 1.5 or later to be installed on your desktop computer in order to run. Java 6 (or 1.6) is highly recommended for performance reasons. You can download the free Java Runtime Environment (JRE) here. Just download the JRE, install it, and then click the "launch" link (above) again.

If Java is installed on your desktop computer and yet the "launch" link still doesn't work, then Java Web Start isn't configured correctly on your computer's web browser. Here are instructionson how setup *.jnlp association for Java Web Start in various web browsers .

If you are running Mac OS-X (version 10.3.1 or later), Java Web Start is already installed. Most versions of Linux also have Java installed (although Web Start might not be configured correctly). For more information on configuring/installing Java Web Start, go here.

To understand if the gridgen.exe executable is working correctly, you can run gridgen.exe from the command line after you 'cd' into the domain directory containing your namelist.wps. Helpful information, on the success or failure of running gridgen.exe, should be written at the command line prompt.

Domain Wizard stores configuration information (but no passwords) in a file called DomainWizard.cfg in your home directory. On Linux systems, your home directory is usually in a directory called /home/jsmith or /usr/home/jsmith (assuming your user name is jsmith). On Windows XP systems, your home directory would be something like C:\Documents and Settings\jsmith (assuming your username is jsmith). If this file becomes corrupted, you can just delete it and the software will re-generate it.