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.

UNIX                                               March 1993                                     MAPEOD(3NCARG)