NAME

       MAPEOD - Called by the EZMAP routines MAPLOT and MAPBLA.  The default version does
       nothing.  A user-written version may be supplied to examine each outline-dataset segment
       and, perhaps, to delete selected ones.  Note that this routine is not called by any of the
       EZMAPB routines; for the same purpose, they call the routine MPCHLN.

SYNOPSIS

       CALL MAPEOD (NOUT,NSEG,IDLS,IDRS,NPTS,PNTS)

DESCRIPTION

       NOUT        (an input expression of type INTEGER) is the number of the outline dataset
                   from which the segment comes, as follows:

                   NOUT    Dataset from which the segment came

                   1       CO - Continental outlines only.

                   2       US - U.S. state outlines only.

                   3       PS - Continental, U.S. state, and international outlines.

                   4       PO - Continental and international outlines.

       NSEG        (an input expression of type INTEGER) is the number of the segment within the
                   outline dataset. The maps in the example named "mpex09" show segment numbers
                   for the outline dataset 'CO'; the program may be modified to produce maps
                   showing segment numbers for any outline dataset.

       IDLS and IDRS
                   (input expressions of type INTEGER) are identifiers for the areas to the left
                   and right, respectively, of the segment. (Left and right are defined from the
                   standpoint of a viewer standing at point 1 of the segment and looking toward
                   point 2.)

       NPTS        (an input/output variable of type INTEGER), on entry, is the number of points
                   defining the outline segment. NPTS may be zeroed by MAPEOD to suppress
                   plotting of the segment on the map.

       PNTS        (an input/output array, dimensioned 2*NPTS, of type REAL) is an array of
                   coordinates. PNTS(1) and PNTS(2) are the latitude and longitude of the first
                   point, PNTS(3) and PNTS(4) the latitude and longitude of the second point, ...
                   PNTS(2*NPTS-1) and PNTS(2*NPTS) the latitude and longitude of the last point.
                   All values are in degrees. Longitudes are all between -180 and +180; no
                   segment crosses the meridian at -180 (+180) degrees.

USAGE

       MAPEOD is called by MAPLOT to examine each segment in an outline dataset just before it is
       plotted and by MAPBLA to examine each segment in an outline dataset just before it is
       added to an area map. The default version of MAPEOD does nothing. A user-supplied version
       may cause selected segments to be deleted (to reduce the clutter in northern Canada, for
       example).

EXAMPLES

       Use the ncargex command to see the following relevant examples: mpex03, mpex05, mpex09.

ACCESS

       To use MAPEOD, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably
       in that order.

SEE ALSO

       Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapfst, mapgci, mapgrd,
       mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq, mapiqa, mapiqd, mapiqm, mapit,
       mapita, mapitd, mapitm, maplbl, maplmb, maplot, mappos, maproj, maprs, maprst, mapsav,
       mapset, mapstc, mapsti, mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln,
       mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola, mpiosa,
       mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri, mpname, mprset, mpsetc,
       mpseti, mpsetl, mpsetr, supmap, supcon, ncarg_cbind

       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.