specifies whether the procedure should rescale the probabilities of events for a given chance stage if the total probability of this stage is not equal to . The default is NOSCALE.

indicates the decision criterion to be used for determining the optimal decision and the certain equivalent for replacing uncertainties. The following table shows all valid values of i and their corresponding decision criteria and certain equivalents.

The default value is MAXEV. The last two criteria are used when your utility curve can be fit by an exponential function. See the section Evaluation for more information on the exponential utility function.

specifies information that should be displayed on each link of the decision tree diagram. Table 7.20 lists the valid keywords and corresponding information.

The default value is (LINK P EV R CR).

Note that the probability information displays on links that represent chance outcomes only. In addition, the PROBIN= option must be specified. The expected values display only if the decision tree has been evaluated. The reward information displays on a link only if the instant reward of the outcome represented by the link is nonzero. The cumulative rewards do not display if the cumulative rewards of links are all zero.

specifies whether the procedure should stop processing the current statement and wait for next statement or quit PROC DTREE when an error has been detected by the procedure. The default value is DRAIN.

creates plots for a graphics device. To specify this option, you need to have
SAS/GRAPH software licensed at your site. This is the default.

specifies whether the labels for information displayed on the decision tree diagram should be displayed. If the NOLABEL option is not specified, the procedure uses the following symbols to label all the information that is displayed on each link.

The default is LABEL.

creates plots of line-printer quality. If you do not specify this option, graphics plots are produced.

specifies the maximum decimal width (the precision) in which to format numerical values using format. This option is used in displaying the decision tree diagrams and the summaries. The value for this option must be no greater than ; the default value is .

specifies the maximum field width in which to format numerical values (probabilities, rewards, cumulative rewards and evaluating values) using format. This option is used in displaying the decision tree diagrams and the summaries. The value for this option must be no greater than and must be at least plus the value of the MAXPREC= option. The default value is .

specifies the maximum field width in which to format outcome names when displaying the decision tree diagrams. The value for this option must be no greater than 40; the default value is .

names the SAS data set that contains the evaluating values (payoffs, losses, utilities, and so on) for each state and action combination. The use of PAYOFFS= is optional in the PROC DTREE statement. If the PAYOFFS= option is not used, PROC DTREE assumes that all evaluating values at the end nodes of the decision tree are 0.

names the SAS data set that contains the (conditional) probability specifications of outcomes. The PROBIN= SAS data set is required if the evaluation of the decision tree is desired.

specifies the value of the risk tolerance. The RT= option is used only when
CRITERION=MAXCE or CRITERION=MINCE is specified. If the RT= option is not specified, and CRITERION=MAXCE or CRITERION=MINCE is specified, PROC DTREE changes the value of the CRITERION= option to MAXEV or MINEV (which would mean straight-line utility function and imply infinite risk tolerance).

names the SAS data set that contains the stage names, stage types, names of outcomes, and their rewards and successors for each stage. If the STAGEIN= option is not specified, PROC DTREE uses the most recently created SAS data set.

specifies whether an optimal decision summary should be displayed each time the decision tree is evaluated. The decision summary lists all paths through the tree that lead to the target stage as well as the cumulative rewards and the evaluating values of all alternatives for that path. The alternative with optimal evaluating value for each path is marked with an asterisk (*). The default is NOSUMMARY.

specifies the decision stage up to which the optimal decision policy table is displayed. The TARGET= option is used only in conjunction with the SUMMARY option. The stage specified must be a decision stage. If the TARGET= option is not specified, the procedure displays an optimal decision policy table for each decision stage.

specifies either a positive number close to or greater than . PROC DTREE treats all numbers within of as , where

and is the machine epsilon. The default value is .

specifies whether the procedure should display a warning message when

• the payoff for an outcome is not assigned in the PAYOFFS= data set

• probabilities of events for a given chance stage have been automatically scaled by PROC DTREE because the total probability of the chance stage does not equal

The default is WARNING.

specifies the vertical distance between two successive end nodes. If the GRAPHICS option is specified, the valid values for the optional units are listed in Table 7.22.

The value of the YBETWEEN= option must be greater than or equal to . Note that if the COMPRESS option is specified, the actual distance between two successive end nodes is scaled by PROC DTREE and may not be the same as the YBETWEEN= specification.

If the LINEPRINTER option is specified, the optional units value can be CELL or SPACE. The value of the YBETWEEN= option must be a nonnegative integer.

If you do not specify units, a unit specification is determined in the following order:

• the GUNIT= option in a GOPTIONS statement, if the GRAPHICS option is specified

• the default unit, CELL

The default value of YBETWEEN= option is 0.

specifies an input data set that contains appropriate Annotate variables. The
ANNOTATE= option enables you to add features (for example, customized legend) to plots produced on graphics devices. For additional information, refer to the chapter on the annotate data set in SAS/GRAPH Software: Reference.

