Providing software solutions since 1976
| TEMPLATE Procedure: Plot Statements (Experimental) |
HISTO Statement
Displays a univariate histogram computed from input data, and typically is used to add a histogram to a density plot.
| HISTO numeric-column | expression < / option(s)> ; |
| Usage Information |
Density Histogram
![[Density Histogram]](./images/density.gif)
| Interaction: |
The default bin width is computed by using the number of observations and the range of the data. When a curve is overlaid on the histogram, the histogram bin width is used to scale the curve so that the area under the curve is equal to the area of the histogram. |
| Required Arguments |
- numeric-column
-
specifies a column variable that contains double-precision values, or a dynamic variable that refers to such a column variable.
- expression
-
specifies a selective, relational, or logical program structure that calculates values when those values are not stored in the data.
| Options |
| Option | Description |
|---|---|
| BACKGROUND= color | style-reference | Specifies the background color of the graph. |
| BACKTRANSPARENCY= number | Specifies the degree of the transparency of the background color. |
| BINSTART==number | Specifies the X coordinate of the first bin. |
| BINWIDTH= number | Specifies the bin width. |
| BOUNDARY= LOWER | UPPER | Specifies the location of the boundary values. |
| DATATRANSPARENCY= number | Specifies the degree of the transparency of the bars. |
| ENDLABELS= boolean | Specifies whether labels are drawn at the endpoints of the bins. |
| FILL=boolean | Specifies whether the interiors of the bars are filled. |
| FILLCOLOR= color | style-reference | Specifies the color of the interior fill of the bar. |
| FREQ= numeric-column | expression | Specifies the frequencies of the values of the column being analyzed. |
| NBINS= integer | Specifies the number of bins. |
| ORIENT= HORIZONTAL | VERTICAL | Specifies the orientation of the Y axis and the bars. |
| OUTLINECOLOR= color | style-reference | Specifies the color of the outlines around the bars. |
| SCALE= COUNT | PERCENT | PROPORTION | Specifies that the Y axis will display the frequency counts, or the percentages between 0 and 100, or the proportions between 0 and 1. |
| TRANSPARENCY= number | Specifies the degree of the transparency of the bars and background, if displayed in a graph. |
| XAXIS= X | X2 | Specifies whether data is mapped to the primary X axis or the secondary X (X2) axis. |
| XVALUES= LEFTPOINTS | MIDPOINTS | RIGHTPOINTS | Specifies whether the X values represent lower endpoints, midpoints, or upper endpoints of the bins. |
| YAXIS= Y | Y2 | Specifies whether data is mapped to the primary Y axis or the secondary Y (Y2) axis. |
- BACKGROUND= color | style-reference
-
specifies the background color of the graph.
Default: Specified by the GraphBackground:Background style reference. Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. - BACKTRANSPARENCY= number
-
specifies the degree of the transparency of the background color.
Default: 0 Range: 0 (opaque) to 1 (entirely transparent) Interaction: The BACKTRANSPARENCY= option overrides the TRANSPARENCY= option for the background. Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. See also: TRANSPARENCY= option - BINSTART=number
-
specifies the X coordinate of the first bin.
Default: Determined by the system. Restriction: Use the BINSTART= option with the BINWIDTH= and NBINS= options. See also: XVALUES option - BINWIDTH=number
-
specifies the bin width.
Default: Determined by the system. Restriction: Use the BINWIDTH= option with the BINSTART= and NBINS= options. - BOUNDARY= LOWER | UPPER
-
specifies the location of the boundary values.
specifies how a boundary is counted when it lies on the endpoint of a bin. If BOUNDARY=UPPER, then the value is counted as one of the values in the upper bin (the bin to the right); otherwise, it is counted in the lower bin.
Default: UPPER - DATATRANSPARENCY= number
-
specifies the degree of the transparency of the bars.
Default: 0 Range: 0 (opaque) to 1 (entirely transparent) Interaction: The DATATRANSPARENCY= option overrides the TRANSPARENCY= option for the bars. See also: TRANSPARENCY= option - ENDLABELS= boolean
-
specifies whether the labels are drawn at the endpoints of the bins.
Default: FALSE. Interaction: If the TICKS= sub-option is specified in the XAXISOPTS= option, then the ENDLABELS= option is overridden. Interaction: If ENDLABELS=FALSE, then the labels are drawn at the midpoints, whether the XVALUES= option identifies the X data as endpoint values or midpoint values. - FILL= boolean
-
specifies whether the interiors of the bars are filled.
Default: TRUE - FILLCOLOR= color | style-reference
-
specifies the color of the interior fill of the bar.
Default: Specified by the GraphDataDefault:Foreground style reference. - FREQ= numeric-column | expression
-
specifies the frequencies of the values of the column being analyzed.
Default: Each observation has a frequency of 1. - NBINS= integer
-
specifies the number of bins.
Default: Determined by the system. Restriction: Use the NBINS= option with the BINSTART= option and the BINWIDTH= option. - ORIENT= HORIZONTAL | VERTICAL
-
specifies the orientation of the Y axis and the bars.
Default: VERTICAL - OUTLINECOLOR= color | style-reference
-
specifies the color of the outlines around the bars.
Default: Specified by the GraphOutlines:Foreground style reference. - SCALE= COUNT | PERCENT | PROPORTION
-
specifies that the Y axis will display the frequency counts, or the percentages between 0 and 100, or the proportions between 0 and 1.
Default: COUNT - TRANSPARENCY=number
-
specifies the degree of the transparency of the bars and background, if displayed in a graph.
Default: 0 Range: 0 (opaque) to 1 (entirely transparent) Interaction: You can specify the transparency of individual graph elements by using the BACKTRANSPARENCY= and DATATRANSPARENCY= options. The value specified by the TRANSPARENCY= option is only applied to the transparencies that you do not specify individually. Interaction: In a LAYOUT OVERLAY block, the TRANSPARENCY= option only affects the bars. The LAYOUT OVERLAY statement specifies the transparency of the background of the graph. - XAXIS= X | X2
-
specifies whether data is mapped to the primary X axis or to the secondary X (X2) axis.
Default: X Interaction: Within a LAYOUT OVERLAY block, multiple plots can share a primary axis and a secondary axis. The primary and secondary axes can have different scales, and the XAXIS= option for a particular plot can map data to either axis. The XAXISOPTS= and X2AXISOPTS= options of a LAYOUT OVERLAY statement specify whether the axes are displayed, and specify the axis characteristics. - XVALUES= LEFTPOINTS | MIDPOINTS | RIGHTPOINTS
-
specifies whether the X values represent lower endpoints, midpoints, or upper endpoints of the bins.
Default: MIDPOINTS - YAXIS= Y | Y2
-
specifies whether data is mapped to the primary Y axis or to the secondary Y (Y2) axis.
Default: Y Interaction: Within a LAYOUT OVERLAY block, multiple plots can share a primary axis and a secondary axis. The primary and secondary axes can have different scales, and the YAXIS= option for a particular plot can map data to either axis. The YAXISOPTS= and Y2AXISOPTS= options of a LAYOUT OVERLAY statement specify whether the axes are displayed, and specify the axis characteristics.
