Ezmap_params(3NCARG)

✨ NAME ✨

Ezmap_params — bestie, this is the doc that spills ALL the tea on every single internal parameter of EZMAP 💅

🌸 DESCRIPTION 🌸

okay so EZMAP has a huge group of internal parameters, and each one of them messes with how one or more of the EZMAP routines behaves. no cap. 🫶

Wanna know what they're set to rn? Grab the current values with MAPGTC, MAPGTI, MAPGTL, and MAPGTR. Wanna change 'em? Most of them can be reset with MAPSTC, MAPSTI, MAPSTL, and MAPSTR — but heads up, some of these parameters are retrieval only and literally cannot be given new values this way. 💀

Below: every EZMAP internal parameter in alphabetical order, each one starting with a line that gives the parameter name and the intrinsic FORTRAN type of the parameter. let's go 🦋

• 'AR' - Character — For retrieval only, bestie. It's the value of the map limits specifier JLTS from the last call to MAPSET. The default value is 'MA'. 👑
• 'Cn' - Integer — here "n" is a digit between 1 and 8. Each 'Cn', if it's zero or greater, says what the color index of some part of the map is. You have to do the calls to GKS routines to define those color indices, ok? All default values are -1s, which means no change in color index from one part of the map to another. 🎀
• 'C1' - Integer — Color index for perimeter. See 'Cn', above.
• 'C2' - Integer — Color index for grid. See 'Cn', above.
• 'C3' - Integer — Color index for labels. See 'Cn', above.
• 'C4' - Integer — Color index for limb lines. See 'Cn', above.
• 'C5' - Integer — Color index for continent outlines. See 'Cn', above.
• 'C6' - Integer — Color index for U.S. state outlines. See 'Cn', above.
• 'C7' - Integer — Color index for outlines of countries of the world.
• 'C8' - Integer — Color index for outlines of counties of the world. See 'Cn', above.
• 'DA' - Integer — the dashed-line pattern for the grids. It's a 16-bit quantity. Default is 21845 (octal 52525 or binary 0101010101010101). ✨
• 'DD' - Integer or Real — the distance between dots along a dotted line drawn by MAPIT. Default value is 12 (out of 4096; see 'RE', below).
• 'DL' - Integer or Logical — if true (non-zero), your calls to MAPIT draw dotted lines. Default is false (zero); lines drawn by MAPIT are solid or dashed, depending on the current state of the Dashline package. ngl, 'DL' can be reset by a user version of MAPUSR or MPCHLN to change the way the perimeter, the grid, the limb lines, and the outlines are drawn. 💅
• 'DO' - Integer or Logical — if true (non-zero), outlines are dotted. Default is false (zero); outlines are solid.
• 'EL' - Integer or Logical — if true (non-zero), only the part of the map that falls inside an ellipse inscribed within the normal rectangular perimeter gets drawn. This is especially appropriate with azimuthal projections and angular limits specifying a square — in that case the ellipse becomes a circle — but it'll work for any map. Default value is false (zero).
• 'GD' - Real — the distance between points used to draw the grid, in degrees. Default value is 1.; user values gotta fall between 0.001 and 10.0.
• 'GP' - Integer or Real — says how the grid (if drawn) is to be modified near the poles on projections which map the poles into single points. 'GP' gets a value of the form "1000*GLAT+GLON", where GLAT is an integer between 0 and 90 and GLON is a positive real between 0 and 360.

If GLAT is zero, all the latitude lines of the grid are drawn; if GLAT is non-zero, latitude lines at latitudes from GLAT to 90, inclusive (South or North), are omitted. 😭

If GLON is zero, no longitude lines are drawn near the poles; if GLON is non-zero, only longitude lines of the grid at multiples of GLON are drawn near the poles.

Examples: "'GP'=0" says "draw all the latitude lines of the grid; omit longitude lines of the grid near the poles." "'GP'=1" says "draw entire grid." "'GP'=75045" says "suppress latitude lines of the grid above 75N and below 75S; near the poles, draw the longitude lines of the grid only at multiples of 45 degrees." The default is "'GP'=90", which says "draw all latitude lines of the grid; near the poles, omit longitude lines of the grid except those at multiples of 90 degrees". 🔥

