Providing software solutions since 1976
| TEMPLATE Procedure: Plot Statements (Experimental) |
HISTOGRAMPARM Statement
Displays a univariate histogram for specified values of bin midpoints and bin frequencies, and typically is used to create a histogram.
| HISTOGRAMPARM Y= numeric-column | expression X= numeric-column | expression < / option(s)> ; |
| Usage Information |
Density Histogram
![[Density Histogram]](./images/density.gif)
| Required Arguments |
- X
-
specifies the column for the X values.
Requirement: The values must not be negative. - Y
-
specifies the column for the Y values.
Requirement: The values must be uniformly spaced.
| 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. |
| 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 bar interiors are filled. |
| FILLCOLOR=color | style-reference | Specifies the color of the interiors of the bars. |
| GRIDTRANSPARENCY= number | Specifies the degree of the transparency of the grid lines. |
| ORIENT= HORIZONTAL | VERTICAL | Specifies the orientation of the Y axis and the bars. |
| OUTLINECOLOR=color | style-reference | Specifies the color of the bar outlines. |
| TRANSPARENCY= number | Specifies the degree of the transparency of the bars, background, grid, wall, and axis features, if displayed in a graph. |
| WALLTRANSPARENCY= number | Specifies the degree of the transparency of the plot wall. |
| XAXIS= X | X2 | Specifies whether data is mapped to the primary X axis or to the secondary X (X2) axis. |
| XAXISOPTS= ( axis-options ) | Specifies one or more X axis options. |
| XGRID= boolean | Specifies whether grid lines are drawn at the tick marks. |
| XOFFSETMAX= number | Specifies an offset to add to the end that represents high data values on the primary X axis. |
| 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 that the bin values that are provided by the X= column are interpreted as lower endpoints, midpoints, or upper endpoints of the bins. |
| YAXIS= Y | Y2 | Specifies whether data is mapped to the primary Y axis or to the secondary Y (Y2) axis. |
| YAXISOPTS= ( axis-options ) | Specifies one or more Y axis options. |
| YGRID= boolean | Specifies whether grid lines 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 add 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 - 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 labels are drawn at the endpoints of the bins.
Default: FALSE Interaction: If XAXISOPTS= (TICKS=), 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 bar interiors are filled.
Default: TRUE. - FILLCOLOR= color | style-reference
-
specifies the color of the interiors of the bars.
Default: Specified by the GraphDataDefault:Foreground style reference. - 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 - ORIENT= HORIZONTAL | VERTICAL
-
specifies the orientation of the Y axis and the bars.
Default: VERTICAL - OUTLINECOLOR= color | style-reference
-
specifies the color of the bar outlines.
Default: Specified by the GraphOutlines:Foreground style reference. - TRANSPARENCY= number
-
specifies the degree of the transparency of the bars, background, grid, wall, and axis features, 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=, 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 that the bin values that are provided by the X= column are interpreted as lower endpoints, midpoints, or upper endpoints of the bins.
Default: MIDPOINTS Interaction: The ENDLABELS= option overrides the XVALUES= option. See also: ENDLABELS= - 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.
