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-2007
129 University Corporation for Atmospheric Research
130 This documentation is free software; you can redistribute it and/or
132 modify it under the terms of the GNU General Public License as
133 published by the Free Software Foundation; either version 2 of the
134 License, or (at your option) any later version.
135 This software is distributed in the hope that it will be useful, but
137 WITHOUT ANY WARRANTY; without even the implied warranty of
138 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
139 General Public License for more details.
140 You should have received a copy of the GNU General Public License along
142 with this software; if not, write to the Free Software Foundation,
143 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
144UNIX March 1993 HSTOPL(3NCARG)