specifies the color for all links in the decision tree diagram that represent optimal decisions. If you do not specify the CBEST= option, the color specification is determined in the following order:

• the CI= option in the jth generated SYMBOL definition, if the option LINKB=j is specified

• the ContrastColor attribute of the GraphData2 element of the current ODS style definition (if the GSTYLE system option is active)

• the second color in the colors list

specifies the color for all links in the decision tree diagram except those that represent optimal decisions. If the CLINK= option is not specified, the color specification is determined in the following order:

• the CI= option in the ith generated SYMBOL definition, if the option LINKA=i is specified

• the ContrastColor attribute of the GraphData3 element of the current ODS style definition (if the GSTYLE system option is active)

• the third color in the colors list

specifies whether the decision tree diagram should be drawn on one physical page. If the COMPRESS option is specified, PROC DTREE determines the scale so that the diagram is compressed, if necessary, to fit on one physical page. Otherwise, the procedure draws the diagram across multiple pages if necessary. The default is NOCOMPRESS.

specifies the color of the symbol used to draw all chance nodes in the decision tree diagram. If the CSYMBOLC= option is not specified, the color specification is determined in the following order:

• the CV= option in the mth generated SYMBOL definition, if the option
  SYMBOLC=m is specified

• the CSYMBOL= option in a GOPTIONS statement

• the ContrastColor attribute of the GraphData1 element of the current ODS style definition (if the GSTYLE system option is active)

• the fifth color in the colors list

specifies the color of the symbol used to draw all decision nodes in the decision tree diagram. If the CSYMBOLD= option is not specified, the color specification is determined in the following order:

• the CV= option in the dth generated SYMBOL definition, if the option
  SYMBOLD=d is specified

• the CSYMBOL= option in a GOPTIONS statement

• the ContrastColor attribute of the GraphData5 element of the current ODS style definition (if the GSTYLE system option is active)

• the fourth color in the colors list

specifies the color of the symbol used to draw all end nodes in the decision tree diagram. If the CSYMBOLE= option is not specified, the color specification is determined in the following order:

• the CV= option in the nth generated SYMBOL definition, if the option
  SYMBOLE=n is specified

• the CSYMBOL= option in a GOPTIONS statement

• the ContrastColor attribute of the GraphData8 element of the current ODS style definition (if the GSTYLE system option is active)

• the sixth color in the colors list

specifies the color to be used for all text that appears on plots except on TITLE and FOOTNOTE lines. If the CTEXT= option is not specified, the color specification is determined in the following order:

• the CTEXT= option in a GOPTIONS statement

• the Color attribute of the GraphDataText element of the current ODS style definition (if the GSTYLE system option is active)

• the first color in the colors list

specifies a descriptive string, up to characters long, that appears in the description field of the master menu of PROC GREPLAY. If the DESCRIPTION= option is omitted, the description field contains a description assigned by PROC DTREE.

specifies whether the Annotate data set should be processed. If the NOANNOTATE option is specified, the procedure does not process the Annotate data set even though the ANNOTATE= option is specified. The default is DOANNOTATE.

specifies the font to be used for text on plots. If you do not use this option, the font specification is determined in the following order:

• the FTEXT= option in a GOPTIONS statement

• the Font attribute of the GraphDataText element of the current ODS style definition (if the GSTYLE system option is active)

• the hardware font for your graphics output device

Refer to the chapter on SAS/GRAPH fonts in SAS/GRAPH Software: Reference for details about SAS/GRAPH fonts.

specifies the name of the graphics catalog used to save the output produced by PROC DTREE for later replay. For additional information, refer to the chapter on graphics output in SAS/GRAPH Software: Reference.

specifies that the height of symbols for all nodes in the decision tree diagram is h times the heights of symbols assigned by SAS/GRAPH software. You can specify the heights of decision nodes, chance nodes, and end nodes by using the HEIGHT= options in the corresponding SYMBOL statements. For example, if you specify the options HSYMBOL=2 and SYMBOLD=1 in the PROC DTREE statement and defined SYMBOL1 as

      symbol1 height=4 pct;

then all decision nodes in the decision tree diagram are sized at of the graphics output area. The default value is .

specifies that the height for all text in plots (except that in TITLE and FOOTNOTE statements) be h times the height of the characters assigned by SAS/GRAPH software. You can also specify character height by using the HTEXT= option in a GOPTIONS statement.

For example, if you specify the option HTEXT= in the PROC DTREE statement and also specified a GOPTIONS statement as follows

      goptions htext=2 in;

then the size of all text is inches. For more explanation of the GOPTIONS statement, refer to the chapter on the GOPTIONS statement in
SAS/GRAPH Software: Reference. The default value is .

