ARGTAI(3NCARG)

✨ ARGTAI ✨ — bestie edition

okay so this is a page from the NCAR GRAPHICS manual set (yes, that NCAR GRAPHICS, the plotting legend herself) and we're about to learn exactly what ARGTAI does. spoiler: it's the girl who tells you which area your little point landed in. 💅

---

🎀 NAME 🎀

ARGTAI — returns the area identifiers associated with a given point.

like. you give it a point. it tells you what area that point is living in. iconic behaviour honestly. 🫶

---

🌸 SYNOPSIS 🌸

CALL ARGTAI (MAP,XCD,YCD,IAI,IAG,MAI,NAI,ICF)

✨ C-BINDING SYNOPSIS ✨

#include <ncarg/ncargC.h>

void c_argtai (int *map, float xcd, float ycd, int *iai, int *iag, int
mai, int *nai, int icf)

---

💖 DESCRIPTION 💖

okay bestie, argument by argument, no skips, we're doing all of them:

• MAP — (an input/output array of type INTEGER) an array holding an area map that has been initialized by a call to ARINAM, and to which edges have been added by calls to AREDAM. and listen — if you did not preprocess that area map by calling ARPRAM, then ARGTAI just calls it for you before doing literally anything else. it's giving proactive. 💅

Note: as part of initializing the area map, ARINAM stores the dimension of MAP in MAP(1). so the dimension does not have to be handed over as an argument in calls to ARGTAI. she already knows her size, periodt.

• XCD — (an input expression of type REAL) the X coordinate, in the current user coordinate system, of a point you want info about.
• YCD — (an input expression of type REAL) the Y coordinate, in the current user coordinate system, of that same point you want info about. (yes you need both. it's a point. points have two numbers. 🦋)
• IAI — (an output array, dimensioned MAI, of type INTEGER) the array where the area identifiers for the area containing the specified point get returned.
• IAG — (an output array, dimensioned MAI, of type INTEGER) the array where the group identifiers for the area containing the specified point get returned.
• MAI — (an input expression of type INTEGER) the dimension of each of the arrays IAI and IAG. and this is important: MAI must be greater than or equal to NAI. no cap. 🙈
• NAI — (an output expression of type INTEGER) the number of values returned in IAI and IAG. NAI equals the number of groups of edges that you put in the area map. so it's lowkey just counting your groups back to you.
• ICF — (an input expression of type INTEGER) a flag you set nonzero to say that the definition of the user coordinate system has been changed since the last call to ARGTAI. in that case, calls to GETSET must be executed by ARGTAI. if you set the flag to zero, Areas assumes the info it retrieved previously is still correct and skips the calls to GETSET. and bestie, this option is valuable if you're planning to make thousands of calls to ARGTAI with the same area map: do the first one with ICF = 1 and the rest with ICF = 0. that's the whole trick. main character efficiency. 👑

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same vibes, different language, we love a consistent queen. 💜

---

🍓 EXAMPLES 🍓

use the ncargex command to see the following relevant examples: carfill, carline, carmap, cbex01, tareas, fsppoint.

go look at them. seriously. they ate. 🔥

---

⭐ ACCESS ⭐

to use ARGTAI or c_argtai, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. (in that order!! don't freestyle it. 😭)

---

🦋 MESSAGES 🦋

see the areas man page for a description of all Areas error messages and/or informational messages. if something goes sideways, that's where the receipts live.

---

💫 SEE ALSO 💫

Online: areas, areas_params, ardbpa, ardrln, aredam, argeti, argetr, arinam, armvam, arpram, arscam, arseti, arsetr, 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.

---

and that's the whole page bestie 🎀 this one shipped as part of UNIX, dated March 1993 — vintage but still slaying fr fr. mwah 💖✨