MAPITA(3NCARG)

💖 MAPITA 💖

okay so real talk: this is a page from the NCAR Graphics manual, section 3NCARG, and it's all about MAPITA and its little sister MAPIQA. if you've ever wanted to scribble lat/lon lines onto an area map without your pen yeeting itself across the planet, this is your moment. slay. ✨

---

🌸 NAME 🌸

MAPITA — adds to an area map the projections of lines defined by a series of lat/lon coordinates. that's the whole vibe: you feed it points, it draws lines, area map gets updated. iconic.

---

🎀 SYNOPSIS 🎀

CALL MAPITA (RLAT,RLON,IFST,IAMA,IGID,IAIL,IAIR)

CALL MAPIQA (IAMA,IGID,IAIL,IAIR)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_mapita (float rlat, float rlon, int ifst,
int *iama, int igid, int iail, int iair)

void c_mapiqa (int *iama, int igid, int iail, int iair)

---

✨ DESCRIPTION ✨

okay bestie, here's the cast of characters, one by one, no skipping 💅

• RLAT and RLON — input expressions, of type REAL. these are the latitude and longitude of the point where the "pen" is getting moved to. both are in degrees. RLAT must be between -90. and +90., inclusive; RLON must be between -540. and +540., inclusive. yes, that longitude range is huge. it's giving generous. no cap.
• IFST — an input expression, of type INTEGER. here's the tea:
  • 0 → do a "pen-up" move
  • 1 → do a "pen-down" move only if the distance from the last point to the new point is greater than 'MV' plotter units
  • 2 or greater → do a "pen-down" move regardless of the distance from the last point to the new one
• IAMA — an input/output array of type INTEGER, dimensioned as specified in a call to the AREAS initialization routine ARINAM. it's the area map that the lines sitting in MAPITA's buffer are getting added to. the main character, honestly 👑
• IGID — an input expression of type INTEGER. this is the group identifier that gets passed to the AREAS routine AREDAM when the lines in MAPITA's buffer are added to the area map in IAMA.
• IAIL — an input expression of type INTEGER. the left area identifier, passed to the AREAS routine AREDAM when the lines in MAPITA's buffer are added to the area map in IAMA.
• IAIR — an input expression of type INTEGER. the right area identifier, passed to the AREAS routine AREDAM when the lines in MAPITA's buffer are added to the area map in IAMA.

---

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. that's it. same energy, different wrapper. fr fr. 🫶

---

🔥 USAGE 🔥

so the routines MAPITA and MAPIQA let you add lines defined by a set of user-specified latitudes and longitudes to an area map. they attempt to omit non-visible portions of lines and to handle "cross-over", in the same way that MAPIT does. lowkey doing the most, highkey serving.

MAPITA is called like the EZMAP routine MAPIT, but it's got some extra arguments:

CALL MAPITA (RLAT,RLON,IFST,IAMA,IGID,IAIL,IAIR)

the additional arguments are the area map array IAMA, a group identifier IGID, and left and right area identifiers IAIL and IAIR. MAPIQA is called like the EZMAP routine MAPIQ, to terminate a series of calls to MAPITA and to flush the buffers; it has the same additional arguments:

CALL MAPIQA (IAMA,IGID,IAIL,IAIR)

the additional arguments are passed by MAPITA and MAPIQA to the routine AREDAM, in the package named AREAS.

for more info, go see the man page for the routine MAPIT. iykyk 📖

---

🍓 EXAMPLES 🍓

use the ncargex command to see the following relevant examples: cmpita, cpex08. go look at them, they're cute.

---

💜 ACCESS 💜

to use MAPITA or c_mapita, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. do not rearrange them, bestie, order matters here. 🙈

---

👑 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, mapitd, mapitm, maplbl, maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, 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

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.

---

heads up bestie: this whole thing is from the NCAR Graphics manual, section 3NCARG — the UNIX flavour, dated March 1993. old but gold, and still serving. 🎀✨💅

bye ily, go draw some lines 🦋