names the SAS data set that receives a description of the areas of a graph and a link for each area. This information is for the construction of HTML image maps. You use a SAS DATA step to process the output file and generate your own HTML files. The graph areas correspond to the link information that comes from the WEB= variable in the STAGEIN= data set. This gives you complete control over the appearance and structure of your HTML pages.

specifies whether the default legend should be displayed. If the NOLEGEND is not specified, the procedure displays a legend at the end of each page of the decision tree diagram. The default is LEGEND.

If the LINKA=i option is specified, then PROC DTREE uses the color specified with the CI= option, the type specified with the LINE= option, and the thickness specified with the WIDTH= option in the ith generated SYMBOL definition to draw all links in the decision tree diagram, except those that indicate optimal decisions and those that are continued on subsequent pages. There is no default value for this option. The color, type, and thickness specifications may be overridden by the specifications of the CLINK=, LSTYLE=, and LWIDTH= options in the PROC DTREE statement.

Note that if you specify the LINKA=i option, PROC DTREE uses the specifications in the ith enerated SYMBOL definition and not the specifications in the SYMBOLi statement. Refer to SAS/GRAPH Software: Reference for the details about creating, canceling, reviewing, and altering SYMBOL definitions.

If the LINKB=j option is specified, then PROC DTREE uses the color specified with the CI= option, the type specified with the LINE= option, and the thickness specified with the WIDTH= option in the jth generated SYMBOL definition to draw all links that represent optimal decisions. There is no default value for this option. The color, type, and thickness specifications may be overridden by the specifications of the CBEST=, LSTYLEB=, and LWIDTHB= options in the PROC DTREE statement.

Note that if you specify the LINKB=j option, PROC DTREE uses the specifications in the jth generated SYMBOL definition and not the specifications in the SYMBOLj statement. Refer to SAS/GRAPH Software: Reference for the details about creating, canceling, reviewing, and altering SYMBOL definitions.

If the LINKC=k option is specified, then PROC DTREE uses the type specified with the LINE= option in the kth generated SYMBOL definition to draw all links in the decision tree diagram that are continued on subsequent pages. There is no default value for this option. The color and thickness for links continued on another page indicate whether the link represents an optimal decision or not. The type specification may be overridden by the specification of the LSTYLEC= option in the PROC DTREE statement.

Note that if you specify the LINKC=k option, PROC DTREE uses the specifications in the kth generated SYMBOL definition and not the specifications in the SYMBOLk statement. Refer to SAS/GRAPH Software: Reference for the details about creating, canceling, reviewing, and altering SYMBOL definitions.

specifies the line type (style) used for drawing all links in the decision tree diagram, except those that represent the optimal decisions and those that are continued on subsequent pages. Valid values for l are though . If the LSTYLE= option is not specified, the type specification is determined in the following order:

• the LINE= option in the ith generated SYMBOL definition, if the option
  LINKA=i is specified

• the default value, (solid line)

specifies the line type (style) used for drawing the links in the decision tree diagram that represent optimal decisions. Valid values for l2 are though . If the LSTYLEB= option is not specified, the type specification is determined in the following order:

• the LINE= option in the jth generated SYMBOL definition, if the option
  LINKB=j is specified

• the default value, (solid line)

specifies the line type (style) used for drawing the links in the decision tree diagram that are continued on the next subsequent pages. Valid values for l3 are though .

If the LSTYLEC= option is not specified, the type specification is determined in the following order:

• the LINE= option in the kth generated SYMBOL definition, if the option
  LINKC=k is specified

• the default value, (dot line)

specifies the line thickness (width) used to draw all links in the decision tree diagram except those that represent the optimal decisions.

If the LWIDTH= option is not specified, the thickness specification is determined in the following order:

• the WIDTH= option in the ith generated SYMBOL definition, if the option LINKA=i is specified

• the default value,

specifies the line thickness (width) used to draw the links in the decision tree diagram that represent optimal decisions. If the LWIDTHB= option is not specified, the thickness specification is determined in the following order:

• the WIDTH= option in the jth generated SYMBOL definition, if the option LINKB=j is specified

• times the thickness for links that represent regular outcomes

specifies a descriptive string, up to characters long, that appears in the name field of the master menu of PROC GREPLAY. The default is 'DTREE '.

specifies whether the page numbers should be displayed in the top right corner of each page of a multipage decision tree diagram. If the NOPAGENUM is not specified, the pages are ordered from top to bottom, left to right.

The default is PAGENUM.

specifies whether the links in the decision tree diagram should be drawn with rounded corners or with rectangular corners. The default is RC.

If the SYMBOLC= option is specified, then PROC DTREE uses the color specified with the CV= option, the character specified with the VALUE= option, the font specified with the FONT= option, and the height specified with the HEIGHT= option in the mth generated SYMBOL definition to draw all chance nodes in the decision tree diagram. There is no default value for this option. The color and the symbol specifications may be overridden by the specification of the CSYMBOLC= and VSYMBOLC= options in the PROC DTREE statement. The height of the symbol can be changed by the HSYMBOL= option in the PROC DTREE statement.

