Providing software solutions since 1976
| TEMPLATE Procedure: Plot Statements (Experimental) |
HISTOGRAM Statement
Displays a univariate histogram computed from input data, and typically is used to create a histogram.
| HISTOGRAM numeric-column | expression < / option(s)> ; |
| Usage Information |
Denisty Histogram
![[Denisty 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. |
| GRIDTRANSPARENCY= number | Specifies the degree of the transparency of the grid lines. |
| 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, background, grid, wall, and axis features, if they are displayed in a graph. |
| WALLTRANSPARENCY= number | Specifies the degree of the transparency of one or more plot walls. |
| XAXIS= X | X2 | Specifies whether data is mapped to the primary X axis or the secondary X (X2) axis. |
| XAXISOPTS= axis-options | Specifies one or more X axis options. |
| XGRID= boolean | Specifies whether the grid lines are drawn at the tick marks. |
| XOFFSETMAX= number | Specifies an offset to add to the end of the primary X axis that represents high data values. |
| XOFFSETMIN= number | Specifies an offset to add to the end that represents low data values on the primary X 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. |
| YAXISOPTS= axis-options | Specifies one or more Y axis options. |
| YGRID= boolean | Specifies whether grid lines are drawn at the tick marks. |
| YOFFSETMAX= number | Specifies an offset to add to the end that represents high data values on the primary Y axis. |
| YOFFSETMIN= number | Specifies an offset to the end that represents low data values on the primary Y 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. - GRIDTRANSPARENCY= number
-
specifies the degree of the transparency of the grid lines.
Default: 0 Range: 0 (opaque) to 1 (entirely transparent) Interaction: The GRIDTRANSPARENCY= option overrides the TRANSPARENCY= option for the grid lines. Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. See also: TRANSPARENCY= option - 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, background, grid, wall, and axis features, if they are 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=, DATATRANSPARENCY=, GRIDTRANSPARENCY=, and WALLTRANSPARENCY= 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, grid, and wall of the graph. - WALLTRANSPARENCY= number
-
specifies the degree of the transparency of the plot wall.
Default: 0 Range: 0 (opaque) to 1 (entirely transparent) Interaction: The WALLTRANSPARENCY= option overrides the TRANSPARENCY= option for the graph wall. Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. See also: TRANSPARENCY= option - XAXIS= X | X2
-
specifies whether data is mapped to the primary X axis or to the secondary X (X2) axis.
Default: X Interaction: Outside of a LAYOUT OVERLAY block, an individual plot can have only one X axis. The XAXIS= option of a plot specifies whether the axis is in the primary (bottom) or secondary (top) position. The XAXISOPTS= option of a plot specifies whether the axis is displayed and specifies the axis characteristics. 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.
- XAXISOPTS= ( axis-options )
-
specifies one or more X axis options.
Requirement: The list of axis options must be enclosed in parentheses and separated by spaces. Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. - XGRID= boolean
-
specifies whether the grid lines are drawn at the tick marks.
Default: FALSE Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. Interaction: If you specify or use the default XGRID= option for the OVERLAY LAYOUT statement, then the XGRID= option specified for a graph is ignored. Default characteristics for the grid lines are specified from the following attributes on the GraphGridLines style element: Color Foreground
Thickness LineThickness (default=1 px)
Pattern LineStyle (default=1)
- XOFFSETMAX= number
-
specifies an offset to add to the end that represents high data values on the primary X axis. The offset is expressed as a decimal proportion of the full axis length. For a continuous axis, the offset is added to the highest data value or highest tick value, whichever is greater. For a discreet axis, the offset is added to the highest data value, which is always the highest tick value.
Default: Generated as suitable for the graph. Range: 0 - 1 Interaction: For a continuous axis, the offset is added after any threshold adjustment is made to the axis. Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. Main discussion: THRESHOLDMAX= sub-option. - XOFFSETMIN= number
-
specifies an offset to add to the end that represents low data values on the primary X axis. The offset is expressed as a decimal proportion of the full axis length. For a continuous axis, the offset is added to the lowest data value or lowest tick value, whichever is less. For a discreet axis, the offset is added to the lowest data value, which is always the lowest tick value.
Default: Generated as suitable for the graph. Range: 0 - 1 Interaction: For a continuous axis, the offset is added after any threshold adjustment is made to the axis. Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. Main discussion: THRESHOLDMAX= sub-option. - 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: Outside of a LAYOUT OVERLAY block, an individual plot can have only one Y axis. The YAXIS= option of a plot specifies whether the axis is in the primary (left) or secondary (right) position. The YAXISOPTS= option of a plot specifies whether the axis is displayed and specifies the axis characteristics. 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.
- YAXISOPTS= ( axis-options )
-
specifies one or more Y axis options.
Requirement: The list of axis options must be enclosed in parentheses and separated by spaces. Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. - YGRID= boolean
-
specifies whether grid lines are drawn at the tick marks.
Default: FALSE Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. Interaction: If you specify or use the default YGRID= option for the OVERLAY LAYOUT statement, then the YGRID= option specified for a graph is ignored. Default characteristics for the grid lines are specified from the following attributes on the GraphGridLines style element: Color Foreground
Thickness LineThickness (default=1 px)
Pattern LineStyle (default=1)
- YOFFSETMAX= number
-
specifies an offset to add to the end that represents high data values on the primary Y axis. The offset is expressed as a decimal proportion of the full axis length. For a continuous axis, the offset is added to the highest data value or highest tick value, whichever is greater. For a discreet axis, the offset is added to the highest data value, which is always the highest tick value.
Default: Generated as suitable for the graph. Range: 0 - 1 Interaction: For a continuous axis, the offset is added after any threshold adjustment is made to the axis. Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. Main discussion: THRESHOLDMAX= sub-option. - YOFFSETMIN= number
-
specifies an offset to add to the end that represents low data values on the primary Y axis. The offset is expressed as a decimal proportion of the full axis length. For a continuous axis, the offset is added to the lowest data value or lowest tick value, whichever is less. For a discreet axis, the offset is added to the lowest data value, which is always the lowest tick value.
Default: Generated as suitable for the graph. Range: 0-1 Interaction: For a continuous axis, the offset is added after any threshold adjustment is made to the axis. Interaction: Ignored in a LAYOUT OVERLAY block. For information, see Ignored Plot Options in a LAYOUT OVERLAY Block. Main discussion: THRESHOLDMAX= sub-option.
