The OPTGRAPH Procedure
REACH Statement
REACH < options >;
The REACH statement invokes an algorithm that calculates the reach (ego) network on an input graph.
The reach network is described in the section Reach (Ego) Network.
You can specify the following options in the REACH statement:
- BY_CLUSTER
decomposes the calculations by cluster (subgraph). If this option is specified, PROC OPTGRAPH looks for a definition of the clusters in the input data set specified in the DATA_NODES= option in the PROC OPTGRAPH statement. If BY_CLUSTER is specified, the reach network links output (specified in the OUT_LINKS= option) cannot be generated.
- DIGRAPH
calculates the directed reach counts when computing the reach networks and includes the directed counts in the resulting output data set that is specified in the OUT_COUNTS= option. This option is ignored unless you specify MAXREACH=1 in the REACH statement.
- EACH_SOURCE
treats each node as a source and calculates a reach network from each one.
- IGNORE_SELF
- MAXREACH=number
specifies the maximum number of links to allow from each source node in a reach network. By default, MAXREACH=1.
- LOGFREQTIME=number
displays iteration logs for the reach algorithm every number seconds. When PROC OPTGRAPH runs the reach algorithm, it displays the number of source networks that have completed. When you also specify the BY_CLUSTER option in the REACH statement, PROC OPTGRAPH displays the number of subgraphs that have completed. The value of number can be any integer greater than or equal to 1; the default is 5. Setting this value too low can hurt performance on large-scale graphs.
- LOGLEVEL=number
controls the amount of information that is displayed in the SAS log. Table 36 describes the valid values for this option.
Table 36: Values for LOGLEVEL= Option
number string Description 0 NONE Turns off all algorithm-related messages in the SAS log 1 BASIC Displays a basic summary of the algorithmic processing 2 MODERATE Displays a summary of the algorithmic processing 3 AGGRESSIVE Displays a detailed summary of the algorithmic processing
The default is the value that is specified in the LOGLEVEL= option in the PROC OPTGRAPH statement (or BASIC if that option is not specified).
- OUT_COUNTS=SAS-data-set
specifies the output data set to contain the node counts in each reach network.
- OUT_COUNTS1=SAS-data-set
specifies the output data set to contain the node counts in each reach network for the special case of calculating only counts that have limit 1 and 2. This data set holds the counts with MAXREACH=1. This option works only when the EACH_SOURCE and BY_CLUSTER options are specified.
- OUT_COUNTS2=SAS-data-set
specifies the output data set to contain the node counts in each reach network for the special case of calculating only counts that have limit 1 and 2. This data set holds the counts with MAXREACH=2. This option works only when the EACH_SOURCE and BY_CLUSTER options are specified.
- OUT_LINKS=SAS-data-set
specifies the output data set to contain the links in each reach network.
- OUT_NODES=SAS-data-set
specifies the output data set to contain the nodes in each reach network.