1HSTOPL(3NCARG) NCAR GRAPHICS HSTOPL(3NCARG)
2
6 HSTOPL - Turns options off and on for the Histogram utility.
7
9 CALL HSTOPL (STRING)
10
12 #include <ncarg/ncargC.h>
13 void c_hstopl (char *string)
15
17 STRING Character, input -- Selects an internal parameter. The
18 possibilities are:
19 ´HOR=ON´ or ´HOR=OFF´
21 ´PER=ON´ or ´PER=OFF´
22 ´MID=ON´ or ´MID=OFF´
23 ´SHA=ON´ or ´SHA=OFF´
24 ´DRL=ON´ or ´DRL=OFF´
25 ´MED=ON´ or ´MED=OFF´
26 ´NMV=ON´ or ´NMV=OFF´
27 ´PMV=ON´ or ´PMV=OFF´
28 ´PRM=ON´ or ´PRM=OFF´
29 ´FRA=ON´ or ´FRA=OFF´
30 ´LIS=ON´ or ´LIS=OFF´
31 ´DEF=ON´ or ´DEF=OFF´
32 The following options are defined by this subroutine:
34 HOR The histogram bars are drawn horizontally if
36 ´HOR=ON´, vertically if ´HOR=OFF´. The default is
37 ´HOR=OFF´.
38 PER If ´PER=ON´, a labeled percent axis is drawn on the
40 right side of the histogram (top if ´HOR=ON´.) If
41 ´PER=OFF´, no percent axis is drawn. The default
42 is ´PER=ON´.
43 This places a second axis on the opposite side of
45 the frame from the normal frequency axis.
46 MID If ´MID=ON´, class labels are placed at the
48 midpoint of each class interval. If ´MID=OFF´, the
49 class interval end points are labeled. (MID
50 defaults to ON if IFLAG = 2 or 3.) The default is
51 ´MID=ON´.
52 SHA If ´SHA=ON´, the histogram bars are shaded. If
54 ´SHA=OFF´, the bars are not shaded. The default is
55 ´SHA=ON´.
56 Devices will vary as to how they interpret shading.
58 DRL If ´DRL=ON´, lines are drawn through the histogram
60 bars where Y-axis tick marks would occur. When
61 comparing two datasets (IFLAG=3), lines are only
62 drawn through the bars associated with the first
63 dataset. If ´DRL=OFF´, no lines are drawn. The
64 default is ´DRL=OFF´.
65 MED If ´MED=ON´, a line is drawn through the median
67 value of all points. If ´MED=OFF´, this line is not
68 drawn. MED does not apply when assigning Y-values
69 to X-values; it is valid only for IFLAG = 1 or 2.
70 The default is ´MED=OFF´.
71 NMV If ´NMV=ON´, histogram bar percentages will be
73 calculated with respect to the number of input data
74 values (NPTS) minus the number of detected missing
75 values (MISS), or NMVA = NPTS - MISS. If
76 ´NMV=OFF´, histogram bar percentages will be
77 normalized to NPTS.
78 PMV If ´PMV=ON´, missing value counts will be written
80 on the plot. If ´NMV=OFF´, they will not.
81 PRM If ´PRM=ON´, a perimeter is drawn around the
83 histogram. If ´PRM=OFF´, no perimeter is drawn.
84 The default is ´PRM=OFF´.
85 FRA If ´FRA=ON´, the frame is advanced automatically
87 after the histogram is drawn. If ´FRA=OFF´, the
88 frame is not advanced, and the user must call
89 FRAME. The default is ´FRA=ON´.
90 LIS If ´LIS=ON´, all the options along with their
92 values are printed on the standard output. If
93 ´LIS=OFF´, nothing is printed on the standard
94 output. The default is ´LIS=OFF´.
95 DEF If ´DEF=ON´, ALL the options are reset to their
97 default values. ´DEF=OFF´ has no effect. All
98 parameters begin at their default values.
99
101 The C-binding argument descriptions are the same as the FORTRAN
102 argument descriptions.
103
105 HSTOPL is called to toggle histogram options before entry HISTGR is
106 called to generate the histogram.
107
109 Use the command "ncargex thstgr" to generate a three frame example of
110 various types of histograms. "ncargex thstmv" will show three examples
111 of histograms with missing values in the input data.
112
114 To use HSTOPL or c_hstopl, load the NCAR Graphics libraries ncarg,
115 ncarg_gks, and ncarg_c, preferably in that order.
116
118 See the histogram man page for a description of all Histogram error
119 messages and/or informational messages.
120
122 Online: histogram, histogram_params, histgr, hstopc, hstopi, hstopr,
123 ncarg_cbind
124 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
126
128 Copyright (C) 1987-2009
129 University Corporation for Atmospheric Research
130 The use of this Software is governed by a License Agreement.
131UNIX March 1993 HSTOPL(3NCARG)