PERIML(3NCARG)

💖 PERIML — it's giving labeled perimeter, bestie 💖

Okay so this page is from the NCAR Graphics manual, section 3NCARG, and it's all about PERIML. Buckle up, this one's short but she's iconic.

---

✨ NAME ✨

PERIML — draws a labeled perimeter with inward-pointing tick marks. And like… the directions and lengths of those tick marks? You can change them, but not here — you do that by calling TICKS and/or TICK4. So PERIML is the main character and TICKS/TICK4 are the stylists. 💅

---

✨ SYNOPSIS ✨

CALL PERIML (MJRX,MNRX,MJRY,MNRY)

That's it. Four args. Slay.

---

🌈 C-BINDING SYNOPSIS 🌈

For the C girlies 🫶

#include <ncarg/ncargC.h>

void c_periml (int mjrx, int mnrx, int mjry, int mnry)

---

🎀 DESCRIPTION 🎀

So the parameters are MJRX, MNRX, MJRY, and MNRY — and they're all input expressions of type INTEGER. They specify the major and minor divisions of the horizontal (X) and vertical (Y) axes of the current viewport. But here's the tea: what they actually mean depends on whatever the internal parameter ´LS´ of SPPS is set to right now. Two whole vibes:

• If the value of ´LS´ implies that the axis is linear: MJRX(Y) specifies the number of major divisions of the X(Y) axis, and MNRX(Y) specifies the number of minor divisions within each major division. In each case, the value specifies the number of spaces between grid lines or ticks rather than the number of lines or ticks. Including the ones at the ends of the axes, there is always one more major division line or mark than the number of major divisions specified by MJRX(Y). Similarly, there is always one less minor division line or tick per major division than the number of minor divisions per major division specified by MNRX(Y). Not me doing math on a Friday 😭 but okay we move.
• If the value of ´LS´ implies that the axis is logarithmic: Each major division point occurs at a value 10**MJRX(Y) times the previous point. For example, if the minimum X-axis value were 3., the maximum X-axis value 3000. and MJRX 1, then the major division points would be 3., 30., 300., and 3000. If MNRX(Y).LE.10, there are nine minor divisions within each major division. For example, between 3. and 30., there would be minor division points at 6., 9., 12., . . . 27. If MNRX(Y).GT.10., minor divisions are omitted. Periodt.

---

💜 C-BINDING DESCRIPTION 💜

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. Fr fr, identical. No notes. 💀

---

⭐ USAGE ⭐

The statement

CALL PERIML (MJRX,MNRX,MJRY,MNRY)

is equivalent to

CALL GRIDAL (MJRX,MNRX,MJRY,MNRY,1,1,5,0.,0.)

Like, it's the same thing. PERIML is just GRIDAL with a little outfit on. 👑

---

🌸 EXAMPLES 🌸

Use the ncargex command to see the following relevant example: tgrida. Go look at it, bestie, it's right there.

---

🦋 ACCESS 🦋

To use PERIML or c_periml, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. The order matters, okay? It's giving load-bearing. Don't skip steps. 🙈

---

🔥 SEE ALSO 🔥

Online: gridall, gridall_params, gacolr, gagetc, gageti, gagetr, gasetc, gaseti, gasetr, grid, gridal, gridl, halfax, labmod, perim, tick4, ticks, ncarg_cbind.

Hardcopy: NCAR Graphics Fundamentals, UNIX Version. Yes, a physical book. Vintage. Antique even. 📚

---

💖 COPYRIGHT 💖

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement. (Read it, bestie, it's not a vibe check you can skip. 🫶)

---

Okay so basically: call PERIML, get a labeled perimeter with tick marks pointing inward, and remember that ´LS´ is the one running the whole situation. 💅

Mwah — this was the UNIX flavor of the page, dated March 1993, filed under PERIML(3NCARG). No cap. 🌈✨