The following arguments
for the DS2TREE and DS2CONST macros define how the applet will use
the data set to generate the node and link diagram.
Note: For DS2TREE, the arguments
NDATA and NID are required.
Note: For DS2CONST, the arguments
NDATA, NID, LDATA, and LTO are required.
- DATATYPE=ARCS | ASSOC
-
specifies the type
of the XML data. Valid values are defined as follows:
- ARCS
-
indicates that the
data set is in the form of an arc list. This is the default value.
- ASSOC
-
indicates that the
data set is associative. The links can be displayed based on their
weighted values, and node size and link width can represent the relative
size of the node and link values.
- LABELS=Y | N
-
indicates whether node
labels are displayed in the diagram. The default value is Y.
Used by:DS2CONST, DS2TREE
- LAYOUT=AUTO | USER
-
when the value is AUTO
(default), specifies that the Constellation Applet lays out the diagram
using stress and strain equations. Specifying the value USER indicates
that the node positions are specified in the NX and NY arguments.
- LCOLOR=variable-name
-
specifies the name of
the variable that determines the color of the link lines. The values
of this variable must be HTML 3.2 color names, or you must use the
LCOLFMT= argument to convert those values to valid color names. The
default color is provided by the CLINK= argument (see Arguments for Diagram Appearance).
In the DS2CONST macro,
the LCOLOR= argument is overridden by the LCOLVAL= argument.
Used by:DS2CONST, DS2TREE
- LCOLFMT=user-defined-format-name
-
specifies the name
of a user-defined SAS format that converts the values in the variable
named in the LCOLOR= argument to valid HTML color names. Note that
the SAS format does not change any values in the data set. The formatted
values are applied to the diagram only.
Used by:DS2CONST, DS2TREE
- LCOLVAL=variable-name
-
specifies the name of
the variable that determines the color mapping of link lines. This
argument is valid only when the value of the DATATYPE= argument is
ASSOC, and only when the value of the COLORMAP= argument is Y. If
the LCOLVAL= argument is not specified, the link colors are determined
by the following arguments in the following order: LCOLOR= (see above)
and CLINK= (see Arguments for Diagram Appearance).
- LDATA=data-set-name
-
specifies the name
of the SAS data set that contains the link data that is used to generate
the diagram.
Used by:DS2CONST
Requirement:This argument is required.
- LFROM=variable-name
-
specifies the name
of the variable whose values define the nodes at the start of link
lines. The LFROM variable values must be coordinated with the values
of the variables that are named in the NID= and LTO= arguments.
Used by:DS2CONST
Requirement:This argument is required.
- LINKTYPE=LINE | ARROW
-
when the value is ARROW
(default), indicates that link lines are to be drawn with arrowheads
that indicate the direction of flow.
- LPT=password
-
specifies the password
that is needed for accessing a password-protected link data set (specified
with the LDATA= argument). The LPT= argument is required if the data
set has a READ or PW password. You do not need to specify this argument
if the data set has a WRITE or ALTER password.
- LSTIP=variable-name
-
specifies the name
of the variable in the data set that determines the stipple mask.
The stipple mask generates dashed or dotted link lines. The value
of the variable must be an integer, which is then converted into a
binary value. In the binary value, a “1” bit means that
a pixel is to be drawn and a “0” bit means that no pixel
is to be drawn. For example, if the variable has a value of 61680,
the binary conversion of that value will be 1111000011110000. This
stipple mask generates a dashed link line with dashes and spaces that
are four pixels wide. See also the LSTIPFAC= argument.
Used by:DS2CONST, DS2TREE
- LSTIPFAC=variable-name
-
specifies the name
of the variable in the data set whose value specifies a multiplier
for the binary stipple mask (see the LSTIP= argument). The multiplier
lengthens the dashes in the base mask. For example, if the multiplier
is 2, a stipple mask that specifies 4-pixel dashes and 4-pixel spaces
will generate link lines with 8-pixel dashes and spaces.
Used by:DS2CONST, DS2TREE
- LTIP=variable-name
-
specifies the name
of the variable in the data set that provides the text that is displayed
in the pop-up data tips windows for links.
Used by:DS2CONST, DS2TREE
- LTIPFMT=user-defined-format-name
-
specifies the name
of a user-defined SAS format that is applied to the values in the
variable specified in the LTIP= argument to configure those values
for display in the pop-up data tips window. Note that the SAS format
does not change any values in the data set. The formatted values are
applied to the diagram only.
Used by:DS2CONST, DS2TREE
- LTO=variable-name
-
specifies the name
of the variable whose values identify the nodes at the ends of link
lines. The LTO variable values must be coordinated with the values
of the variables that are named in the LFROM and NID arguments.
Used by:DS2CONST
Requirement:This argument is required.
- LVALUE=variable-name
-
specifies the name of
the variable whose values determine the weights of the link lines,
which determines the color and relative thickness of link lines. The
variable values must be real numbers. The link weights are used with
the MINLNKWT= argument (see below) and the SCLNKWT= argument (see Arguments for Diagram Appearance) to control
the display of link lines. The LVALUE= argument is valid only when
the value of the DATATYPE= argument is ASSOC.
- LWHERE=subset-expression
-
specifies a WHERE clause
that subsets the link data for display in the diagram. If the expression
contains any special characters (for example, % or &), include
%NRBQUOTE in the expression to process those characters correctly.
The following example shows how to correctly specify INT%:
LWHERE=%NRBQUOTE(value="Int%")
See also the NWHERE
argument.
- LWIDTH=variable-name
-
specifies the name
of the variable in the data set that determines the width of the link
lines.
For DS2CONST: When
this argument is not specified, the width is determined by the LVALUE
argument. This argument is valid for DS2CONST only when the value
of the DATATYPE argument is ASSOC.
For DS2TREE: This option
maps the range of values of the specified variable to a range of link
widths. If this option is not specified or if only one link width
value is provided for all of the links, then the width of all of the
links is set to the minimum link width in the pixel range.
Used by:DS2CONST, DS2TREE
- MINLNKWT=minimum-link-weight
-
specifies the initial
minimum link weight, which determines which links are initially displayed.
The initial diagram show only those links that have weights that are
greater than or equal to the minimum weight. In the Constellation
Applet, a scroll bar allows the Web user to change the minimum link
weight to change the number of links that are displayed. Selecting
the browser's Refresh option restores the initial minimum link weight
that is specified in the MINLNKWT argument. Link weights are determined
by the LVALUE argument. This argument is valid only when the value
of the DATATYPE argument is ASSOC.
- NACTION=variable-name
-
specifies the name of
the variable in the nodes data set that provides the menu text that
is displayed when the Web user selects a node with the right mouse
button. Selecting this menu option text displays the URL that is associated
with that node in the NURL= argument. This argument overrides the
ACTION= argument (see Arguments for Diagram Appearance). The default menu option text is Open URL.
Used by:DS2CONST, DS2TREE
- NCOLFMT=SAS-format-name
-
specifies the name
of a user-defined SAS format that converts the values in the variable
named in the NCOLOR= argument to valid HTML color names. Note that
the data in the data set is not altered; the formatted value is used
in the hierarchical tree rather than the data value.
- NCOLOR=variable-name
-
specifies the variable
in the nodes data set that determines the background color of the
nodes, using HTML 3.2 color names or 6-digit hexadecimal RGB values
. If the variable does not contain valid HTML color names, then you
can use the NCOLFMT=argument to convert those values to the HTML color
names. See also the NCOLVAL= and NVALUE=arguments.
Used by:DS2CONST, DS2TREE
- NCOLVAL=variable-name
-
specifies the name
of the variable in the nodes data set that determines the color mapping
for the nodes. This argument is valid only when the DATASET= argument
is set to ASSOC, and only when the value of the COLORMAP= argument
is Y. If this argument is not specified, then the node color is determined
by the LVALUE= argument.
- NDATA=SAS-data-set-name
-
specifies the SAS data
set that contains the node data.
Used by:DS2CONST, DS2TREE
Requirement:This argument is required.
- NFNTNAME=node-font-variable-name
-
specifies the name of
the variable that determines the text font for the node labels. The
variable value can be SERIF, SANSSERIF, DIALOG, DIALOGINPUT, or MONOSPACED.
The default node font is specified by the FNTNAME= argument (see Arguments for Diagram Appearance).
Used by:DS2CONST, DS2TREE
- NFNTSIZE=variable-name
-
specifies the name
of the variable in the nodes data set that determines the size of
the text font used for node labels. This font size is expressed in
points. This argument overrides the FNTSIZE= argument.
Used by:DS2CONST, DS2TREE
- NFNTSTYL=node-font-style-variable-name
-
specifies the name
of the variable that determines the font style for the node label.
The valid values that can be assigned to the variable are BOLD, ITALIC,
and PLAIN.
Used by:DS2CONST, DS2TREE
- NID=variable-name
-
specifies the name
of the variable in the nodes data set whose values are to be illustrated
as the nodes in the diagram. The node ID variable type can be either
numeric or character. For the DS2CONST macro, the values of the NID
variable must be coordinated with the values of the LFROM and LTO
variables.
This argument is required.
Used by:DS2CONST, DS2TREE
- NLABEL=node-label-variable-name
-
specifies the name
of the variable that represents the node labels. This variable type
can be either numeric or character.
Used by:DS2CONST, DS2TREE
- NPARENT=node-parent-variable-name
-
specifies the name
of the variable that represents the parent nodes. This variable type
can be either numeric or character.
- NPW=password
-
specifies the password
that is needed for accessing a password-protected data set. This argument
is required if the data set has a READ or PW password. You do not
need to specify this argument if the data set has only WRITE or ALTER
passwords.
Used by:DS2CONST, DS2TREE
- NSCBACK=variable-name
-
specifies the name of
the variable in the node styles data set that determines the background
color of the nodes. The variable values must be HTML 3.2 color names.
The default value is determined by the CNODE= argument (see Arguments for Diagram Appearance).
Used by:DS2CONST, DS2TREE
- NSCTEXT=variable-name
-
specifies the name
of the variable in the node styles data set that provides the colors
for the node label text. Valid variable values must be HTML 3.2 color
names. The default color is provided by the CATEXT= argument.
Used by:DS2CONST, DS2TREE
- NSDATA=SAS-data-set-name
-
specifies the name
of the node styles data set.
Used by:DS2CONST, DS2TREE
- NSFNTNAM=variable-name
-
specifies the name
of the variable in the node styles data set that determines the text
font that is to be used for node labels. Valid variable values can
be SERIF, SANSSERIF, DIALOG, DIALOGINPUT, or MONOSPACED. This argument
overrides the FNTNAME= argument.
Used by:DS2CONST, DS2TREE
- NSFNTSIZ=variable-name
-
specifies the name
of the variable in the node styles data set that determines the size
of the node label text, in points. This argument overrides the FNTSIZE=
argument.
Used by:DS2CONST, DS2TREE
- NSFNTSTY=variable-name
-
specifies the name
of the variable in the node styles data set that determines the style
of the node label text. Valid variable values can be BOLD, ITALIC,
or the default value, PLAIN. This argument overrides the FNTSTYL=
argument.
Used by:DS2CONST, DS2TREE
- NSHAPE=variable-name
-
specifies the name
of the variable that determines the shape of the nodes. Valid variable
values can be CIRCLE, DIAMOND, NONE, SQUARE, or TRIANGLE. The default
value is SQUARE. This argument overrides the NODESHAP= argument.
- NSID=variable-name
-
specifies the name
of the variable in the node styles data set that represents the nodes.
Used by:DS2CONST, DS2TREE
- NSIZE=variable-name
-
specifies the name of
the variable that determines the size of the nodes. The values of
this variable can be real numbers. Node sizes are determined based
on the value of the LAYOUT= argument. When LAYOUT=USER, the values
of the NSIZE variable are interpreted as literal pixel measurements.
When LAYOUT=AUTO, the values of the NSIZE variable determine the size
of the nodes based on the relative size of individual values. The
values of the NSIZE variable can be scaled with the SCNSIZE= argument
(see Arguments for Diagram Appearance). This argument is valid only when the value of the DATATYPE= argument
is ASSOC.
- NSPW=password
-
specifies the password
that is needed to access a password-protected node styles data set.
This argument is required if the data set has a READ or PW password.
You do not need to specify this argument if the data set has only
WRITE or ALTER passwords.
Used by:DS2CONST, DS2TREE
- NSTYLE=variable-name
-
specifies the name
of the variable that determines the style of the nodes. This variable
type can be either numeric or character, and the values must correspond
to the node identifiers specified in the NSID= argument.
Used by:DS2CONST, DS2TREE
- NSWHERE=subset-expression
-
specifies a WHERE clause
that subsets the node styles data set for display in the diagram.
If the expression contains any special characters (for example, %
or &), then include %NRBQUOTE in the expression to process those
characters correctly. The following example shows how to correctly
specify INT%:
NSWHERE=%NRBQUOTE(value="Int%")
Used by:DS2CONST, DS2TREE
- NTEXTCOL=variable-name
-
specifies the name
of the variable that determines the color of the text for the node
labels. Valid variable values must be HTML 3.2 color names.
Used by:DS2CONST, DS2TREE
- NTIP=variable-name
-
specifies the name
of the variable that provides the data or text that is displayed in
the pop-up data tips window.
Used by:DS2CONST, DS2TREE
- NTIPFMT=user-defined-format-name
-
specifies the name
of a user-defined SAS format that is applied to the data tips variable
that is named in the NTIP= argument. Note that the data set is not
altered; the formatted value is used only in the diagram.
Used by:DS2CONST, DS2TREE
- NURL=drill-down-URL
-
specifies the name of
the variable that provides the drill-down URLs for the nodes. These
URLs are displayed when the Web user double-clicks on a node or selects
the node with the right mouse button and chooses an option from the
pop-up menu. Menu text is determined by the NACTION= argument above
and by the ACTION= argument in Arguments for Diagram Appearance. The default menu option text is Open URL.
Used by:DS2CONST, DS2TREE
- NVALUE=variable-name
-
specifies the name
of the variable that determines the relative node size. This argument
is valid only when DATATYPE=ASSOC.
If you do not specify
a particular node color using either the NCOLOR or NCOLVAL argument
(and if COLORMAP=Y), then this argument also determines a default
node color. By default, the largest value of NVALUE is mapped to red,
the median value to green, and the lowest value to blue. Values in
between result in interpolated colors.
- NWHERE=subset-expression
-
specifies a WHERE clause
that subsets the nodes data set for display in the diagram. If the
expression contains any special characters (for example, % or &),
then include %NRBQUOTE in the expression to process those characters
correctly. The following example shows how to correctly specify INT%:
NWHERE=%NRBQUOTE(value="Int%")
See also the LWHERE=
argument.
Used by:DS2CONST, DS2TREE
- NX=variable-nameNY=variable-name
-
specify the variables
that determine the locations of the centers of the nodes. These arguments
are valid only when the LAYOUT= argument is set to USER. The values
are expressed in pixels. Positive values are measured from the top
left corner of the screen. Negative values are measured from the bottom
right corner of the screen.