MAPSET(3NCARG)

✨ MAPSET ✨ (that's the 3NCARG one, bestie 💖)

okay so picture this: you're deep in NCAR Graphics land, you're doing EZMAP stuff, and you need to tell it exactly which rectangular slice of the u/v plane you want drawn. That's literally what MAPSET does. It's giving "map, but make it a rectangle you chose". 🎀

---

🌸 NAME 🌸

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

---

🦋 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 — this one's an input expression, of type CHARACTER. It's a character string that says how the limits of your map get chosen. There are six possibilities, and here they all are, no skips, no cap:
  • JLTS='MA' (MAXIMUM) — the maximum useful area that the projection produces is what gets plotted. And PLM1, PLM2, PLM3, and PLM4? Not used. They're just sitting there. 💅
  • JLTS='CO' (CORNERS) — the points (PLM1,PLM2) and (PLM3,PLM4) are gonna be at opposite corners of the map. PLM1 and PLM3 are latitudes, in degrees. PLM2 and PLM4 are longitudes, in degrees. And heads up 🫶: if you're using a cylindrical projection, 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) — here 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're 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 — but 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. Lowkey you need knowledge of the projection equations in order to use this option correctly. iykyk.
  • 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 — these are input arrays, dimensioned 2, of type REAL, and they do whatever's described above, depending on the value of JLTS. Note that each one 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. Not me side-eyeing the FORTRAN standard 🙈 but it is what it is.

---

🧚 C-BINDING DESCRIPTION 🧚

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. Same vibes, same facts, just C. 💖

---

🌈 USAGE 🌈

This routine lets you 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 — and yes, we're listing all of them, every single one, no crumbs:

ccpcica, ccpmap, ccpmovi, ccppole, ccpvp, colcon, cezmap1, cezmap2, cezmap3, cmpclr, cmpdd, cmpdrw, cmpfil, cmpgrd, cmpgrp, cmpita, cpitm... okay not that one, it's cpmitm, let me not play myself 😭:

ccpcica, ccpmap, ccpmovi, ccppole, ccpvp, colcon, cezmap1, cezmap2, cezmap3, cmpclr, cmpdd, cmpdrw, cmpfil, cmpgrd, cmpgrp, cmpita, cpmitm, 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.

(sorry, typo'd cpmitm up there the first time — the real one is cpmitm, as in the list. 🍓)

---

👑 ACCESS 👑

To use MAPSET or c_mapset, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. Don't fight the order, it knows what it's doing. ✨

---

💀 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

(yes, mapiqd and mapitd each show up twice in the original list and I am not erasing them, they're iconic, they can stay 💖)

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 bestie that's the whole page, you're so welcome 🫶 this was the UNIX version of the MAPSET(3NCARG) page, dated March 1993 (yes, before you were born, and it still slays), from NCAR Graphics — go forth and set those map limits, mwah 💅✨🌸