MAPTRN(3NCARG)

✨ MAPTRN ✨

okay bestie, so you know how we've been talking about NCAR Graphics? This is MAPTRN, a routine from the NCAR Graphics library (that's the 3NCARG manual, if you're keeping track 💅). And like — plot twist — SUPCON is literally just an alternate name for the routine MAPTRN. Same girl, different name. Iconic.

It projects points. That's the whole job. She's a projector. 🔥

---

🌸 NAME 🌸

MAPTRN — projects points, fr fr.

SUPCON</p> is an alternate name for the routine MAPTRN. So if you see SUPCON somewhere, don't panic, it's the same thing wearing a different outfit. 🎀

---

🦋 SYNOPSIS 🦋

CALL MAPTRN (RLAT, RLON, UVAL, VVAL)

---

💜 C-BINDING SYNOPSIS 💜

#include <ncarg/ncargC.h>

void c_maptrn (float rlat, float rlon, float *uval,
float *vval)

---

✨ DESCRIPTION ✨

okay so let's get into it, because this part is actually so important:

• RLAT and RLON — these are input expressions, of type REAL. RLAT is the latitude and RLON is the longitude of a point on the globe. And listen — there are rules, okay? RLAT must be between -90. and +90., inclusive. RLON must be between -540. and +540., inclusive. Like, don't try it. The range is the range. 🫶
• UVAL and VVAL — these are output variables, of type REAL, and they define the point (UVAL,VVAL) that is the projection in the u/v plane of (RLAT,RLON). And here's the thing: the units of UVAL and VVAL depend on the projection. So don't come for me about units, it's projection-dependent, iykyk.

Now, the ✨special cases✨ — because of course there are special cases:

• If the point is not projectable, UVAL is returned equal to 1.E12. That's the "nope, can't do it" number. 💀
• If the point is projectable, but outside the boundary of the map (as defined by the last call to MAPSET and by the value of the parameter 'EL'), then MAPTRN — unlike MAPTRA — still returns its u and v coordinates. Yes, she's generous like that. She's giving main character energy and she's giving you the numbers anyway. 👑

---

💖 C-BINDING DESCRIPTION 💖

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. No notes. Periodt. 💅

---

🌈 EXAMPLES 🌈

Use the ncargex command to see the following relevant examples: cpex03, mpex09.

Like, go look at them, they're right there, they're free. 🍓

---

🔥 ACCESS 🔥

To use MAPTRN or c_maptrn, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. The order is not a vibe suggestion, bestie, it's the order. 🧚

---

💌 MESSAGES 💌

See the ezmap man page for a description of all EZMAP error messages and/or informational messages. Everything you need to know lives over there. ✨

---

🎀 SEE ALSO 🎀

Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod, mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl, maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc, mapsti, mapstl, mapstr, maptra, maptri, 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

(that list is long, I know, but I promised I wouldn't skip a single one, and I didn't, because that's the kind of friend I am 💖)

---

👑 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!! 💖✨ this page is from the MAPTRN(3NCARG) manual — UNIX flavour, dated March 1993 — and honestly? she's still slaying all these years later. go project some points bestie, you got this 🦋🌸💅