1. Where can I download WRFSI GUI
2. Is it necessary to use the GUI to run WRFSI?
3. How do I run the GUI?
4. How can I test if Perl/Tk is available on my system?
5. How do I install Perl/Tk on my system?
6. What environment variable do I set to run Perl/Tk?
7. What is the difference between PERL5OPT and PERL5LIB?
8. What does error "Can't locate Tie/Watch.pm or Trace.pm" mean?
9. Can I run X-displays on FSL'S ijet?
10. Can Perl/Tk be installed on FSL's ijet, and jet.
11. What does error "couldn't find an appropriate visual" mean? (v1.3.1 only)
12. On a Linux system using Perl 5.8.0, the GUI crashes during the localization step. Why? (v1.3.2 only)
13. How do I create a custom map background file for use with the WRF SI GUI?
14. What's wrong when the WRF SI GUI does not show any map background vectors?
15. What version of Perl/Tk is recommended for use with the WRFSI GUI v2.0.1?
16. What can I do about the WRFSI GUI exiting on error: X_GetImage?
17. My Makefile fails when building Perl/Tk on RedHat. Any suggestions?
18. What is the fix for gen_map_bkgnd.exe on the Compaq (Tru64 V5.0A alpha)?

Where can I download WRFSI GUI?

WRFSI software release.

Is it necessary to use the GUI to run WRFSI?

No, but the GUI was developed to make running WRFSI easier and a more efficient method to manipulate the software and modify files.

How do I run the GUI?

Upon a successful installation of the GUI a script called INSTALLROOT/wrf_tools is created. Run this script to start the GUI.

Any error messages from the application will be written to /tmp/wrf_tools.log. Look there for further information.

How can I test if Perl/Tk is available on my system?

At the command line, run:
perl -e 'use Tk'

if this is successful the Perl Tk module library is available. Otherwise, there is a need to build this library. To determine which version of Perl/Tk is available and where it is located type:

perl -e 'use Tk; print "\to This is Perl/Tk, version $Tk::VERSION installed in library $Tk::library\n"'

How do I install Perl/Tk on my system?

It is recommended that your system administrator install Perl/Tk. But the wrfsi install script (SOURCE_ROOT/install_wrfsi.pl) can also build Perl/Tk.

The wrfsi install script prompts "Do you want to install the WRF SI GUI?".
If your response is 'Yes' AND Perl/Tk is not found, then the gui install script (SOURCE_ROOT/gui/install_gui.pl), will also run the PerlTk install script (SOURCE_ROOT/gui/install_perlTk.sh) to install Perl/Tk module library in SOURCE_ROOT/gui/.

What environment variable do I set to run Perl/Tk?

Typically none. If Perl/Tk has been installed and is available on your system there is no need to set any PERL env vars. Otherwise, the script called INSTALLROOT/wrf_tools should take care of setting the PERL5LIB env at runtime. For additional information,

If a system administrator built a site_perl Tk module (and it is not found by Perl) then set PERL5LIB to that location. For example:

setenv PERL5LIB /usr/opt/perl5/lib/site_perl
or
setenv PERL5LIB /usr/local/Tk800.025

Then, test for the success of Tk with the command: perl -e 'use Tk'


If a user builds Perl/Tk, set a PERL env to locate the Tk module. (Remember that INSTALLROOT/wrf_tools does this automatically.) For example:

setenv PERL5LIB -I$INSTALLROOT/gui/perlTk/lib (Tk800.025 or higher)
or
setenv PERL5OPT -Mblib=$INSTALLROOT/gui/perlTk/blib (Tk800.023)

Then, test it with: perl -e 'use Tk'.

(Which is similar to both the following:
perl -I/usr/local/Tk800.025/lib -e 'use Tk'
perl -e -Mblib=/usr/local/Tk800.023/blib 'use Tk')

What is the difference between PERL5LIB and PERL5OPT?

PERL5LIB

A colon-separated list of directories in which to look for Perl library files before looking in the standard library and the current directory. Any architecture-specific directories under the specified locations are automatically included if they exist. If PERL5LIB is not defined, PERLLIB is used.

When running taint checks (either because the program was running setuid or setgid, or the -T switch was used), neither variable is used. The program should instead say:

use lib "/my/directory";

PERL5OPT

