Your first experience with the GEMPAK user interface will be with the program SFMAP
SFMAP plots any parameters which can be derived from the data in a GEMPAK surface data file.
% sfmap Creating process: gplt for queue 9601026 AREA Data area WV GAREA Graphics area WV SATFIL Satellite image filename(s) RADFIL Radar image filename(s) IMCBAR Color/ornt/anch/x;y/ln;wd/freq SFPARM Surface parameter list SKYC;TMPF;WSYM;PMSL;;DWPF;BRBK DATTIM Date/time LAST SFFILE Surface data file $GEMPAK/data/hrcbob.sfc COLORS Color list 1 MAP Map color/dash/width/filter flag 1 MSCALE fgc;bgc;mask/units/lat;hide/valu 0 LATLON Line color/dash/width/freq/inc/l TITLE Title color/line/title 1 CLEAR Clear screen flag YES PANEL Panel loc/color/dash/width/regn 0 DEVICE Device|name|x size;y size|color XW PROJ Map projection/angles/margins|dr MER FILTER Filter data factor YES TEXT Size/fnt/wdth/brdr/N-rot/just/hw 1 LUTFIL Enhancement lookup table filenam STNPLT Txtc/txt attr|marker attr|stnfil CLRBAR Color/ornt/anch/x;y/ln;wd/freq|t LSTPRM Filtered parm|x;y|TEXT info Parameters requested: AREA,GAREA,SATFIL,RADFIL,IMCBAR,SFPARM,DATTIM,SFFILE, COLORS,MAP,MSCALE,LATLON,TITLE,CLEAR,PANEL,DEVICE,PROJ,FILTER,TEXT,LUTFIL, STNPLT,CLRBAR,LSTPRM. GEMPAK-SFMAP>
I prefer the look of a list or l:
GEMPAK-SFMAP>l AREA = WV GAREA = WV SATFIL = RADFIL = IMCBAR = SFPARM = SKYC;TMPF;WSYM;PMSL;;DWPF;BRBK DATTIM = LAST SFFILE = $GEMPAK/data/hrcbob.sfc COLORS = 1 MAP = 1 MSCALE = 0 LATLON = TITLE = 1 CLEAR = YES PANEL = 0 DEVICE = XW PROJ = MER FILTER = YES TEXT = 1 LUTFIL = STNPLT = CLRBAR = LSTPRM = GEMPAK-SFMAP>
What are looking at? HRCBOB.SFC? WV?
These are the program defaults and allow us to list/plot data immediately when starting to use GEMPAK.
Try it with run or r:
GEMPAK-SFMAP>r Creating process: xw for queue 9797635 SFMAP PARAMETERS: Data area: WV Graphics area name: WV Valid parameters: SKYC TMPF WSYM PMSL BLNK DWPF BRBK Parameter colors: 1 1 1 1 0 1 1 Time: 910820/0600 File: $GEMPAK/data/hrcbob.sfc Map: 1 Title: 1 Device: XW Projection: MER Clear screen: YES Filter: YES Filter factor: 1.00 Panel: 0 Enter <cr> to accept parameters or type EXIT:
Press <enter> once more to display the map:
By default, surface obs from "Hurricane Bob" in 1991 are displayed, centered around West Virginia. At this point we are going to use a shortcut for real-time metar observations:
> SFFILE = metar
What happens now when you re-display the map?
What if we change other variables, such as DATTIM, AREA and GAREA?
DATTIM is date and time, formatted in a number of ways:
DATTIM = 101025/1200 GEMPAK will look for observations
from YYMMDD/HHMM
DATTIM = 25/1200 GEMPAK will look for observations
from the last available date and
DATTIM = 25/12 time specified in the formats:
DD/HHMM
DATTIM = /1200 DD/HH
/HHMM
DATTIM = /12 /HH
DATTIM = 17/00-17/1200 All available observations between
the two date/time ranges
DATTIM = 17/00;17/06;17/12 All available observations that
match the exact date/times listed
DATTIM = list Lists all the times in the file.
Useful for when you don`t know
the times when the data was
collected. GEMPAK lets you choose
from the list of times.
DATTIM = last GEMPAK uses the data from the
last date/time in the file.
DATTIM = all GEMPAK uses the data from every
date/time in the file. Useful for
comprehensive analyses.
AREA determines the data area, while GAREA determines the graphics area (see below)
AREA = 25;-125;50;-65 Defines the corners
[ Lat 1; Lon 1; Lat 2; Lon 2 ]
of the form [ LL (1); UR (2) ]
Be aware that South and West are negative!
AREA = #37.5;-95;12.5;30 In the form:
[ #Center lat; Center lon;
Delta lat; Delta lon ]
AREA = US AREA is defined as the region
around the United States.
AREA = CO AREA is defined as the region
around Colorado.
AREA = LAX AREA is defined as the region
around Los Angeles.
AREA = DSET AREA is defined as all stations
in the file.
AREA = CO Colorado (May include information from
neighboring states)
AREA = @CO Only information inside Colorado
AREA = @DEN Only Denver Station
AREA = MX Mexico
AREA = @AU:C Australia (use :C syntac for countries
other than US, CN and MX)
AREA = @DEN;LAX;PDX Denver, LA and Portland stations
only
AREA = CO+ AREA is contracted around CO
AREA = CO++ AREA is contracted further around CO
AREA = CO- AREA is expanded beyond CO
AREA = @CO-- AREA is expanded even more, but only includes
information inside Colorado
AREA = SELV:0:2000 Selects stations with elevations
between 0 and 2000 meters
AREA = SLAT:-45:45 Selects stations located between 45
degrees south and 45 north
AREA = SLON:-45:45 Between 45 west and 45 east
Any station information can be used in this way: STID (Station
ID-letters), STNM (Station Number), SLAT (Station Lat), SLON (Station
Lon), STIM (Station Report Time).
So, what's the
difference between the GAREA and AREA?
GAREA is the graphics area: the
part of the map that will be plotted. AREA is the data area: the area from which to select the data to plot.
These areas exist separately for when you might want individual control over both the region of the map that is plotted (viewed) and the region that is covered by data.
Tip: If you want to plot a map with complete data coverage, including the edges, you should make AREA bigger than GAREA. This can be done by adding a minus - to AREA or a plus + to GAREA:
GEMPAK-SFMAP> AREA = CO- GEMPAK-SFMAP> GAREA = CO GEMPAK-SFMAP> r
GAREA can be specified in some of the same ways as AREA, with one caveat:
You cannot use the
@ symbol to specify GAREA! Because GAREA defines the boundaries of the graph, adding @ would force an irregular boundary. Think of the @ sign as a way to restrict the selection of data.PROJ determines the map projection
The map projection directly affects the way the map looks on the screen, and can be specified as a simple map projection or as a full map projection, which requires a set of angles.

PROJ and GAREA together give you the flexibility to generate very specific map projections.
Let's look at ph proj for guidance with simple map projections
GEMPAK-SFMAP>ph proj
The following simple map projections may be specified:
MER Mercator
NPS North Polar Stereographic
SPS South Polar Stereographic
LCC Northern Hemisphere Lambert Conic Conformal
SCC Southern Hemisphere Lambert Conic Conformal
CED Cylindrical Equidistant
MCD Modified Cylindrical Equidistant
UTM Universal Transverse Mercator
NOR North Orthographic
SOR South Orthographic
...
GEMPAK comes equiped with these simple map projections that will work with standard graphical areas (mostly over the US). Simply define PROJ:
Notice further down in ph proj the specifics of full map projections:
The following full map projections may also be specified:
MER (CYL) Mercator
MCD (CYL) Modified Cylindrical Equidistant
STR (AZM) Polar Stereographic
In addition, three angles MUST be specified in PROJ. The angles
have the following meanings for the different projection classes:
CYL The angles are not used. A default value for angle2,
polon is used
AZM angle1 -- latitude of the projection's point of tangency
angle2 -- longitude of the projection's point of tangency
angle3 -- not used
For stereographic STR and azimuthal AZM projections, angle1 is the standard latitude through which the projection plane passes and angle2 is the central longitude (i.e. the longitude that lies parallel to the grid columns). These azimuthal projections require you to specify these two angles, and because angle3 isn't used, GEMPAK expects 0.
Tip: For a good view of North America use:
GEMPAK-SFMAP>PROJ = STR/90;-100;0 GEMPAK-SFMAP>r
A quick shortcut for a similar simple map projection would be NPS. This shortcut simply points to a defined full map projection STR/90;-90;0. It looks good over the US, but it won't work well for viewing Africa - for that you'll need to use a different full map projection (this is true of all simple map projections).
The following device drivers are currently supported by GEMPAK:
XW : X windows are the most common format for displaying
graphics on workstations. The user has the ability
to design displays that can be viewed locally or to
any other display console which provides display
access to the computer initiating the output (as a
result, distributed processing of data sets is
possible).
PS : Postscript output can be used for hardcopy devices.
This ensures the graphics are independent of the
resolution of the hardware which generates the image.
The resolution of the image can thus be determined
by a printer or other output device.
GF : GIF images: a widely accepted standard
with efficient compression. GIF images are raster data,
so are limited by the resolution of the hardware used.
GIF : While the GF driver utilizes the X display, GIF provides
allows all fonts to be rendered in software.
NC : NTRANS CGM driver for creating META files for use
with the NTRANS viewing Software.
VG : Vector Graphics (N-AWIPS Product Generation)
TIFF : TIFF file
RBK : AWIPS RedBook Graphics
Tip: The default device driver is set to X-Windows DEVICE = XW, which will open windows on your screen.The XW device is capable of dumping the contents of the current frame to a GIF file by using the GSAVE [NAME] command at the GEMPAK prompt.When GEMPAK draws a new map or graph to the X-Window (also for GIF), clearing the screen is an option. CLEAR = YES will erase whatever has been previously draw to the x-window, and the new graphic is drawn on a blank screen. CLEAR=NO ensures that the screen is not cleared, allowing you to overlay fields.
CLEAR=YESbut look at overlays later.
These and many other attributes are covered in 5.1 Map Aesthetics
Exercise!
Plot a standard surface chart for CO area for this morning (1200 UTC).
The parameter's position in SFPARM corresponds to placement around station (except for wind barbs which are always centered on the station)...
For Example if:
sfparm = skyc; tmpf; wsym; rmsl; ; dwpf
The parameter's position (SKYC : 1, TMPF : 2, WSYM : 3, RMSL : 4, DWPF : 6 ) will correspond to the chart position:
18 14 8 16 22
19 2 10 4 23
12 3 1 5 13
20 6 11 7 24
21 15 9 17 25
Why in that order? To corresponed to the standard ordering of data on a surface chart:
The GEMPAK four letter SFPARM abbreviations would therefore be:
TMPF RMSL
WSYM SKYC PTND
DWPF &BRBK
Does the default file already set for a standard surface chart? Let's find out:
GEMPAK-SFMAP>restore $GEMPAK/defaults/sfmap.nts GEMPAK-SFMAP>l AREA = GAREA = SFPARM = skyc;tmpf;wsym;rmsl;pt03;dwpf;p03i; brbk:.7:2 DATTIM = SFFILE = COLORS = 1;2;3;25;5;6;7;9 MAP = 3/1/2 LATLON = 0 TITLE = 1/-2 CLEAR = YES PANEL = 0 DEVICE = xw PROJ = nps FILTER = yes TEXT = 1.3/23//HW SKPMIS = no GEMPAK-SFMAP>
Now simply define the area, date/time and file:
GEMPAK-SFMAP>AREA = CO- GEMPAK-SFMAP>GAREA = CO GEMPAK-SFMAP>DATTIM = /1200 GEMPAK-SFMAP>SFFILE = metar GEMPAK-SFMAP>r
Look okay? Save your output:
GEMPAK-SFMAP>save sf.nts
we'll use it again soon.
SNMAP plots any parameters which can be derived from the data in a GEMPAK sounding data file for specified levels and vertical coordinate.
SNMAP runs similarly to SFMAP. The only fundamental difference is that SNMAP will map sounding (upper air) data instead of surface data. As a result, you must define the level GLEVEL and vertical coordinate GVCORD on which to map the data.
Plot an upper air chart for the US at 500 mb at 1200 UTC this morning:
% snmap GEMPAK-SNMAP> AREA Data area CO- GAREA Graphics area CO SNPARM Sounding parameter list skyc;tmpf;wsym;rmsl;ptnd;dwpf;p03i;brbk:.7:2 DATTIM Date/time /1200 LEVELS Vertical levels VCOORD Vertical coordinate type SNFILE Sounding data file COLORS Color list 1;2;3;25;5;6;7;9 MAP Map color/dash/width 3/1/1 LATLON Line color/dash/width/label/inc 0 MARKER Marker color/type/size/width/hw 0 TITLE Title color/line/title 1/-2 CLEAR Clear screen flag YES PANEL Panel location/color/dash/width 0 DEVICE Graphics device xw PROJ Map projection/angles/margins nps FILTER Filter data factor no TEXT Text size/font/width/hw flag 1.3/23//HW GEMPAK-SNMAP>
Notice area and date/time remain the same from SFMAP, inherited from last.nts.
GEMPAK-SNMAP>area = us GEMPAK-SNMAP>garea = us GEMPAK-SNMAP>snfile = ua GEMPAK-SNMAP>levels = 500 GEMPAK-SNMAP>vcoord = pres GEMPAK-SNMAP>r vparm is PRES SNMAP PARAMETERS: Data area: us Graphics area name: us Valid parameters: BRBK TMPC BLNK HGTD BLNK DWPC Parameter colors: 1 2 0 3 0 25 Time: 101025/1200 Level: 500 Vert coord: PRES File: ua Map: 3/1/1 Marker: 0 Title: 1/-2 Device: xw Projection: nps Clear screen: YES Filter: YES Filter factor: 0.70 Panel: 0 Enterto accept parameters or type EXIT:

Look okay? Let's save this:
GEMPAK-SNMAP>save sn.nts
GDMAP is very similar to SFMAP and SNMAP. The only fundamental difference is that GDMAP will plot gridded data points on a map. Usually, however, we use contours, streamlines, or vectors to view gridded data, so this program is of limited use. We'll discuss the new variables unique to grid programs in the Grid Programs section. Consult the on-line help file, or the User's Manual for information on how to use this program.
In this chapter, we have learned how to plot data on maps. In general, these programs are more heavily used than listing programs, which we will cover in the next chapter.
Both the maping and listing programs run in the same general way. The variables are the same or are analogous, and both can represent the three types of data.Listing programs provide textual representation of the data; mapping programs provide a mapped representation. The next chapter will provide a third representation of data--graphs.
After working through this chapter, you should now be familiar with:
Before moving on to the next chapter, test your GEMPAK skill by working
through the Mapping Program Exercises.
After each question, there will be a answer window
.
Work through the exercise, and then check your results against the answers.
The next chapter discusses graphing programs. These programs are used to represent data without the geo-referencing. Examples include meteograms and Skew T-Log P plots. Cross section programs are also included in this category.
You won't find this variable on any user interface, it is a hidden variable.
The default map is a medium-resolution political boundary map of the world. Alternate maps, such as lakes, rivers and more detailed political boundaries, can be called using $MAPFIL.
The higher the resolution of the map, the longer it takes to draw.
For global maps, low resolution is fine. For small scale maps, high resolution can make an impressive graphic.
GEMPAK can "remember" the last map file used. The default is HIPOWO.CIA
Exercise: Plot a chart over North America, using a coastal boundary map.
$MAPFIL=LOCONH.GSF
SFPARM=skyc;tmpc;blnk;blnk;blnk;blnk;dwpcor
SFPARM=barb;tmpc;;;;;dwpc
PROJ=STR/90;-100;0
AREA=dset GAREA=10;-125;50;-20
DATTIM=/1200
Remember to list or l to check your defintiions. Now run it:
GEMPAK-SFMAP>r SFMAP PARAMETERS: GEMPAK-SFMAP>r Creating process: xw for queue 9928711 SFMAP PARAMETERS: Data area: dset Graphics area name: 10;-125;50;-20 Valid parameters: BRBM TMPC BLNK BLNK BLNK BLNK DWPC Parameter colors: 1 2 0 0 0 0 3 Time: 101014/1200 File: $GEMDATA/surface/20101014_sao.gem Map: 3/1/2 Title: 1/-2 Device: XW Projection: STR/90;-100;0 Clear screen: YES Filter: YES Filter factor: 1.00 Panel: 0 Enterto accept parameters or type EXIT:
Great, now if you think that that isn't much data you can adjust the filter to 0.7 and see the difference.
And one more thing, what would you have seen if you left
PROJ set to NPS as it was in the defaults files sfmap.nts?
Not so great, eh? If you often like to look at North American plots, you
may want to keep the PROJ and GAREA settings we just used in their own defaults
file. (I do!) Here's a copy of my file namerica.nts:
PROJ str/+90;-100;0/0;3;0;2 GAREA 10;-125;50;-20Pretty simple, huh? Whenever I want to draw a graph of North America, all I do is:
GEMPAK-SFMAP> restore $GEMPAKHOME/defaults/namerica.nts
Before you move on, be sure to set the $MAPFIL back to the default!!!
GEMPAK-SFMAP>$MAPFIL=MEPOWO.GSF GEMPAK-SFMAP>e