HSTOPL(3NCARG)

💖 HSTOPL — bestie edition 💖

NCAR Graphics · the little toggle switch for your histograms 🎀

---

✨ NAME ✨

HSTOPL — turns options off and on for the Histogram utility. it's giving ✨control panel✨

---

🌸 SYNOPSIS 🌸

CALL HSTOPL (STRING)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_hstopl (char *string)

---

💅 DESCRIPTION 💅

STRING — Character, input. it picks which internal parameter you're flipping. your options are, and yes these are exact:

´HOR=ON´ or ´HOR=OFF´
´PER=ON´ or ´PER=OFF´
´MID=ON´ or ´MID=OFF´
´SHA=ON´ or ´SHA=OFF´
´DRL=ON´ or ´DRL=OFF´
´MED=ON´ or ´MED=OFF´
´NMV=ON´ or ´NMV=OFF´
´PMV=ON´ or ´PMV=OFF´
´PRM=ON´ or ´PRM=OFF´
´FRA=ON´ or ´FRA=OFF´
´LIS=ON´ or ´LIS=OFF´
´DEF=ON´ or ´DEF=OFF´

so here's the tea on what this subroutine actually defines for you 👇

• HOR — bars go horizontal if ´HOR=ON´, and vertical if ´HOR=OFF´. the default is ´HOR=OFF´.
• PER — if ´PER=ON´, a labeled percent axis gets drawn on the right side of the histogram (or on top if ´HOR=ON´). if ´PER=OFF´, no percent axis, nada. the default is ´PER=ON´.

this puts a whole second axis on the opposite side of the frame from the normal frequency axis. two axes, one frame, main character energy 👑

• MID — if ´MID=ON´, the class labels sit at the midpoint of each class interval. if ´MID=OFF´, you get the class interval end points labeled instead. (MID defaults to ON if IFLAG = 2 or 3.) the default is ´MID=ON´.
• SHA — if ´SHA=ON´, the histogram bars are shaded. if ´SHA=OFF´, they are not. the default is ´SHA=ON´.

lowkey a warning: devices will vary as to how they interpret shading. every device has its own vibe 💀

• DRL — if ´DRL=ON´, lines get drawn through the histogram bars right where Y-axis tick marks would occur. when you're comparing two datasets (IFLAG=3), lines are only drawn through the bars associated with the first dataset. if ´DRL=OFF´, no lines. the default is ´DRL=OFF´.
• MED — if ´MED=ON´, a line is drawn through the median value of all points. if ´MED=OFF´, that line stays un-drawn. heads up: MED does not apply when assigning Y-values to X-values; it's valid only for IFLAG = 1 or 2. the default is ´MED=OFF´.
• NMV — if ´NMV=ON´, histogram bar percentages get calculated with respect to the number of input data values (NPTS) minus the number of detected missing values (MISS), i.e. NMVA = NPTS - MISS. if ´NMV=OFF´, histogram bar percentages are normalized to NPTS instead.
• PMV — if ´PMV=ON´, missing value counts get written on the plot. if ´NMV=OFF´, they will not. 🫠 (yes bestie, that's exactly what it says, we don't make the rules)
• PRM — if ´PRM=ON´, a perimeter is drawn around the histogram. if ´PRM=OFF´, no perimeter. the default is ´PRM=OFF´.
• FRA — if ´FRA=ON´, the frame is advanced automatically after the histogram is drawn. if ´FRA=OFF´, the frame is not advanced and you have to call FRAME yourself. the default is ´FRA=ON´.
• LIS — if ´LIS=ON´, all the options along with their values are printed on the standard output. if ´LIS=OFF´, nothing is printed on the standard output. the default is ´LIS=OFF´.
• DEF — if ´DEF=ON´, ALL the options are reset to their default values. ´DEF=OFF´ has no effect. and fyi, all parameters begin at their default values anyway. it's giving factory reset ✨

---

💜 C-BINDING DESCRIPTION 💜

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. no notes, same thing, just C-flavored 💖

---

🌈 USAGE 🌈

HSTOPL is called to toggle histogram options before entry HISTGR is called to generate the histogram. order matters, bestie — set your vibes first, then draw. 🎀

---

⭐ EXAMPLES ⭐

• use the command "ncargex thstgr" to generate a three frame example of various types of histograms.
• "ncargex thstmv" will show three examples of histograms with missing values in the input data.

go run them, they're cute, fr fr 🦋

---

🔥 ACCESS 🔥

to use HSTOPL or c_hstopl, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. that order. don't fight it. periodt. 💅

---

👑 MESSAGES 👑

see the histogram man page for a description of all Histogram error messages and/or informational messages. iykyk 📖

---

🧚 SEE ALSO 🧚

Online: histogram, histogram_params, histgr, hstopc, hstopi, hstopr, ncarg_cbind

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.

---

ok that's the whole page, no skips, no summaries, every flag accounted for 💖 now go toggle something and slay ✨

NCAR Graphics · HSTOPL(3NCARG) · UNIX · March 1993 — mwah, that's a wrap 🎀🫶