EZHFTN(3NCARG)

💖 EZHFTN 💖 — the NCAR Graphics girlie's guide

okay bestie, welcome to EZHFTN from the NCARG manual, section 3. she's a little vintage, she's a little obsolete, but she still shows up and does her thing, and honestly? iconic.

---

✨ NAME ✨

EZHFTN — draws a half-tone picture from data stored in a rectangular array, with the intensity in the picture proportional to the data value. yes literally, the numbers in your array become the vibes of the picture. low number = low intensity, high number = high intensity. slay. 🎀

---

🧰 UTILITY 🧰

this routine is part of the Halftone utility in NCAR Graphics. if you wanna see the overview man page for this whole utility, you just type:

man halftone

and she will tell you everything. periodt. 💅

---

⚠️ STATUS ⚠️

okay so, real talk. EZHFTN is obsolete. she has been replaced by the CPCICA entry of the Conpack contouring package.

EZHFTN is still hanging around for compatibility with early NCAR Graphics codes — she's the friend who never left the group chat — but if you are writing new code, we suggest that you use CPCICA. fr fr. 🫶

---

📜 SYNOPSIS 📜

CALL EZHFTN (Z,M,N)

---

🌸 DESCRIPTION 🌸

• Z — an input array of type REAL, and it's the two-dimensional field you want half-tone plotted. this is the main character of the whole operation tbh. ✨
• M — an input parameter of type INTEGER, and it's the first dimension of the Z array.
• N — an input parameter of type INTEGER, and it's the second dimension of the Z array.

---

🎀 USAGE 🎀

so here's the tea: EZHFTN has a shortened argument list compared to the entry HAFTON. she gets away with it because she assumes all of these things are true:

1. the entire Z array is to be plotted. no skipping, no editing, the whole thing. 💯
2. the lowest value in Z will be at the lowest intensity of the output device.
3. the highest value in Z will be at the highest intensity of the output device.
4. other values in Z will appear linearly spaced. (evenly, bestie. evenly. 📏)
5. the maximum number of intensities will be used.
6. the picture will have a perimeter drawn.
7. the frame will be advanced after the picture is drawn.
8. the Z array contains no missing values. not one. zero. nada. 🙈

if these conditions are not met, use the HAFTON entry instead. do not come for EZHFTN with your missing values, she will simply not understand. 😭

---

🔑 ACCESS 🔑

to use EZHFTN, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. the order matters, bestie, don't freestyle it. 💅

---

👀 SEE ALSO 👀

Online: halftone, hafton, halftone_params, conpack, conpack_params, cpcica

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

---

©️ 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 manual, dated March 1993, and yes she is still out here serving EZHFTN(3NCARG) realness all these years later. drink some water, load your libraries in the right order, and go plot something gorgeous. mwah. 💜🦋🌸