Command-line options (switches). Switches in this variable are taken as if they were on every Perl command line. Only the -[DIMUdmw] switches are allowed. When running taint checks (because the program was running setuid or setgid, or the -T switch was used), this variable is ignored. If PERL5OPT begins with -T, tainting will be enabled, and any subsequent options ignored.

What does error "Can't locate Tie/Watch.pm or Trace.pm" mean?

This indicates that some Perl modules are not found. Either they are missing, or not in your Perl Library path (i.e. @INC). Trace.pm is in found in Perl/Tk 800.023 (or higher). Watch.pm is Perl Tie module that places watch points on Perl variables.

Can I run X-displays on FSL'S ijet?

Use -X for graphical applications. This should only be accessed from a workstation to avoid unnecessary network hops that would impact the display performance.
ssh -X ijet

The jet visualization server is jet-vis, it is a random connection to 1 of 4 hosts. To connect

ssh -X jet-vis

There shouldn't be a reason to directly connect to any other nodes in the cluster since they are accessed via the job queuing system.

Can Perl/Tk be installed on FSL's ijet, and jet.

Yes, hpcshelp.fsl@noaa.gov is providing visualization services on a host named jet-vis that can be used for this application. jet-vis mounts the same file systems as ijet (home and project directories) and has full installs of X, perl-Tk, idl, ncar graphics etc. ijet users can login to jet-vis from workstations with
ssh -X jet-vis

and X will be tunneled through ssh. After generating the config file with your application the user will need to submit the job from ijet.

The decision has been made to not support graphics on the clusters. If you need something else graphical related installed on jet-vis please let hpcshelp know at hpcshelp.fsl@noaa.gov.

What does error "couldn't find an appropriate visual" mean? (v1.3.1 only)

Your system does not have the visual 'TrueColor' and the GUI code requests this specifically. So, the solution is to edit a line of code to delete the request for 'truecolor' thus accepting your system's default X server color scheme.

Edit both SOURCE_ROOT/gui/guiTk/ui_system_tools.pl.in and INSTALLROOT/gui/guiTk/ui_system_tools.pl

Change the two lines (138,139) from

$splash = $mw->Toplevel(-title => "Loading...", -visual => 'truecolor');

To:

$splash = $mw->Toplevel(-title => "Loading...");

This removes any reference to visuals.

(Further, to find out which visuals you have available run 'xdpyinfo', a standard system utility to display information about your systems X server.

xdpyinfo | grep Color

The color scheme must be best, directcolor, grayscale, greyscale, pseudocolor, staticcolor, staticgray, staticgrey, truecolor, or default. I chose one that is not available to your system.)

On a Linux system using Perl 5.8.0 with Tk800.023, the GUI crashes during the localization step. Why? (v1.3.2 only)

It was assumed that this was a wide spread problem with Perl version 5.8.0 but it is not.

The fatal error with the WRF SI GUI during the domain localization step has been isolated to Linux OS systems using Perl version 5.8.0 in combination with Tk800.023. The problem can be corrected using Perl 5.8.0, or higher, and a newer version of Perl/Tk, Tk800.025, found at http://www.cpan.org/authors/id/NI-S

To build Perl/Tk800.025 using wrfsi scripts, do the following.

Cd to $SOURCE_ROOT/wrfsi/gui
Download Tk-800.025.tar.gz to the directory $SOURCE_ROOT/wrfsi/gui
Edit $SOURCE_ROOT/wrfsi/gui/install_perlTk.sh
Change every occurrence of Tk800.023 to Tk800.025
Run $SOURCE_ROOT/wrfsi/gui/install_perlTk.sh 1> perlTk_install.log 2>&1

How do I create a custom map background file for use with the WRF SI GUI?

The gui creates background maps by reading in vector lat/lon coordinates then drawing map vector lines. The binary cartographic data (.bcd) contains vector data lat/lon coordinates created from ARCINFO shape files. We currently get our shape files from: http://www.nws.noaa.gov/geodata . The software to convert shape files to bcd files originates from the NWS AWIPS mapping routines. Download the WRF SI GUI map conversion software from: http://wrf-model.org/gui/map .

What's wrong when the WRF SI GUI does not show any map background vectors?

Unless your domain is located over a large body of water, this is a big-endian/little-endian issue. To correct this, please edit the makefile include file called INSTALLROOT/gui/src/makefile.inc. Change value for BYTEFLAG.

Contents of INSTALLROOT/gui/src/makefile.inc:

# Include file used by the INSTALLROOT/gui/src/Makefile
#
# If env var MACHTYPE does not contain Intel i386, i686, or
# Alpha (little endian architecture) use -DBYTE_SWAP, otherwise
# (big endian architecture), so use null value for BYTEFLAG.
# BYTEFLAG = -DBYTE_SWAP
#
BYTEFLAG =

What version of Perl/Tk is recommended for use with the WRFSI GUI v2.0.1?

The recommended version of Perl/Tk depends on the installed version of Perl. We have found that Perl 5.8.1 (and lower Perl version numbers) work well with Perl/Tk versions 800.025, 804.026 and 804.027.

When the newest versions of Perl/Tk, namely, Tk804.026 and Tk804.027 (available at CPAN) are paired with older versions of Perl (5.8.1) one, or both, of the following problems are introduced:


When trying to create a domain over the SE US, etc, the domain that appears on the screen is not the same as the one requested. In addition, the hourglass continues to spin suggesting that there is a problem. Sometimes the map background is only partially drawn.
Tk::Error: wrong # coordinates: expected at least 4, got 2 at /usr/lib/perl5/site_perl/5.8.0/i386-linux-thread-multi/$

This is a known incompatibility between Tk800 and Tk804. What looks like a WRFSI GUI issue is rather a issue resulting from upgrades to Perl/Tk. There are two solutions: 1) update the WRFSI GUI as instructed below, or 2) pair your version of Perl with Perl/Tk version 800.025. Note: The WRFSI GUI verson 2.0.3 (soon to be released) should correct this issue for use with all Perl/Tk version.

Solution 1)


a) Edit SOURCE_ROOT/gui/guiTk/ui_domain_srt.pl (or download ui_domain_srt.plx) and then copy this to INSTALLROOT/gui/guiTk/ui_domain_srt.pl


Change lines 788-790:
@_=$domain_lb->info('selection');
if($_[0] eq "") { return(1); } #If empty, timing prob.
$domain_select=$_[0];

b) Edit SOURCE_ROOT/src/create_bcd_bkgnd_xy.c (or download) and recompile by typing 'make install'.


Change line 102:

if (npts<4) return;



Or, Solution 2) use Perl/Tk version 800.025

What can I do about the WRFSI GUI exiting on error: X_GetImage?

When using the WRFS GUI to accomplish the task of defining a domain several system actions occur behind the scene as buttons are pressed. Specifically, when advancing to the Vertical Editor panel by pressing Next (or via the panel's tab), a screen captured picture is taken of the horizontal domain and written to a gif file (located in $TEMPLATES/"domain_name"/domain.gif). This happens just prior to presenting the Vertical Editor panel. However, if the application exits on this step with the following error message:
X Error of failed request: BadMatch (invalid parameter attributes)
Major opcode of failed request: 73 (X_GetImage)
Serial number of failed request: 78557
Current serial number in output stream: 78557


The error messages indicate a failure to create a gif image of your domain. This happens on just a few systems. The problem has not been isolated to a specific platform OS at this time. Until we have another solution, please omit this step of capturing an image by editing the software as indicated.

Edit the file $INSTALLROOT/gui/guiTk/ui_vars.pl At line 1363 (just after entering subroutine write_domain_image) add the line:

return; # Skip the step of creating a gif image.

and, run the application, as compiling is not necessary.

My Makefile fails when building Perl/Tk on RedHat. Any suggestions?

This is known as the "Red Hat UTF8 bug". Before you run the perl Makefile.PL, set your environment variable LANG=en_US, e.g.: export LANG=en_US. The default value for LANG is en_US.utf8, which breaks perl.

Make that change, and it'll work for you. Be sure to clean up the legacy files, by:


rm -rf wrfsi/gui/Tk800.025/ AND wrfsi/gui/perlTk/


and, run:


perl install_gui.pl --source_root=path --installroot=path

What is the fix for gen_map_bkgnd.exe on the Compaq (Tru64 V5.0A alpha)?

To fix INSTALLROOT/gui/bin/gen_map_bkgnd.exe

a) 'cd INSTALLROOT/gui/src'
b) edit location_lines.c
c) delete lines 78-81:

x=(x_min+x_max)/2;
y=(y_min+y_max)/2;
xy_to_ll(&x,&y, &half_lat,&half_lon, my_proj);

d) type 'make install'

Last updated: Mon 31 Jan 2005