PTCON --  Contours and grids point data
   PTCON dataset1 dataset2 ... datasetn <keywords>
Parameters:
   dataset1, dataset2, ..., datasetn | ADDE point dataset names entered as
             alias.position or group/descriptor.position where position is
             a positive integer (absolute position), 0 or a negative
             integer (relative position), or ALL (no def for alias or
             group/descriptor; position def=ALL if DAY is specified in
             SELECT keyword, otherwise def=0)
Keywords:
   OUT=util dataset | utilization of created grid, def=CON (contour only);
                      also can PLOT (plot grid points), SAVE (save only),
                      SCON (save and contour), or SPLOT (save and plot);
                      if SAVE, SCON, or SPLOT is entered, an ADDE grid
                      dataset.position must be specified; grids of both
                      u and v wind components will be saved if PARAM is
                      STREAML, WINDB, WINDV or MOVIE; see the Remarks
   PARam= | parameter to contour; specify a native parameter, a computed
            parameter or a predefined parameter as listed below:
               NATIVE Parameter:     parameter[unit]
               COMPUTED Parameter:   'parameter[unit]=expression'
               PREDEFINED Parameter: STREAML (streamlines)
                                     WINDB (wind barbs)
                                     WINDV (wind vectors)
                                     MOVIE (streamlines with colored line
                                           segments that can be animated
                                           with the CM command)
            native parameters are those stored in the point file; computed
            parameters do not exist in the point file but are derived with
            the specified mathematical expression containing math operators
            (+ - * etc) & native parameters specified in Pn keywords, e.g.,
               PAR='TDD[F]=P1-P2'
            see Remarks and Pn keyword description for more information
            (no def for parameter or expression; unit def=from 'dataset')
   SELect='clause1; clause2; ..; clauseN' |
         selects only data matching the values specified in the select
         clauses, which can be in either of these formats:
            RANGE FORMAT:  parameter[unit] bval eval
            LIST FORMAT:   parameter[unit] val1,val2,..,valN
         any number of select clauses can be specified as long as each
         clause is separated by semicolons and there is a single quote
         before the first clause and after the last clause; units are
         optional but must be in square brackets if specified (no def
         for parameters; unit def=from 'dataset')
            Example:
              SELECT='T[F] 50 60 ; ST MN,IA,IL,WI ; TD[C] -2,-3,-4'
********************  Mathematical Operations Keywords *******************
   Pn=parameter[unit] 'clause1; clause2; ..; clauseN' |
      native parameters to use in the math expressions specified in the
      PARAM keyword; use a number between 1 and 99 in the keyword name
      (P1,P2,..,P99); each keyword specifies a single native parameter and
      units to substitute in matching Pn values in the math expression
         parameter[unit] is the native parameter name and units to use in
             matching Pn values in the math expression; the units default
             to those for the parameter in the dataset; there is no default
             for the parameter
         'clause1; clause2; ..; clauseN' are the clauses used to select
             data for this keyword; only data matching their criteria is
             used; they are specified exactly as in the SELECT keyword
      the Pn keywords inherit the clauses specified in the SELECT keyword;
      therefore, you should specify a Pn keyword clause only if a value
      differs from that in the SELECT keyword or you need to add additional
      clauses; e.g., to set the values of P1 and P2 to the 850 and 500 mb
      temperatures in degrees Celsius at 0 UTC, respectively, specify the
      following keywords:
         SEL='TIME 0; P 850'  P1=T[C]  P2=T[C] 'P 1000'
   GINfo=level lunit day time src fhour| values to assign to the header of
                              the computed parameter grid created with the
                              PARAM and Gn keywords, where:
              level - grid level
              lunit - units of grid level; 2 character max
              day - grid day (def=value specified for DAY in SELECT
                    keyword; otherwise def=today)
              time - grid time (def=value specified for TIME in SELECT
                     keyword; otherwise def=22:22:22)
              src - grid source (def=MDX)
              fhour - grid forecast hour (def=0)
**********************  Map/Navigation Keywords  *************************
   LAT=lat1 lat2 | latitudes of points at lower-right & upper-left corners
                   of the map; you cannot use LAT with NAV or MAP
   LON=lon1 lon2 | longitudes of points at lower-right and upper-left
                   corners of the map; you cannot use LON with NAV or MAP
   MAP= | map for the contour/plot; use any predefined map in MAP command;
          you cannot use MAP with NAV, LAT or LON
   MCOlor= | graphics color level of map (def=1)
   NAV= | frame to use for navigation; specify frame number or C (current
          frame); no map is drawn; you cannot use NAV with MAP, LAT or LON
   PRO=CONF | polar stereographic or Lambert conformal projection
      =MERC | mercator projection (def)
   SLAt=l1 l2 | standard latitude(s) for a CONF projection; see the User's
                Guide for information and defaults
   SLOn= | standard longitude for a CONF projection (def=computed)
