TEMPLATE Procedure: Plot Statements (Experimental)

ELLIPSE Statement

Displays an ellipse computed from input data, and typically is used to add a confidence ellipse to a scatter plot.

ELLIPSE Y= numeric-column | expression X= numeric-column | expression < / option(s)> ;

Usage Information

Ellipse Plot

[Ellipse Plot]

Required Arguments

X

specifies the column for the X values.

Y

specifies the column for the Y values.

Options

ELLIPSE 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.
CONFIDENCE= number	Specifies the confidence level of the ellipse.
DATATRANSPARENCY= number	Specifies the degree of the transparency of the ellipse fill color and the border.
FILL=boolean	Specifies whether an interior fill is used for the ellipse.
FILLCOLOR= color \| style-reference	Specifies the interior fill of the ellipse.
LEGENDLABEL= 'string'	Specifies the legend label.
LINECOLOR=color \| style-reference	Specifies the border line color of the ellipse.
LINEPATTERN= line \| style-reference	Specifies the border line pattern of the ellipse.
LINES= boolean	Specifies whether the border of the ellipse is drawn.
LINETHICKNESS =dimension \| style-reference	Specifies the border line thickness of the ellipse.
NAME= 'string'	Assigns a name to a plot statement for reference in other template statements.
TRANSPARENCY= number	Specifies the degree of the transparency of the background, ellipse fill, and ellipse border, if displayed in a graph.
TYPE= MEAN \| PREDICTED	Specifies the type of ellipse.
XAXIS = X \| X2	Specifies whether data is mapped to the primary X axis or to the secondary X (X2) axis.
YAXIS= Y \| Y2	Specifies whether data is mapped to the primary Y axis or to 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

CONFIDENCE= number

specifies the confidence level of the ellipse.

Default:	.95
Range:	0-1
See also:	TYPE=

DATATRANSPARENCY= number

specifies the degree of the transparency of the ellipse fill color and the border.

Default:	0
Range:	0 (opaque) to 1 (entirely transparent)
Interaction:	The DATATRANSPARENCY= option overrides the TRANSPARENCY= option for the ellipse.
See also:	TRANSPARENCY= option

FILL= boolean

specifies whether an interior fill is used for the ellipse.

Default:

FALSE

FILLCOLOR= color | style-reference

specifies the interior fill color of the ellipse.

Default:

specified by the GraphDataDefault:ForeGround style reference.

LEGENDLABEL= 'string'

specifies the legend label.

Default:

No label

LINECOLOR= color | style-reference

specifies the border line color of the ellipse.

Default:

specified by the GraphDataDefault:ContrastColor style reference

LINEPATTERN= line | style-reference

specifies the border line pattern of the ellipse.

Default:

a solid line

LINES= boolean

specifies whether the border of the ellipse is drawn.

Default:	TRUE
Interaction:	If the LINES= FALSE and FILL=FALSE or the FILL= option is not specified, then the ellipse border line is drawn to prevent an empty display of data.
Tip:	You can specify a filled ellipse that has border line by specifying LINES= FALSE and FILL= TRUE.

LINETHICKNESS= dimension | style-reference

specifies the border line thickness of the ellipse.

Default:

1 px

NAME= 'string'

assigns a name to a plot statement for reference in other template statements.

Restriction:	The string specified by the NAME= option must be unique within the template.
Restriction:	The string specified by the NAME= option cannot contain embedded spaces.
Tip:	The NAME= option is used mostly in the DISCRETELEGEND statement in order to coordinate the use of colors, marker symbols, and line patterns between the graph and the legend.
Tip:	string is case sensitive.

TRANSPARENCY= number

specifies the degree of the transparency of the background, ellipse fill, and ellipse border, 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 ellipse fill and the ellipse border. The LAYOUT OVERLAY statement specifies the transparency of the background.

TYPE= MEAN | PREDICTED

specifies the type of ellipse.

MEAN

specifies a confidence ellipse of the mean

PREDICTED

specifies a prediction ellipse of the data

Default:	MEAN
See also:	CONFIDENCE=
See also:	For statistical details about how the ellipse is calculated, see the discussion on Confidence and Prediction Ellipses in the CORR procedure documentation in Base SAS Procedures Guide, Volume 3.

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.

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.

Top of Page