GEMPAK Manual | Programs

GDPLOT draws contour lines through scalar grids and/or wind
       barbs or arrows through vector grids.  Multiple sets
       of contours and vectors can be generated for each
       frame.

INPUT PARAMETERS
 
    GDFILE    Grid file
    GDATTIM   Grid date/time
    GLEVEL    Grid level
    GVCORD    Grid vertical coordinate
    PANEL     Panel loc/color/dash/width/regn
    SKIP      Skip_cntr/skip_plt_x;skip_plt_y
    SCALE     Scalar scale / vector scale
    GFUNC     Scalar grid
    CTYPE     Contour type:  C/F
    CONTUR    Subbox/smooth
    CINT      Contour interval/min/max
    LINE      Color/type/width/label/smth/fltr/scflg
    FINT      Fill interval/min/max
    FLINE     Fill colors/fill types
    HILO      Color/symbol/rng/rad/cnt/intp
    HLSYM     HILO txt size/posn/font/wdth/hw
    CLRBAR    Color/ornt/anch/x;y/ln;wd/freq|text_info
    GVECT     Vector grid
    WIND      Wind symbol/siz/wdth/typ/hdsz
    REFVEC    Mag;x;y;txtsiz/font/wdth/HW;labl
    TITLE     Title color/line/title
    TEXT      Size/fnt/wdth/brdr/N-rot/just/hw flg
    CLEAR     Clear screen flag
    GAREA     Graphics area
    IJSKIP    Iskp;Istrt;Istp/Jskp;Jstrt;Jstp
    PROJ      Map projection/angles/margins|drop flag
    MAP       Map color/dash/width/filter flag
    MSCALE    fgc;bgc;mask/units/lat;hide/values/anch/x;y/ln;wd/freq|text_info|t
    LATLON    Line color/dash/width/freq/inc/label/format
    DEVICE    Device|name|x size;y size|color type
    STNPLT    Txtc/txt attr|marker attr|stnfil#col
 
 

PROGRAM DESCRIPTION
 
    GDPLOT draws contours through scalar grids and wind barbs
    or arrows at grid points for vector grids.  Plots are
    generated for any field computed using the GEMPAK grid
    diagnostic functions.  The program can generate multiple
    sets of contours and vector plots for each frame.  It can
    also generate plots for multiple times.

    A list of times may be given in GDATTIM allowing animation.

    Exclamation points are used in GFUNC and GVECT to delimit
    multiple sets of contours and vectors, respectively.
    GLEVEL, GVCORD, PANEL, SKIP, SCALE, GFUNC, CTYPE, CONTUR,
    CINT, TITLE, LINE, FINT, FLINE, GVECT, WIND, REFVEC, HILO,
    and HLSYM may contain exclamation points to delimit
    specifications for the fields defined by GFUNC and GVECT.
    If any parameter contains more specifications than the
    number of plots specified in GFUNC or GVECT, they will be
    ignored.  Positions between exclamation points may be left
    blank.  A trailing exclamation point will be treated as a
    blank.  If there is no trailing exclamation point, the
    last specification will be repeated for subsequent plots.

    Contours may be displayed as lines or as a color fill.
    If CTYPE is C, contour lines are drawn using input from CINT
    and LINE.  If CTYPE is F, filled contours are drawn using
    specifications from FINT and FLINE. Both contour lines and
    filled contours are drawn if CTYPE is F/C.

    The attributes of the contour lines, including the color,
    line type, line width, and label frequency are specified
    in LINE.  The four attributes must be separated with slashes;
    semicolons separate the values for each attribute.  If the
    line type is set to a single negative number, negative
    contour values will have the absolute value of the line type
    and positive values will be solid.  If the label type is set
    to a single number, n, then every nth value will be labeled.

    The contour fill intervals are specified in FINT; the attributes
    for the fill are specified in FLINE.  The first color specified
    in FLINE fills values less than the first level; while the
    last color fills values greater than the last level.  Therefore,
    n levels require n+1 colors.

    A range of colors may be specified in either FLINE or LINE by
    specifying starting, ending and increment values in that order
    separated by dashes.  If the increment is missing, a default
    of 1 is used.

    The fill type may be set to 1 (solid), 2 (slanted dash) or 3
    (slanted line).  If fill type is set to 0, solid fill is used.
    If the fill type is set to a single negative number, negative
    values will use the absolute value of the fill type, and positive
    values will be solid.

    If M is entered in the wind symbol specification of WIND, winds
    will be displayed in m/s, unless the KNOTV operator has been
    specified in GVECT, in which case the winds will be displayed
    in knots.  If K is entered in WIND, the wind is displayed in
    knots.

    For contours, SKIP specifies the number of grid points to skip
    in generating contours.  For example, if SKIP = 1, every other
    point is used to generate the contours.

    For vectors, SKIP specifies the number of points to skip in both
    coordinate directions.  For example, SKIP = /1;2 will display winds
    at every other grid point in the x direction and every third grid
    in the y direction.  SKIP = /0 displays winds at every grid point.
    Wind barbs or arrows can also be staggered by specifying negative
    values for SKIP.

    The HILO and HLSYM parameters control marking and labeling the
    values of relative maxima and minima.  CLRBAR allows a color bar
    to be added for color fill contours.

 