***********************  Contour and Plot Keywords  **********************
   COLor= | graphics color level (def=2 for contour, def=3 for plot)
   ELE= bele eele | beginning and ending frame elements for output
   FORMAT=designator 'text' | output format for contour labels or grid
               point values, and associated text; valid formats are I, F,
               or E; e.g., FORMAT=I4 'meters'   labels contours with the
               4-digit integer value followed by the word "meters"; see
               the User's Guide for details
               (designator def=from 'dataset'; no text def)
   GRA= | graphics frame to be used for the display (def=current)
   LABel='text' color line ele size |  text, color, location & size for
                                       title, where:
                'text' - title's text; 72 characters maximum; specify X
                         without quotes for default text (def=computed)
                color - graphics color level of title (def=1 if PAR=MOVIE
                        is specified; otherwise def=value specified in
                        COLOR keyword)
                line - beginning TV line to write title (def=below contour
                       or plot)
                ele - beginning TV element to write title (def=below
                      contour or plot)
                size - pixel size of text (def=8)
         Note: To add an apostrophe to the label/title, specify two single
         quotes, e.g., LABEL='Bob''s Analysis' plots label: Bob's Analysis
   LINE=blin elin | beginning and ending frame lines for output
   LSIZe= | height of plot characters or contour labels, in pixels (def=8)
   POWer= | power of 10 to multiply grid point values for display (def=0)
   TDAy=CAL | print calendar day on the default title; not valid if ELE,
              or LINE  keywords are used
       =JUL | print Julian day on the default title (def)
***********************  Contour-Specific Keywords  **********************
   CINt= | contour interval; specify 0 to let PTCON compute it, a number
           greater than 0 to use your own value, or a string name that
           contains up to 64 values; see the User's Guide for details
   DASh= | dash the contours: specify ALL for all contours, NEG for
           negative contours only or POS for positive contours only
   LINT= | contour label interval (def=1, every contour is labeled)
   MOVie=bcol ecol bspd espd blen elen | change the defaults for the
         PARAM=MOVIE output, where:
         bcol - beginning color level for line segments (def=2)
         ecol - ending color level for line segments
                (def=Max Color Level)
         bspd - beginning speed to correspond with blen (def=computed)
         espd - ending speed to correspond with elen (def=computed)
         blen - beginning length of line segments (def=2)
         elen - ending length of line segments (def=40)
   SMOoth= | contour smoothing factor; the range is 0-50; larger numbers
             produce smoother contours (def=20)
************************  Plot-Specific Keyword  *************************
   PINt=row col | row and column intervals of grid points to plot with
                  OUT=PLOT or PARAM=WINDB/WINDV (row def=1; col def=row)
***********************  Grid Conversion Keywords  ***********************
   BPAr= | bandwidth parameter (integer) used in the analysis filter; a
           high value results in specific data points influencing a
           greater domain of grid points, generating a smoother analysis;
           conversely, a low value will create a coarse analysis; the
           suggested range is 5 to 500 (def=40)
   DISt= | gridpoint distance to extrapolate into data voids (def=10)
   LLInc=latinc loninc | increment, in degrees, between gridpoints in the
                         latitudinal and longitudinal directions
                         (def=1 latinc)
*************************  Grid Output Keywords  *************************
   DELete=YES | delete the destination grid file before copying (def=NO)
   DGRid= | beginning grid number to place grids in destination grid file;
            may overwrite existing grids (def=append after last grid in
            the grid file)
   GLEV=level unit | grid level to be used on the grid header and the
                     graphics (def=value entered as LEV, THA, or P in
                     SELECT clause; otherwise, no def); no def for unit
   MAXgrd= | maximum number of grids the newly created destination grid
             file can store (def=1000)
   TITLE= 'text' | title of the newly created destination grid file;
                   32 characters maximum
***************************  Other Keywords  *****************************
   BYTecount=YES | lists the number of bytes received from the server
            =NO  | does not list the number of bytes (def)
Remarks:
   PTCON gathers data from one or more point files in one or more datasets.
   The SELECT keyword defines which records to match and the PARAM keyword
   defines which parameters in the matching records to use.  The gathered
   data are used as input into an objective analysis scheme which produces
   a pseudo-mercator grid that is either saved, contoured or both.  If the
   grid is saved, it's saved in the native units or in the units specified
   in the PARAM keyword.

   PTCON requires that a parameter (using PARAM keyword) and a spatial
   domain (using NAV, MAP, or LAT/LON) be entered.  If the point file
   contains multiple times and/or days, you should also specify TIME
   and/or DAY in the SELECT keyword; otherwise all times and/or days will
   be used.

   The PARAM keyword contains the parameter to contour. It can be a native
   parameter, a computed parameter, or a predefined parameter (STREAML,
   WINDB, WINDV, or MOVIE). Native parameters are those stored in the
   point file. They are specified in the PARAM keyword in the format:
   parameter[unit]   where "parameter" is the parameter name in the file,
   and "[unit]" is the output units, which are optional but must be in
   square brackets if specified. Computed parameters do not exist in the
   point file but are derived with a mathematical expression. Computed
   parameters are specified in the PARAM keyword in the format:
   'parameter[unit]=expression'   where "parameter" is the user-defined
   parameter name; "[unit]" is the label units, which are optional but
   must be in square brackets if specified; and "expression" is the
   mathematical expression consisting of math operators and one or more
   native parameters defined in the Pn keywords. The valid math operators
   are +,-,/,*,**,SQRT,EXP,LOG,LOG10,SIN,COS,TAN,ASIN,ACOS,ATAN,ABS,MIN
   and MAX. See the McIDAS User's Guide for definitions of the operators.

   The following character limits exist for PARAM keyword:
      - 256 characters maximum for the entire PARAM keyword list
      - 4 characters maximum for the computed parameter name
      - 4 characters maximum for the computed parameter units

   To file the correct day information in the output grid header (using
   OUT=SAVE, SCON, or SPLOT), you must specify the DAY select clause in
   the SELECT keyword.  If you don't specify a DAY select clause, the
   value stored in the grid header will be today's Julian date.
----------
