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.