Previous: GEMPAK Mapping Programs Next: GEMPAK Mapping Programs: SNMAP & GDMAP Table of contents Frames User Manual GEMPAK Online Tutorial > GEMPAK Mapping Programs

3.1.1| GEMPAK Mapping Programs: SFMAP

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:





AREA determines the data area, while GAREA determines the graphics area (see below)







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:

PROJ = NPS

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:

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).






DEVICE specifies the device driver.

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.





CLEAR

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.

The screen will not clear if you exit GEMPAK and start it again due to the multiple process design of the program. For now we will keep
CLEAR=YES
but look at overlays later.




Map Aesthetics
COLORS, MAP, LATLON, TITLE, PANEL, FILTER and TEXT control the graphic colors, line thickness, style, text fonts and titles. These map aesthetics allow you to generate very specific graphics. Early on in your use of GEMPAK you'll want to slowly change the default values to see how you can customize the graphics.

These and many other attributes are covered in 5.1 Map Aesthetics

Exercise: 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

Help: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.



3.1.2| SNMAP

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                                               
Enter  to accept parameters or type EXIT:

Look okay? Let's save this:

 GEMPAK-SNMAP>save sn.nts
3.1.3| GDMAP

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.


3.1.4| Mapping Exercises

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:

Exercises:

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 Answer:. 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.






$MAPFIL defines a map file to be used

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

Exercises:Exercise: Plot a chart over North America, using a coastal boundary map.

  1. Use 1200 UTC surface data from this morning.
  2. Choose a low resolution coastal boundary map:
    $MAPFIL=LOCONH.GSF
    
  3. Plot sky cover, temperature, and dew point: Put SKYC in position 1, TMPC in position 2 and DWPT in position 7:
    SFPARM=skyc;tmpc;blnk;blnk;blnk;blnk;dwpc
    
    or
    SFPARM=barb;tmpc;;;;;dwpc
    
  4. Use full map projection (Remember, you can't abbreviate with a non-standard area)
    PROJ=STR/90;-100;0
    
  5. AREA and GAREA set for North America:
    AREA=dset
    GAREA=10;-125;50;-20
    
  6. Date/time (abbreviation):
    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   
 
 Enter  to accept parameters or type EXIT:
Don't use the window manager to get rid of the XWindow graphic. Either iconify the window for use later, or run GPEND

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?

map

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;-20                                                          
Pretty simple, huh? Whenever I want to draw a graph of North America, all I do is:
GEMPAK-SFMAP> restore $GEMPAKHOME/defaults/namerica.nts

warning:Before you move on, be sure to set the $MAPFIL back to the default!!!

GEMPAK-SFMAP>$MAPFIL=MEPOWO.GSF
GEMPAK-SFMAP>e
Next: 3.1.2 SNMAP

 


Previous: GEMPAK Mapping Programs Next: GEMPAK Mapping Programs: SNMAP & GDMAP Table of contents Frames User Manual GEMPAK Online Tutorial > GEMPAK Mapping Programs