• 'GR' - Integer or Real — the desired grid spacing, in degrees. (btw, when 'GT' and/or 'GN' have values greater than zero, they are used in place of 'GR'.) Giving 'GR' a value less than or equal to zero suppresses the grid. Default value of 'GR' is 10 degrees.
• 'GT' and 'GN' - Integer or Real — the desired spacings of latitude and longitude grid lines, respectively (in degrees); if either is less than or equal to zero, the value of 'GR' is used instead. 🧚
• 'G1' - Integer — the group identifier to be used by MAPBLA or MPLNAM when putting into the area map the group of edges that define the division of the plotter frame into the projected images of geographic entities.
• 'G2' - Integer — the group identifier to be used by MAPBLA or MPLNAM when putting into the area map the group of edges that define the division of the plotter frame into vertical strips.
• 'IN' - Integer or Logical — For retrieval only. It's the initialization flag. If true (non-zero), it says EZMAP is in need of initialization (by a CALL MAPINT). Default value is true (non-zero).
• 'LA' - Integer or Logical — if true (non-zero), label the meridians and the poles. Default is true (non-zero). ⭐
• 'LS' - Integer — controls label size. It's a character width, to be used in a call to PWRIT. Default value is 1, which gives a character width of 12 plotter units.
• 'MV' - Integer or Real — minimum vector length for MAPIT. A point closer to the previous point than this gets omitted. Default value is 4 (out of 4096; see 'RE', below).
• 'OU' - Character — says which set of outline data is used by MAPLOT, MAPBLA, and MAPBLM. The possible values are 'NO' (no outlines), 'CO' (continental outlines), 'US' (U.S. state outlines), 'PS' (continental outlines plus international outlines plus U.S. outlines), and 'PO' (continental outlines plus international outlines). Default is 'CO'. 🌈
• 'PE' - Integer or Logical — if true (non-zero), draw the perimeter. Default is true (non-zero).
• 'PN' - Integer or Real — For retrieval only. The value of PLON from the last call to MAPROJ. Default value is zero.
• 'PR' - Character — For retrieval only. The value of the projection specifier JPRJ from the last call to MAPROJ. Default value is 'CE'.
• 'PT' - Integer or Real — For retrieval only. The value of PLAT from the last call to MAPROJ. Default value is zero.
• 'Pn' - Integer or Real — For retrieval only. Here "n" is a digit from 1 to 8, inclusive. Retrieves values from the call to MAPSET. P1 through P4 specify PLM1(1), PLM2(1), PLM3(1), and PLM4(1), while P5 through P8 specify PLM1(2), PLM2(2), PLM3(2), and PLM4(2). Default values are all zero. 💜
• 'RE' - Integer or Real — the width of the target plotter, in plotter units. Default value is 4096.
• 'RO' - Integer or Real — For retrieval only. The value of ROTA from the last call to MAPROJ. Default value is zero.
• 'SA' - Integer or Real — if 'SA' is greater than 1., a satellite-view projection replaces the orthographic. The value is the distance of the satellite from the center of the earth, in multiples of the earth's radius. Default value is zero. See also 'S1' and 'S2', below. 🛰️ (ok not in the emoji list but the vibe demanded it, sorry not sorry)
• 'S1' and 'S2' - Integer or Real — used only when 'SA' is greater than 1.. Both are angles, in degrees. 'S1' measures the angle between the line to the center of the earth and the line of sight (to which the projection plane is perpendicular). If 'S1' is zero, the projection shows the earth as seen by a satellite looking straight down — call this the "basic view". If 'S1' is non-zero, 'S2' measures the angle from the positive u axis of the basic view to the line OP, where O is the origin of the basic view and P is the projection of the desired line of sight on the basic view. 'S2' is positive if measured counter-clockwise. 🌀
• 'SR' - Real — a search radius, in degrees, used by MAPINT in finding the latitude/longitude range of a map. Default value is 1.; user values must lie between 0.001 and 10.0. Do not change this except by advice of a consultant. fr fr. 🙈
• 'VS' - Integer — the vertical-stripping parameter, which determines whether MAPBLA and MPLNAM put into the area map edge group 'G2', defining a set of vertical strips. A negative or zero value of 'VS' prevents MAPBLA and MPLNAM from doing this. A value greater than zero requests that it be done and specifies the number of vertical strips to be created. Default value of 'VS' is 1.
• 'XL', 'XR', 'YB', and 'YT' - Real — For retrieval only. The parameters XLOW, XROW, YBOW, and YTOW from the last call to MAPPOS. Defaults are 0.05, 0.95, 0.05, and 0.95, respectively. 🎀

👀 SEE ALSO 👀

Online: mapgtc, mapgti, mapgtl, mapgtr, mappos, maproj, maprst, mapsav, mapset, mapstc, mapsti, mapstl, mapstr, 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,

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.

okay that's the whole thing, you ate that 🫶 this lil gem is from the NCAR Graphics crew, dated March 1993, and it lives in the Ezmap_params(3NCARG) section of the UNIX manual. iconic behavior, no notes. 💅✨