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

NAME

6       Histogram_params - This document briefly describes all histogram
7       internal parameters.  The Histogram utility has four parameter setting
8       routines: HSTOPC sets parameters of type CHARACTER; HSTOPI sets
9       parameters of type INTEGER; HSTOPL sets parameters of type LOGICAL;
10       HSTOPR sets parameters of type REAL.
11

DESCRIPTION

13       Parameters of type CHARACTER set in calls to entry HSTOPC:
14
15       FOR         Format for class labels.  Default is ´(G10.3)´.
16
17       TIT         A main title of up to 96 characters.  Only 45 characters
18                   are written per line so up to 3 lines may be written.  The
19                   default is no title.
20
21       LAB         A label for the class interval (histogram bar) axis.
22                   Default value is ´CLASS INTERVALS´ when the HSTOPL option
23                   ´MID=OFF´ is selected, and ´CLASS MIDVALUES´ when ´MID=ON´.
24
25       PTI         The percent axis label.  Default value when ´PTI=OFF´ is
26                   ´PERCENT OCCURRENCE´ when IFLAG = 0, or 1, and ´PERCENT of
27                   MAXIMUM´ when IFLAG = 2, or 3.
28
29       FQN         The frequency axis label.  Default value is ´FREQUENCY´.
30
31       CHR         A concatenated string of class interval labels.  Default is
32                   that class labels will be internally computed numeric
33                   values (real or integer.)
34

Parameters of type INTEGER set in calls to entry HSTOPI:

36       COL         Eight components of the graphic can be assigned colors.
37                   Default is that all components of the graphic are assigned
38                   the color white (background color black.)
39
40       CLA         Allows the size and orientation of class labels to be
41                   altered.  Defaults are medium sized characters with a
42                   horizontal alignment.
43

Parameters of type LOGICAL set in calls to entry HSTOPL:

45       HOR         Defines whether histogram bars will be draw horizontally or
46                   vertically.  Default is vertical bars.
47
48       PER         Determines whether a percentage axis is drawn as a second
49                   axis on the opposite side of the frame from the normal
50                   frequency axis.  Default is a second axis.
51
52       MID         Determines if class labels are placed at the midpoint of
53                   each class interval, or if the class interval end points
54                   are labeled.  Default is labels at the midpoints.
55
56       SHA         Determines whether histogram bars are to be shaded.
57                   Default is shaded bars.
58
59                   Devices will vary as to how they interpret shading.
60
61       DRL         Determines if lines are to be drawn through the histogram
62                   bars where Y-axis tick marks would occur.  Default is no
63                   line.
64
65       MED         Determines if a line is drawn through the median value of
66                   all points.  Default is no median line.
67
68       NMV         Determines if missing values are to be subtracted from the
69                   number of input points before bin percentages are computed.
70                   The default is to subtract out the missing values.  HSTOPR
71                   option MVA must be ON to activate this option.
72
73       PMV         Determines if the number of input points and the number of
74                   missing values are to be printed on the plot.  The default
75                   is to not print.  HSTOPR option MVA must be ON to activate
76                   this option.
77
78       PRM         Determines if a perimeter is to be drawn around the
79                   histogram.  Default is no perimeter.
80
81       FRA         Determines whether the frame is advanced after the
82                   histogram is drawn.  Default is a frame advance.
83
84       LIS         Determines if all the options along with their values are
85                   to be printed on the standard output.  Default is no
86                   printed output.
87
88       DEF         A global default switch which allows all parameters to be
89                   returned to their default states in one call.  All
90                   parameters begin at their default values.
91

Parameters of type REAL set in calls to entry HSTOPR:

93       WIN         Defines a rectangular region of the total frame in NDC´s
94                   where the current histogram is to be plotted.  For example,
95                   XMIN=0., XMAX=.5, YMIN=.5, and YMAX=1.  would specify the
96                   upper left quadrant of the frame.  Default is the total
97                   frame is used.
98
99       SPA         Defines the amount of spacing between histogram bars and
100                   and the amount of overlap of histogram bars.  Default
101                   values: spacing = 2.0, overlap = -1.0 This will yield
102                   spacing between bars on a single histogram and overlap of
103                   bars in the comparison of two histograms.
104
105       MVA         Defines a special value which can be inserted in the data
106                   stream to indicate that the true data value is missing, and
107                   a testing tolerance which allows the special values to be
108                   detected.  See also parameters PMV, and NMV.  Default
109                   values: special value = -9999., tolerance = 1.E-10.
110

SEE ALSO

112       Online: histogram, histgr, hstopc, hstopi, hstopl, hstopr, ncarg_cbind
113
114       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
115
117       Copyright (C) 1987-2007
118       University Corporation for Atmospheric Research
119
120       This documentation is free software; you can redistribute it and/or
121       modify it under the terms of the GNU General Public License as
122       published by the Free Software Foundation; either version 2 of the
123       License, or (at your option) any later version.
124
125       This software is distributed in the hope that it will be useful, but
126       WITHOUT ANY WARRANTY; without even the implied warranty of
127       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
128       General Public License for more details.
129
130       You should have received a copy of the GNU General Public License along
131       with this software; if not, write to the Free Software Foundation,
132       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
133
134
135
136
137UNIX                              March 1993          Histogram_params(3NCARG)
Impressum