1MAPEOD(3NCARG) NCAR GRAPHICS MAPEOD(3NCARG)
2
3
4
6 MAPEOD - Called by the EZMAP routines MAPLOT and MAPBLA. The default
7 version does nothing. A user-written version may be supplied to
8 examine each outline-dataset segment and, perhaps, to delete selected
9 ones. Note that this routine is not called by any of the EZMAPB
10 routines; for the same purpose, they call the routine MPCHLN.
11
13 CALL MAPEOD (NOUT,NSEG,IDLS,IDRS,NPTS,PNTS)
14
16 NOUT (an input expression of type INTEGER) is the number of the
17 outline dataset from which the segment comes, as follows:
18
19 NOUT Dataset from which the segment came
20
21 1 CO - Continental outlines only.
22
23 2 US - U.S. state outlines only.
24
25 3 PS - Continental, U.S. state, and international
26 outlines.
27
28 4 PO - Continental and international outlines.
29
30 NSEG (an input expression of type INTEGER) is the number of the
31 segment within the outline dataset. The maps in the example
32 named "mpex09" show segment numbers for the outline dataset
33 'CO'; the program may be modified to produce maps showing
34 segment numbers for any outline dataset.
35
36 IDLS and IDRS
37 (input expressions of type INTEGER) are identifiers for the
38 areas to the left and right, respectively, of the segment.
39 (Left and right are defined from the standpoint of a viewer
40 standing at point 1 of the segment and looking toward point
41 2.)
42
43 NPTS (an input/output variable of type INTEGER), on entry, is
44 the number of points defining the outline segment. NPTS may
45 be zeroed by MAPEOD to suppress plotting of the segment on
46 the map.
47
48 PNTS (an input/output array, dimensioned 2*NPTS, of type REAL)
49 is an array of coordinates. PNTS(1) and PNTS(2) are the
50 latitude and longitude of the first point, PNTS(3) and
51 PNTS(4) the latitude and longitude of the second point, ...
52 PNTS(2*NPTS-1) and PNTS(2*NPTS) the latitude and longitude
53 of the last point. All values are in degrees. Longitudes
54 are all between -180 and +180; no segment crosses the
55 meridian at -180 (+180) degrees.
56
58 MAPEOD is called by MAPLOT to examine each segment in an outline
59 dataset just before it is plotted and by MAPBLA to examine each segment
60 in an outline dataset just before it is added to an area map. The
61 default version of MAPEOD does nothing. A user-supplied version may
62 cause selected segments to be deleted (to reduce the clutter in
63 northern Canada, for example).
64
66 Use the ncargex command to see the following relevant examples: mpex03,
67 mpex05, mpex09.
68
70 To use MAPEOD, load the NCAR Graphics libraries ncarg, ncarg_gks, and
71 ncarg_c, preferably in that order.
72
74 Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapfst,
75 mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq,
76 mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl, maplmb,
77 maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc, mapsti,
78 mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln, mpfnme,
79 mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola,
80 mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri,
81 mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
82 ncarg_cbind
83
84 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
85
87 Copyright (C) 1987-2009
88 University Corporation for Atmospheric Research
89 The use of this Software is governed by a License Agreement.
90
91
92
93UNIX March 1993 MAPEOD(3NCARG)