EXAMPLES
 
    1.  Plot the 700 mb temperature, dewpoint and wind barbs.  Plot the
	temperature in color 3 and the dewpoint in color 17.  For both
	sets of contours, the lines of negative value are drawn in
	pattern 3 and the those of positive value are solid.  Every other
	contour is labeled.  The wind barbs are plotted in m/s in color 6.
	The display area is an enlarged area centered on New York.

	GDFILE	 =  $GEMPAK/data/hrcbob.grd
	GDATTIM	 =  f24
	GLEVEL	 =  700
	GVCORD	 =  pres
	PANEL	 =  0
	SKIP	 =  0
	SCALE	 =  0
	GFUNC	 =  tmpc                                      ! dwpc
	CTYPE	 =  C
	CONTUR	 =  3
	CINT	 =  2                                         ! 5
	LINE	 =  3/-3/3/2                                  ! 17/-3/2/2
	FINT	 =  0
	FLINE	 =  10-20
	HILO	 =
	HLSYM	 =
	CLRBAR	 =
	GVECT	 =  wnd
	WIND	 =  bm6//2
	REFVEC	 =  10
	TITLE	 =  1/-2/~  @  TEMPERATURE, DEWPOINT AND WIND ! 0
	TEXT	 =  1/22//hw
	CLEAR	 =  yes
	GAREA	 =  ny-
	PROJ	 =  mer
	MAP	 =  1/7
	LATLON	 =  2/10/1/1/5;5
	DEVICE	 =  xw
	STNPLT   =

    2.  Draw fills and contours of the magnitude of the wind (knots),
	contours of height and wind barbs (knots) at 250 mb.  The
	contour and fill intervals are specified in CINT and FINT.
	The display area is the entire grid on a stereographic map.

	GDFILE	 =  $GEMPAK/data/hrcbob.grd
	GDATTIM	 =  f24
	GLEVEL	 =  250
	GVCORD	 =  pres
	PANEL	 =  0
	SKIP	 =  0/1
	SCALE	 =  0                                           ! -1
	GFUNC	 =  knts(mag(wnd))                              ! hght
	CTYPE	 =  c/f                                         ! c
	CONTUR	 =  1
	CINT	 =  30;50;70;90;110;130;150                     ! 12
	LINE	 =  27/5/2/1                                    ! 20/1/2/1
	FINT	 =  70;90;110;130;150
	FLINE	 =  0;25;24;29;7;15
	HILO	 =
	HLSYM	 =
	CLRBAR	 =  1
	GVECT	 =  kntv(wnd)
	WIND	 =  bk18//1
	REFVEC	 =
	TITLE	 =  5/-2/~  @  HEIGHTS, ISOTACHS AND WIND (KTS) ! 0
	TEXT	 =  1/21//hw
	CLEAR	 =  yes
	GAREA	 =  grid
	PROJ	 =  str/90;-105;0
	MAP	 =  1
	LATLON	 =  0
	DEVICE	 =  XW
	STNPLT   =

ERROR MESSAGES
 
    [GDPLOT  +3]    WARNING:  ... not found.  CONTINUING---
    [GDPLOT  +2]    The requested scalar/vector cannot be computed.
    [GDPLOT  +1]    WARNING.  There are no contour levels.
    [GDPLOT  -1]    Fatal error initializing TAE.
    [GDPLOT  -2]    Fatal error reading TAE parameters.
    [GDPLOT  -3]    Fatal error initializing GEMPLT.
    [GDPLOT  -4]    Grid requested is not available.
    [GDPLOT  -5]    Error setting grid navigation for file ....
    [GDPLOT  -6]    There are no grids in grid file.