AGUTOL(3NCARG)

✨ AGUTOL ✨ — the NCAR Graphics page, but make it a group chat 💅

okay so bestie, this is AGUTOL, straight out of the NCAR Graphics manual (the 3NCARG section, iykyk). It's a little subroutine with main character energy: it lets you change the user-system-to-label-system mapping for one or more of the four axes. Slay.

---

🌸 SYNOPSIS 🌸

SUBROUTINE AGUTOL (IAXS,FUNS,IDMA,VINP,VOTP)

---

🎀 DESCRIPTION 🎀

okay so here's the whole cast, one by one 🫶

• IAXS — an input expression of type INTEGER. It's literally just the number of the axis. The values 1, 2, 3, and 4 imply the left, right, bottom, and top axes, respectively. Four axes, four numbers, no notes 💅
• FUNS — an input expression of type REAL. This is the value of 'AXIS/s/FUNCTION.', which may be used to select the desired mapping function for the axis IAXS. The recommendation? Just use the default value (zero) to specify the identity mapping, bestie. The value may be integral ("1.", "2.", etc.) and serve purely to select the code to be executed, or it may be the value of an actual parameter in the equations defining the mapping. Either way, it's giving flexible ✨
• IDMA — an input expression of type INTEGER. This one specifies the direction of the mapping. A value greater than zero indicates that VINP is a value in the user system and that VOTP is to be a value in the label system. A value less than zero means the opposite. And like — important — the mappings in one direction must be the mathematical inverses of the mappings in the other direction. no cap, that's a requirement 😭
• VINP — an input expression of type REAL. It's an input value in one coordinate system. Just a lil value, vibing.
• VOTP — an output variable of type REAL. It's an output value in the other coordinate system. The counterpart, the duo, the ship 🫶

---

🌈 USAGE 🌈

So here's the tea: this routine is not called by the user program, but by Autograph itself. It defines the user-system-to-label-system mapping for all four axes.

The default version makes the label system match the user system on all four axes. Simple, iconic, no drama.

The user may supply his own version of this routine to change the mapping on one or more of the axes. But — and this is the vibe check — mappings defined by the subroutine must be continuous and monotonic. periodt.

⚠️ Note: a user version of AGUTOL should not call any other Autograph routine. not even one. not even a little one. 🙈

---

💖 ACCESS 💖

To use AGUTOL, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. Order matters bestie, don't fight it 🦋

---

⭐ SEE ALSO ⭐

Online: autograph, agback, agbnch, agchax, agchcu, agchil, agchnl, agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr, agpwrt, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup, anotat, displa, ezmxy, ezmy, ezxy, ezy

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

---

👑 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 was the NCAR Graphics AGUTOL(3NCARG) manual page, UNIX flavor, dated March 1993 — yes she's vintage, yes she still ate 🎀 bye babes ✨🌸