GETSI(3NCARG)

✨ GETSI ✨ (from the NCAR Graphics manual, bestie 💖)

okay so we're in the NCAR Graphics corner of the man pages and this one is literally called GETSI — it's a Fortran routine and she's here to hand you back the exponents that define your plotting range in the plotter address unit coordinate system. iconic behavior honestly 🎀

---

🌸 NAME 🌸

GETSI — returns the exponents which define the plotting range in the plotter address unit coordinate system.

no cap, that's the whole job. she gives you numbers back. that's it. that's the gig 💅

---

💀 STATUS 💀

okay bestie sit down because this is the part where I have to be real with you:

Plotter Address Units (PAUs) are no longer used in NCAR Graphics; thus, GETSI is considered an obsolete routine. 💀

like. she's a legacy queen. we still love her but she is not the moment anymore.

the coordinate systems that are actually recognized right now are:

• GKS world coordinates
• GKS normalized device coordinates
• NCAR Graphics fractional coordinates
• NCAR Graphics user coordinates

if you want the full tea on those, go read the NCAR Graphics document "The Use of X/Y Coordinates in NCAR Graphics" — it describes all of them properly 🫶

GETSI continues to be provided for compatibility of early NCAR Graphics codes. so like, if you're maintaining ancient code, she's got you. if you're writing new code… why are you here bestie 😭

now, because we're nice, here's the definition of the PAU Coordinate System, included for the purpose of interpreting and converting PAU codes:

the plotter coordinates of a point are integers IPX and IPY, where IPX is between 1 and 2**MX and IPY is between 1 and 2**MY.

MX and MY are internal parameters of SPPS; each has the default value 10. 🌈

values of MX and MY can be set by routine SETI and retrieved by routine GETSI. so she's the retrieval half of the duo, iykyk 👑

---

✨ SYNOPSIS ✨

CALL GETSI (IX,IY)

that's it. two outputs. she's low maintenance fr fr 💖

---

🦋 DESCRIPTION 🦋

• IX — (an output variable of type INTEGER) is the X axis exponent for plotter coordinates defining a range of 1 to 2**IX - 1. IX has a default value of 10. ⭐
• IY — (an output variable of type INTEGER) is the Y axis exponent for plotter coordinates defining a range of 1 to 2**IY - 1. IY has a default value of 10. ⭐

so yeah, both of them just tell you how big your plotter coordinate range is on each axis, and both default to 10. twin defaults, twin slay 🌸

---

🎀 ACCESS 🎀

to use GETSI, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order 👑

like, the order matters. don't be chaotic about it. 💅

---

🔥 SEE ALSO 🔥

Online: spps, seti

Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

go read those if you want the full lore 📚✨

---

👑 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 came from the UNIX flavor of the manual, dated March 1993, filed under GETSI(3NCARG) — yes she's a 3NCARG girly, an OG, a legend, a retired icon who still shows up when the old code calls. we stan a backwards-compatible queen 🫶💖✨