NAME

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

SYNOPSIS

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

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_mapset (char *jlts, float *plm1, float *plm2,
       float *plm3, float *plm4)

DESCRIPTION

       JLTS        (an  input  expression, of type CHARACTER) is a character string specifying how the limits of
                   the map are to be chosen. There are six possibilities, as follows:

                   •      JLTS='MA' (MAXIMUM). The maximum useful area produced by the  projection  is  plotted.
                          PLM1, PLM2, PLM3, and PLM4 are not used.

                   •      JLTS='CO'  (CORNERS).  The  points  (PLM1,PLM2)  and (PLM3,PLM4) are to be at opposite
                          corners of the map. PLM1 and PLM3 are  latitudes,  in  degrees.   PLM2  and  PLM4  are
                          longitudes,  in  degrees.  If  a cylindrical projection is being used, the first point
                          should be on the left edge of the  map  and  the  second  point  on  the  right  edge;
                          otherwise, the order makes no difference.

                   •      JLTS='PO'  (POINTS).  PLM1,  PLM2,  PLM3,  and  PLM4 are two-element arrays giving the
                          latitudes and longitudes, in degrees, of four points which are to be on the  edges  of
                          the rectangular map. If a cylindrical projection is being used, the first point should
                          be on the left edge and the second point on the right edge; otherwise, the order makes
                          no difference.

                   •      JLTS='AN'  (ANGLES).  PLM1,  PLM2,  PLM3,  and  PLM4  are positive angles, in degrees,
                          representing angular distances from a point on the map to the left, right, bottom, and
                          top edges of the map, respectively. For most projections, these  angles  are  measured
                          with  the  center  of the earth at the vertex and represent angular distances from the
                          point which projects to the origin of the u/v plane; on a  satellite-view  projection,
                          they  are  measured  with the satellite at the vertex and represent angular deviations
                          from the line of sight. Angular limits are particularly useful for  polar  projections
                          and  for  the  satellite-view  projection;  they  are  not appropriate for the Lambert
                          conformal conic and an error will  result  if  one  attempts  to  use  JLTS='AN'  with
                          JPRJ='LC'.

                   •      JLTS='LI'  (LIMITS).  PLM1,  PLM2,  PLM3, and PLM4 specify the minimum value of u, the
                          maximum value of u, the minimum value of v, and the maximum value of v,  respectively.
                          Knowledge  of  the  projection  equations  is  necessary  in  order to use this option
                          correctly.

                   •      JLTS='GR' (GRID). PLM1, PLM2, PLM3, and PLM4 specify the minimum  value  of  latitude,
                          the  minimum  value of longitude, the maximum value of latitude, and the maximum value
                          of longitude, in degrees, on a lat/lon grid.  The limits will be determined in such  a
                          way as to ensure that the entire grid will be visible on the map.

       PLM1, PLM2, PLM3, and PLM4
                   (input arrays, dimensioned 2, of type REAL) are as described above, depending on the value of
                   JLTS. Note that each is a two-element array. Strictly speaking, the FORTRAN standard requires
                   that they be declared as such, even when only the first element of each array is used.

C-BINDING DESCRIPTION

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

USAGE

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

EXAMPLES

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

ACCESS

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

MESSAGES

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

SEE ALSO

       Online:  ezmap,  ezmap_params,  mapaci,  mapbla,  mapblm, mapdrw, mapeod, mapfst, mapgci, mapgrd, mapgrm,
       mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq, mapiqa, mapiqd, mapiqd,  mapiqm,  mapit,  mapita,  mapitd,
       mapitd,  mapitm,  maplbl,  maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, 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                                     MAPSET(3NCARG)