1MAPROJ(3NCARG) NCAR GRAPHICS MAPROJ(3NCARG)
2
6 MAPROJ - Sets the map projection to be used.
7
9 CALL MAPROJ (JPRJ, PLAT, PLON, ROTA)
10
12 #include <ncarg/ncargC.h>
13 void c_maproj (char *jprj, float plat, float plon,
15 float rota)
16
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 The conic projection:
23 'LC' - Lambert conformal conic with two standard
25 parallels.
26 The azimuthal projections:
28 'ST' - Stereographic.
30 'OR' - Orthographic. The EZMAP parameter 'SA' will be
32 zeroed. See the note below.
33 'LE' - Lambert equal area.
35 'GN' - Gnomonic.
37 'AE' - Azimuthal equidistant.
39 '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 The cylindrical projections:
46 'CE' - Cylindrical equidistant.
48 'ME' - Mercator.
50 'MO' - Mollweide-type.
52 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 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 · 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 · 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
90 The C-binding argument descriptions are the same as the FORTRAN
91 argument descriptions.
92
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
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
108 To use MAPROJ or c_maproj, load the NCAR Graphics libraries ncarg,
109 ncarg_gks, and ncarg_c, preferably in that order.
110
112 See the ezmap man page for a description of all EZMAP error messages
113 and/or informational messages.
114
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 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
127
129 Copyright (C) 1987-2007
130 University Corporation for Atmospheric Research
131 This documentation is free software; you can redistribute it and/or
133 modify it under the terms of the GNU General Public License as
134 published by the Free Software Foundation; either version 2 of the
135 License, or (at your option) any later version.
136 This software is distributed in the hope that it will be useful, but
138 WITHOUT ANY WARRANTY; without even the implied warranty of
139 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
140 General Public License for more details.
141 You should have received a copy of the GNU General Public License along
143 with this software; if not, write to the Free Software Foundation,
144 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
145UNIX March 1993 MAPROJ(3NCARG)