Example Program and Statement Details
Example Program
proc template;
define statgraph needleplot;
begingraph;
entrytitle "IBM Stock Trend";
layout overlay;
needleplot x=date y=close /
baselineintercept=80 lineattrs=(color=blue);
endlayout;
endgraph;
end;
run;
proc sgrender data=sashelp.stocks template=needleplot;
where stock="IBM" and date > "31dec1999"d;
run;
Options
specifies the width
of the group clusters as a fraction of the midpoint spacing on a discrete
axis or a fraction of the minimum interval between adjacent data values
on an interval axis.
specifies the color
and font attributes of the data labels. See General Syntax for Attribute Options for the syntax
on using a style-element and Text Options for available text-options.
specifies an amount
to offset all needle lines and markers from discrete X values when
graphing multiple response variables side by side on a common axis.
creates a distinct
set of needle lines, markers, and data labels for each unique group
value of the specified column.
specifies
a discrete attribute variable that is defined in a DISCRETEATTRVAR statement.
Default: Each
distinct group value might be represented in the graph by a different
combination of color, line pattern, and marker symbol. These vary
according to the ContrastColor, LineStyle, and MarkerSymbol attributes
of the GraphData1–GraphDataN style elements.
Interaction: The
group values are mapped in the order of the data, unless the INDEX= option is used to alter the default sequence of marker
symbols, colors, and line patterns.
Interaction: The INCLUDEMISSINGGROUP= option controls whether missing group
values are considered a distinct group value.
Tip: The
representations that are used to identify the groups can be overridden.
For example, each distinct group value might be represented by a different
line pattern, but the LINEATTRS= (PATTERN=pattern)
option could be used to assign the same line pattern to all of the
plot’s line patterns, letting line color indicate group values.
Likewise, LINEATTRS= (COLOR= color)
could be used to assign the same color to all lines, letting line
pattern indicate group values.
specifies the relative
position of the needle lines for clustered group display. It also
sets the default order of the groups in the legend.
Note: Attributes
such as color, symbol, and pattern are assigned to each group in the
DATA order by default regardless of the GROUPORDER= option setting.
Note: The
ASCENDING and DESCENDING settings linguistically sort the group values
within each category (or X value) for display position purposes only.
The data order of the observations and the visual attributes that
are assigned to the group values remain unchanged.
Tip: The CLUSTERWIDTH= option can be used to control the
distance between the group markers in a cluster
Tip: The INDEX= option can be used to alter the default sequence of visual
attributes that is assigned to the needle lines.
Details: By
default, the value that is set for this option determines the order
in which attributes are assigned to each group. It also determines
the order in which the groups are displayed in the legend.
specifies whether missing
values of the group variable are included in the plot.
Tip: Unless
a discrete attribute map is in effect or the INDEX= option is used,
the attributes of the missing group value are determined by the GraphMissing
style element except when the MISSING= system option is used to specify
a non-default missing character or when a user-defined format is applied
to the missing group value. In those cases, the attributes of the
missing group value are determined by a GraphData1–GraphDataN
style element.
specifies indices for
mapping needle attributes (color, marker symbol, and line pattern)
to one of the GraphData1–GraphDataN style elements.
Restriction: If
the value of the numeric-column is
missing or is less than 1, the observation is not used in the analysis.
If the value is not an integer, only the integer portion is used.
Interaction: All
of the indexes for a specific group value must be the same. Otherwise,
the results are unpredictable.
Interaction: The
index values are 1-based indices. For the style elements in GraphData1–GraphDataN,
if the index value is greater than N, then a modulo operation remaps
that index value to a number less than N to determine which style
element to use.
Discussion: Indexing
can be used to collapse the number of groups that are represented
in a graph. For more information, see Remapping Groups for Grouped Data.
specifies the attributes
of the needle lines for the data points. See General Syntax for Attribute Options for the syntax
on using a style-element and Line Options for available line-options.
specifies the attributes
of the data markers. See General Syntax for Attribute Options for the syntax
on using a style-element and Marker Options for available marker-options.
specifies that the
data columns for this plot be used for determining default axis features.
Details: This
option is needed only when two or more plots within an overlay-type
layout contribute to a common axis. For more information, see When Plots Share Data and a Common Axis.
specifies user-defined
roles that can be used to display information in the tooltips.
Requirement: The
role names that you choose must be unique and different from the pre-defined
roles X. Y, DATALABEL, INDEX, and GROUP.
This option provides
a way to add to the data columns that appear in tooltips specified
by the TIP= option.
specifies the information
to display when the cursor is positioned over a needle line or marker.
If this option is used, it replaces all the information displayed
by default. Roles for columns that do not contribute to the needle
plot can be specified along with roles that do.
Default: The
columns assigned to these roles are automatically included in the
tooltip information: X, Y, DATALABEL, and GROUP.
an ordered, blank-separated
list of unique NEEDLEPLOT and user-defined roles. NEEDLEPLOT roles
include X, Y, DATALABEL, and GROUP.
User-defined roles
are defined with the ROLENAME= option.
Requirement: To
generate tooltips, you must include an ODS GRAPHICS ON statement that
has the IMAGEMAP option specified, and write the graphs to the ODS
HTML destination.
Interaction: The
labels and formats for the TIP variables can be controlled with the TIPLABEL= and TIPFORMAT= options.
specifies display formats
for tip columns.
Default: The
column format of the variable assigned to the role or BEST6. if no
format is assigned to a numeric column.
Requirement: This
option provides a way to control the formats of columns that appear
in tooltips. Only the roles that appear in the TIP= option are used.
Columns must be assigned to the roles for this option to have any
effect. See the ROLENAME= option.
specifies display labels
for tip columns.
Requirement: This
option provides a way to control the labels of columns that appear
in tooltips. Only the roles that appear in the TIP= option are used.
Columns must be assigned to the roles for this option to have any
effect. See the ROLENAME= option.
specifies whether data
are mapped to the primary X (bottom) axis or to the secondary X2 (top)
axis.
Interaction: The
overall plot specification and the layout type determine the axis
display. For more information, see How Axis Features Are Determined.
specifies whether data
are mapped to the primary Y (left) axis or to the secondary Y2 (right)
axis.
Interaction: The
overall plot specification and the layout type determine the axis
display. For more information, see How Axis Features Are Determined.