1HSTOPL(3NCARG)                   NCAR GRAPHICS                  HSTOPL(3NCARG)
2
3
4

NAME

6       HSTOPL - Turns options off and on for the Histogram utility.
7

SYNOPSIS

9       CALL HSTOPL (STRING)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_hstopl (char *string)
15

DESCRIPTION

17       STRING      Character, input -- Selects an internal parameter.  The
18                   possibilities are:
19
20                      ´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
33                   The following options are defined by this subroutine:
34
35                   HOR     The histogram bars are drawn horizontally if
36                           ´HOR=ON´, vertically if ´HOR=OFF´.  The default is
37                           ´HOR=OFF´.
38
39                   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
44                           This places a second axis on the opposite side of
45                           the frame from the normal frequency axis.
46
47                   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
53                   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
57                           Devices will vary as to how they interpret shading.
58
59                   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
66                   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
72                   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
79                   PMV     If ´PMV=ON´, missing value counts will be written
80                           on the plot.  If ´NMV=OFF´, they will not.
81
82                   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
86                   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
91                   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
96                   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

C-BINDING DESCRIPTION

101       The C-binding argument descriptions are the same as the FORTRAN
102       argument descriptions.
103

USAGE

105       HSTOPL is called to toggle histogram options before entry HISTGR is
106       called to generate the histogram.
107

EXAMPLES

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

ACCESS

114       To use HSTOPL or c_hstopl, load the NCAR Graphics libraries ncarg,
115       ncarg_gks, and ncarg_c, preferably in that order.
116

MESSAGES

118       See the histogram man page for a description of all Histogram error
119       messages and/or informational messages.
120

SEE ALSO

122       Online: histogram, histogram_params, histgr, hstopc, hstopi, hstopr,
123       ncarg_cbind
124
125       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.
131
132
133
134UNIX                              March 1993                    HSTOPL(3NCARG)
Impressum