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

NAME

6       MAPROJ - Sets the map projection to be used.
7

SYNOPSIS

9       CALL MAPROJ (JPRJ, PLAT, PLON, ROTA)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_maproj (char *jprj, float plat, float plon,
15       float rota)
16

DESCRIPTION

18       JPRJ        (an input expression, of type CHARACTER) defines the
19                   desired projection type. All the possible values are two
20                   characters in length; these are the possibilities:
21
22                   The conic projection:
23
24                       'LC' -  Lambert conformal conic with two standard
25                               parallels.
26
27                   The azimuthal projections:
28
29                       'ST' -  Stereographic.
30
31                       'OR' -  Orthographic. The EZMAP parameter 'SA' will be
32                               zeroed. See the note below.
33
34                       'LE' -  Lambert equal area.
35
36                       'GN' -  Gnomonic.
37
38                       'AE' -  Azimuthal equidistant.
39
40                       'SV' -  Satellite-view. If the EZMAP parameter 'SA' is
41                               less than or equal to 1., it will be reset to
42                               6.631 (the value for a satellite in a
43                               geosynchronous orbit).  See the note below.
44
45                   The cylindrical projections:
46
47                       'CE' -  Cylindrical equidistant.
48
49                       'ME' -  Mercator.
50
51                       'MO' -  Mollweide-type.
52
53                   Note: The orthographic and satellite-view projections have
54                   the same internal identifier. The EZMAP parameter 'SA'
55                   determines which will be used. If a call to MAPROJ
56                   selecting one or the other is followed by a call to MAPSTR
57                   resetting 'SA', it may have the effect of causing the other
58                   to be used.
59
60       PLAT,PLON,ROTA
61                   (input expressions, of type REAL) are angular quantities,
62                   in degrees. How they are used depends on the value of JPRJ,
63                   as follows:
64
65                   ·   If JPRJ is not equal to 'LC': PLAT and PLON define the
66                       latitude and longitude of the pole of the projection,
67                       the point on the globe which is to project to the
68                       origin of the u/v plane. PLAT must be between -90.  and
69                       +90., inclusive, positive in the northern hemisphere,
70                       negative in the southern. PLON must be between -180.
71                       and +180., inclusive, positive to the east, and
72                       negative to the west, of Greenwich.  ROTA is the angle
73                       between the v axis and north at the origin.  It is
74                       taken to be positive if the angular movement from north
75                       to the v axis is counter-clockwise, negative otherwise.
76                       If the origin is at the north pole, "north" is
77                       considered to be in the direction of PLON+180.  If the
78                       origin is at the south pole, "north" is considered to
79                       be in the direction of PLON. For the cylindrical
80                       projections, the axis of the projection is parallel to
81                       the v axis.
82
83                   ·   If JPRJ is equal to 'LC': PLON defines the central
84                       meridian of the projection, and PLAT and ROTA define
85                       the two standard parallels. If PLAT and ROTA are equal,
86                       a simpler conic projection, with one standard parallel,
87                       is used.
88

C-BINDING DESCRIPTION

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

USAGE

94       This routine allows you to set the current values of the EZMAP
95       parameters 'PR', 'PT', 'PN', and 'RO'.  For a complete list of
96       parameters available in this utility, see the ezmap_params man page.
97

EXAMPLES

99       Use the ncargex command to see the following relevant examples:
100       ccpcica, ccpmap, ccpmovi, ccppole, ccpvp, colcon, cezmap1, cezmap2,
101       cezmap3, cmpclr, cmpdd, cmpdrw, cmpel, cmpfil, cmpgrd, cmpgrp, cmpita,
102       cmpitm, cmplab, cmplbl, cmplot, cmpmsk, cmpou, cmpsat, cmptit, cmptra,
103       cmpusr, cpex01, cpex03, cpex08, cpex09, mpex01, mpex02, mpex04, mpex05,
104       mpex06, mpex07, mpex09, mpex10, eezmpa, epltch, tezmap, tezmpa, fcover,
105       ffex00, ffex02, ffex03, ffex05, fgkgtx, fngngdts, fpchiqu.
106

ACCESS

108       To use MAPROJ or c_maproj, load the NCAR Graphics libraries ncarg,
109       ncarg_gks, and ncarg_c, preferably in that order.
110

MESSAGES

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

SEE ALSO

116       Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
117       mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
118       mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl,
119       maplmb, maplot, mappos, maprs, maprst, mapsav, mapset, mapstc, mapsti,
120       mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln, mpfnme,
121       mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola,
122       mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri,
123       mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
124       ncarg_cbind
125
126       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
127

COPYRIGHT

129       Copyright (C) 1987-2009
130       University Corporation for Atmospheric Research
131       The use of this Software is governed by a License Agreement.
132
133
134
135UNIX                              March 1993                    MAPROJ(3NCARG)