Histogram_params(3NCARG)

📦 version 6.6.2, in epel 9, fedora 43, fedora 44

💫 Histogram_params — NCAR GRAPHICS, bestie edition 💫

okay so this is the tea on Histogram_params from the NCAR Graphics manual (that's the 3NCARG section, iykyk). It's a lil reference doc that spills every single internal parameter of the Histogram utility. And listen — there are four parameter-setting routines you gotta know about, one per type:

  • HSTOPC — sets parameters of type CHARACTER 🎀
  • HSTOPI — sets parameters of type INTEGER 🔢
  • HSTOPL — sets parameters of type LOGICAL ✅
  • HSTOPR — sets parameters of type REAL 💧

Periodt. Now let's get into it.

✨ DESCRIPTION ✨

💖 Parameters of type CHARACTER — set in calls to entry HSTOPC

  • FOR — the format for class labels. Default is '(G10.3)'. 💅
  • TIT — a main title, up to 96 characters. Only 45 characters get written per line, so you can get up to 3 lines out of it. Default? No title. 🙈
  • LAB — a label for the class interval (that's the histogram bar) axis. Default value is 'CLASS INTERVALS' when the HSTOPL option MID=OFF is selected, and 'CLASS MIDVALUES' when MID=ON. 🏷️
  • PTI — the percent axis label. Default value when PTI=OFF is 'PERCENT OCCURRENCE' when IFLAG = 0, or 1, and 'PERCENT of MAXIMUM' when IFLAG = 2, or 3. 📊
  • FQN — the frequency axis label. Default value is 'FREQUENCY'. 🔥
  • CHR — a concatenated string of class interval labels. Default is that class labels will be internally computed numeric values (real or integer). ✨

🔢 Parameters of type INTEGER — set in calls to entry HSTOPI

  • COL — eight components of the graphic can be assigned colors. Default is that all components of the graphic are assigned the color white (background color black). 🌈
  • CLA — lets you alter the size and orientation of class labels. Defaults are medium sized characters with a horizontal alignment. 👑

✅ Parameters of type LOGICAL — set in calls to entry HSTOPL

  • HOR — defines whether histogram bars will be draw horizontally or vertically. Default is vertical bars. 📏
  • PER — determines whether a percentage axis is drawn as a second axis on the opposite side of the frame from the normal frequency axis. Default is a second axis. 🪞
  • MID — determines if class labels are placed at the midpoint of each class interval, or if the class interval end points are labeled. Default is labels at the midpoints. 🎯
  • SHA — determines whether histogram bars are to be shaded. Default is shaded bars. 🎨
Devices will vary as to how they interpret shading. 💀
  • DRL — determines if lines are to be drawn through the histogram bars where Y-axis tick marks would occur. Default is no line. 📐
  • MED — determines if a line is drawn through the median value of all points. Default is no median line. ➗
  • NMV — determines if missing values are to be subtracted from the number of input points before bin percentages are computed. The default is to subtract out the missing values. HSTOPR option MVA must be ON to activate this option. 🚫
  • PMV — determines if the number of input points and the number of missing values are to be printed on the plot. The default is to not print. HSTOPR option MVA must be ON to activate this option. 🖨️
  • PRM — determines if a perimeter is to be drawn around the histogram. Default is no perimeter. 🔲
  • FRA — determines whether the frame is advanced after the histogram is drawn. Default is a frame advance. ⏭️
  • LIS — determines if all the options along with their values are to be printed on the standard output. Default is no printed output. 📜
  • DEF — a global default switch which allows all parameters to be returned to their default states in one call. All parameters begin at their default values. 🔄

💧 Parameters of type REAL — set in calls to entry HSTOPR

  • WIN — defines a rectangular region of the total frame in NDC's where the current histogram is to be plotted. For example, XMIN=0., XMAX=.5, YMIN=.5, and YMAX=1. would specify the upper left quadrant of the frame. Default is the total frame is used. 🪟
  • SPA — defines the amount of spacing between histogram bars and and the amount of overlap of histogram bars. Default values: spacing = 2.0, overlap = -1.0. This will yield spacing between bars on a single histogram and overlap of bars in the comparison of two histograms. 🫶
  • MVA — defines a special value which can be inserted in the data stream to indicate that the true data value is missing, and a testing tolerance which allows the special values to be detected. See also parameters PMV, and NMV. Default values: special value = -9999., tolerance = 1.E-10. 🔍

👀 SEE ALSO 👀

  • Online: histogram, histgr, hstopc, hstopi, hstopl, hstopr, ncarg_cbind
  • Hardcopy: NCAR Graphics Fundamentals, UNIX Version

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, no cap 💅✨ This iconic lil doc came out of the UNIX manual, March 1993 era, sourced straight from Histogram_params(3NCARG) — go forth and make beautiful histograms, you absolute main character 🦋🌸💖

📦 where this page comes from