1MAPSET(3NCARG)                   NCAR GRAPHICS                  MAPSET(3NCARG)
2
3
4

NAME

6       MAPSET - Specifies the rectangular portion of the u/v plane to be
7       drawn.
8

SYNOPSIS

10       CALL MAPSET (JLTS, PLM1, PLM2, PLM3, PLM4)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_mapset (char *jlts, float *plm1, float *plm2,
16       float *plm3, float *plm4)
17

DESCRIPTION

19       JLTS        (an input expression, of type CHARACTER) is a character
20                   string specifying how the limits of the map are to be
21                   chosen. There are six possibilities, as follows:
22
23
24                   ·      JLTS='MA' (MAXIMUM). The maximum useful area
25                          produced by the projection is plotted. PLM1, PLM2,
26                          PLM3, and PLM4 are not used.
27
28                   ·      JLTS='CO' (CORNERS). The points (PLM1,PLM2) and
29                          (PLM3,PLM4) are to be at opposite corners of the
30                          map. PLM1 and PLM3 are latitudes, in degrees.  PLM2
31                          and PLM4 are longitudes, in degrees. If a
32                          cylindrical projection is being used, the first
33                          point should be on the left edge of the map and the
34                          second point on the right edge; otherwise, the order
35                          makes no difference.
36
37                   ·      JLTS='PO' (POINTS). PLM1, PLM2, PLM3, and PLM4 are
38                          two-element arrays giving the latitudes and
39                          longitudes, in degrees, of four points which are to
40                          be on the edges of the rectangular map. If a
41                          cylindrical projection is being used, the first
42                          point should be on the left edge and the second
43                          point on the right edge; otherwise, the order makes
44                          no difference.
45
46                   ·      JLTS='AN' (ANGLES). PLM1, PLM2, PLM3, and PLM4 are
47                          positive angles, in degrees, representing angular
48                          distances from a point on the map to the left,
49                          right, bottom, and top edges of the map,
50                          respectively. For most projections, these angles are
51                          measured with the center of the earth at the vertex
52                          and represent angular distances from the point which
53                          projects to the origin of the u/v plane; on a
54                          satellite-view projection, they are measured with
55                          the satellite at the vertex and represent angular
56                          deviations from the line of sight. Angular limits
57                          are particularly useful for polar projections and
58                          for the satellite-view projection; they are not
59                          appropriate for the Lambert conformal conic and an
60                          error will result if one attempts to use JLTS='AN'
61                          with JPRJ='LC'.
62
63                   ·      JLTS='LI' (LIMITS). PLM1, PLM2, PLM3, and PLM4
64                          specify the minimum value of u, the maximum value of
65                          u, the minimum value of v, and the maximum value of
66                          v, respectively. Knowledge of the projection
67                          equations is necessary in order to use this option
68                          correctly.
69
70                   ·      JLTS='GR' (GRID). PLM1, PLM2, PLM3, and PLM4 specify
71                          the minimum value of latitude, the minimum value of
72                          longitude, the maximum value of latitude, and the
73                          maximum value of longitude, in degrees, on a lat/lon
74                          grid.  The limits will be determined in such a way
75                          as to ensure that the entire grid will be visible on
76                          the map.
77
78       PLM1, PLM2, PLM3, and PLM4
79                   (input arrays, dimensioned 2, of type REAL) are as
80                   described above, depending on the value of JLTS. Note that
81                   each is a two-element array. Strictly speaking, the FORTRAN
82                   standard requires that they be declared as such, even when
83                   only the first element of each array is used.
84

C-BINDING DESCRIPTION

86       The C-binding argument descriptions are the same as the FORTRAN
87       argument descriptions.
88

USAGE

90       This routine allows you to set the current values of the EZMAP
91       parameters 'AR', 'P1', 'P2', ... 'P7', and 'P8'.  For a complete list
92       of parameters available in this utility, see the ezmap_params man page.
93

EXAMPLES

95       Use the ncargex command to see the following relevant examples:
96       ccpcica, ccpmap, ccpmovi, ccppole, ccpvp, colcon, cezmap1, cezmap2,
97       cezmap3, cmpclr, cmpdd, cmpdrw, cmpfil, cmpgrd, cmpgrp, cmpita, cmpitm,
98       cmplab, cmplbl, cmplot, cmpmsk, cmpou, cmptra, cpex01, cpex03, cpex08,
99       cpex09, mpex01, mpex02, mpex04, mpex07, mpex09, mpex10, eezmpa, tezmap,
100       tezmpa, fcover, ffex00, ffex02, ffex03, ffex05, fgkgpl, fgkgtx,
101       fngngdts.
102

ACCESS

104       To use MAPSET or c_mapset, load the NCAR Graphics libraries ncarg,
105       ncarg_gks, and ncarg_c, preferably in that order.
106

MESSAGES

108       See the ezmap man page for a description of all EZMAP error messages
109       and/or informational messages.
110

SEE ALSO

112       Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
113       mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
114       mapiq, mapiqa, mapiqd, mapiqd, mapiqm, mapit, mapita, mapitd, mapitd,
115       mapitm, maplbl, maplmb, maplot, mappos, maproj, maprs, maprst, mapsav,
116       mapstc, mapsti, mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec,
117       mpchln, mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb,
118       mpilnb, mpiola, mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm,
119       mplndr, mplnri, mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap,
120       supcon, ncarg_cbind
121
122       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
123
125       Copyright (C) 1987-2009
126       University Corporation for Atmospheric Research
127       The use of this Software is governed by a License Agreement.
128
129
130
131UNIX                              March 1993                    MAPSET(3NCARG)
Impressum