The SGPLOT Procedure

HISTOGRAM Statement

Creates a histogram that displays the frequency distribution of a numeric variable.

Interaction:	The HISTOGRAM statement can be combined only with DENSITY statements in the SGPLOT procedure.
Note:	The range of the response variable is automatically divided into an appropriate number of bins.
Featured in:	Combining Histograms with Density Plots

Syntax

HISTOGRAM response-variable </ option(s)>;

option(s) can be one or more options from the following categories:

Histogram options:

BOUNDARY= LOWER | UPPER

FILL | NOFILL

FILLATTRS= style-element | (COLOR= color)

FREQ= numeric-variable

OUTLINE | NOOUTLINE

SCALE= COUNT | PERCENT | PROPORTION

SHOWBINS
Plot options:

LEGENDLABEL= "text-string"

NAME= "text-string"

TRANSPARENCY= numeric-value

X2AXIS

Y2AXIS

Required Arguments

response-variable: specifies the response variable for the histogram.

Options

BOUNDARY= LOWER | UPPER

specifies how boundary values are assigned to bins.

LOWER: specifies that boundary values are assigned to the lower bin.
UPPER: specifies that boundary values are assigned to the upper bin.

Default:

UPPER

FILL | NOFILL

specifies whether the area fill is visible. The FILL option shows the area fill. The NOFILL option hides the area fill.

Default:

The default status of the area fill is specified by the DisplayOpts attribute of the GraphHistogram style element in the current style.

FILLATTRS= style-element | (COLOR= color)

specifies the appearance of the area fill. You can specify the color of the fill by using a style element or by using the COLOR= suboption. For more information about specifying colors, see SAS/GRAPH Colors and Images in the SAS/GRAPH: Reference, Second Edition.

Note: This option has no effect if you specify the NOFILL option. [cautionend]

Default:

The default color is specified by the Color attribute of the GraphDataDefault style element in the current style.

FREQ= numeric-variable

specifies that each observation is repeated n times for computational purposes, where n is the value of the numeric variable. If n is not an integer, then it is truncated to an integer. If n is less than 1 or missing, then it is excluded from the analysis.

LEGENDLABEL= "text-string"

specifies a label that identifies the histogram in the legend. By default, the label of the response variable is used.

NAME= "text-string"

specifies a name for the plot. You can use the name to refer to this plot in other statements.

OUTLINE | NOOUTLINE

specifies whether outlines are displayed for the bars. The OUTLINE option shows the outlines. The NOOUTLINE option hides the outlines.

Default:

The default status of the outlines is specified by the DisplayOpts attribute of the GraphHistogram style element in the current style.

SCALE= COUNT | PERCENT | PROPORTION

specifies the scaling that is applied to the vertical axis. Specify one of the following values:

COUNT: the axis displays the frequency count.
PERCENT: the axis displays values as a percentage of the total.
PROPORTION: the axis displays values as proportions (0.0 to 1.0) of the total.

Default:

PERCENT

SHOWBINS

specifies that the midpoints of the value bins are used to create the tick marks for the horizontal axis. By default, the tick marks are created at regular intervals based on the minimum and maximum values.

TRANSPARENCY= numeric-value

specifies the degree of transparency for the histogram. Specify a value from 0.0 (completely opaque) to 1.0 (completely transparent).

Default:

0.0

X2AXIS

assigns the response variable to the secondary (top) horizontal axis.

Y2AXIS

assigns the calculated values to the secondary (right) vertical axis.

Top of Page

	BOUNDARY= LOWER \| UPPER
	FILL \| NOFILL
	FILLATTRS= style-element \| (COLOR= color)
	FREQ= numeric-variable
	OUTLINE \| NOOUTLINE
	SCALE= COUNT \| PERCENT \| PROPORTION
	SHOWBINS

	LEGENDLABEL= "text-string"
	NAME= "text-string"
	TRANSPARENCY= numeric-value
	X2AXIS
	Y2AXIS