Note that if you specify the SYMBOLC=m option, PROC DTREE uses the specifications in the mth generated SYMBOL definition and not the specifications in the SYMBOLm statement. Refer to SAS/GRAPH Software: Reference for the details about creating, canceling, reviewing, and altering SYMBOL definitions.

If the SYMBOLD= option is specified, then PROC DTREE uses the color specified with the CV= option, the character specified with the VALUE= option, the font specified with the FONT= option, and the height specified with the HEIGHT= option in the dth generated SYMBOL definition to draw all decision nodes in the decision tree diagram. There is no default value for this option. The color and the symbol specifications may be overridden by the specification of the CSYMBOLD= and VSYMBOLD= options in the PROC DTREE statement. The height of the characters can be changed by the HSYMBOL= option in the PROC DTREE statement.

Note that if you specify the SYMBOLD=d option, PROC DTREE uses the specifications in the dth generated SYMBOL definition and not the specifications in the SYMBOLd statement. Refer to SAS/GRAPH Software: Reference for the details about creating, canceling, reviewing, and altering SYMBOL definitions.

If the SYMBOLE= option is specified, then PROC DTREE uses the color specified with the CV= option, the character specified with the VALUE= option, the font specified with the FONT= option, and the height specified with the HEIGHT= option in the nth generated SYMBOL definition to draw all end nodes in the decision tree diagram. There is no default value for this option. The color and the symbol specifications may be overridden by the specification of the CSYMBOLE= and VSYMBOLE= options specified in the PROC DTREE statement. The height of the characters can be changed by the HSYMBOL= option in the PROC DTREE statement.

Note that if you specify the SYMBOLE=n option, PROC DTREE uses the specifications in the nth generated SYMBOL definition and not the specifications in the SYMBOLn statement. Refer to SAS/GRAPH Software: Reference for the details about creating, canceling, reviewing, and altering SYMBOL definitions.

specifies that the symbol symbolc-name from the special symbol table be used to draw all chance nodes in the decision tree diagram. If you do not specify this option, the symbol used is determined in the following order:

• the options VALUE= and FONT= specifications in the mth generated SYMBOL definition, if the option SYMBOLC=m is specified

• the symbol CIRCLE in the special symbol table

specifies that the symbol symbold-name from the special symbol table be used to draw all decision nodes in the decision tree diagram. If you do not specify this option, the symbol used is determined in the following order:

• the options VALUE= and FONT= specifications in the dth generated SYMBOL definition, if the option SYMBOLD=d is specified

• the symbol SQUARE in the special symbol table

specifies that the symbol symbole-name from the special symbol table be used to draw all end nodes in the decision tree diagram. If you do not specify this option, the symbol used is determined in the following order:

• the options VALUE= and FONT= specifications in the nth generated SYMBOL definition, if the option SYMBOLE=n is specified

• the symbol DOT in the special symbol table

defines characters to be used for features on line-printer plots. The syni-list is a list of numbers ranging from to . The list identifies which features are controlled with the string characters. The formchar-string gives characters for features in syni-list. Any character or hexadecimal string can be used. By default, syni-list is omitted, and the FORMCHAR= option gives a string for all features. The features associated with values of syni are listed in Table 7.23. Note that characters , , , , and are not used in drawing a decision tree diagram.

As an example, the decision tree diagram in Figure 7.7 is produced by the following statement:

title "Decision Tree Showing the Effects of FORMCHAR";

data Dtoils4;
   format _STNAME_ $12. _STTYPE_  $2. _OUTCOM_ $10.
         _SUCCES_ $12.;
   input _STNAME_ $ _STTYPE_ $ _OUTCOM_ $ _SUCCES_ $;
   datalines;
Drill       D   Drill       Cost
.           .   Not_Drill   .
Cost        C   Low         Oil_Deposit
.           .   High        Oil_Deposit
Oil_Deposit C   Dry         .
.           .   Wet         .
;

proc dtree stagein=Dtoils4
           nowarning
           ;
   treeplot / formchar(1 2 3 5 8 9 11 13)='|-/*<\+='
              lineprinter display=(LINK);
              
quit;                   

                                           Low          Dry                     
                                       /----------C-*----------E                
                             Drill     |            |   Wet                     
                          /----------C-<            \----------E                
                          |            |  High          Dry                     
              ----------D-<            \----------C-*----------E                
                          |                         |   Wet                     
                          |                         \----------E                
                          |Not_Drill                                            
                          \----------E                                          

By default, the form character list specified with the SAS system option FORMCHAR= is used; otherwise, the default is '|----|+|---+='. Refer to the chapter on the Calendar Procedure in the SAS Procedures Guide for more information.