Description Usage Arguments Details Value Author(s) References See Also Examples

Prune a PST, using either a gain function, a maximal depth or a list of nodes to keep or remove. Optionally, nodes are not removed from the tree but tagged as deleted, helping to visualize the pruning process.

1 2 |

`object` |
a probabilistic suffix tree, i.e., an object of class |

`nmin` |
integer. All strings having counts less than nmin are removed. |

`L` |
integer. If specified the the tree is cut at depth L., that is all nodes with depth > L are removed. |

`gain` |
character. Function for measuring information gain. See |

`C` |
numeric. Cutoff value to use with the gain function |

`keep` |
character. A vector of character strings containing the names of the nodes to keep in the tree. All nodes that are not a suffix of contexts in keep are removed from the tree. |

`drop` |
character. A vector of character strings containing the names of the nodes to remove from the tree. All nodes that are a suffix of contexts in drop are removed from the tree as weel. |

`state` |
character. All nodes corresponding to contexts which include |

`delete` |
Logical. If FALSE, the pruned nodes are not removed from the tree but tagged as pruned=FALSE, so that when plotting the pruned tree these nodes wil appear surrounded with red (can be set to another color) lines. |

`lik` |
Logical. If TRUE, the log-likelihood of the pruned model, i.e. the likelihood of the training sequences given the model, is computed and stored in the 'logLik' slot of the PST. Setting to FALSE will spare the time required to compute the likelihood. |

The initial tree returned by the `pstree`

function may yield an overly complex model containing all contexts of maximal length *L* and frequency *N(c) ≥q nmin* found in the learning sample. The pruning stage potentially reduces the number of nodes in the tree, and thus the model complexity. It compares the conditional probabilities associated to a node labelled by a subsequence *c=c_{1},c_{2}, …, c_{k}* to the conditional probabilities of its parent node labelled by the longest suffix of *c*, *suf(c)=c_{2}, …, c_{k}*. The general idea is to remove a node if it does not contribute additional information with respect to its parent in predicting the next symbol, that is if *\hat{P}(σ | c)* is not *significantly* different from *\hat{P}(σ | suf(c))* for all *σ \in A*.

The pruning procedure starts from the terminal nodes and is applied recursively until all terminal nodes remaining in the tree represent an information gain relative to their parent.
A gain function, whose outcome will determine the pruning decision, is used to compare the two probability distributions. The gain function is driven by a cut-off, and different values of this parameter will yield more or less complex trees. A method for selecting the pruning cut-off is described in the `tune`

help page.

A first implemented gain function, which is used by the *Learn-PSA* algorithm, is based on the ratio between *\hat{P}(σ|c)* and *hat{P}(σ|suf(c))* for each *σ \in A*. A node represents an information gain if for any symbol *σ \in A* the ratio is greater than the cut-off *C* or lower than *1/C*, that is if

*
G_{1}(c)=∑_{σ \in A} 1 ≤ft[ \frac{\hat{P}(σ |c)}{\hat{P}(σ | suf(c))} ≥q C \; \cup \;
\frac{\hat{P}(σ |c)}{\hat{P}(σ | suf(c))} ≤q \frac{1}{C} \right] ≥q 1
*

where *C* is a user defined cut-off value. Nodes that do not satisfy the above condition are pruned. For *C=1* no node is removed since even a node having a next probability distribution similar to the one of its parent does not satisfy the pruning condition.

The *context* algorithm uses another gain function, namely

*
G_{2}(c)=∑_{σ \in A} \hat{P}(σ|c)\log ≤ft( \frac{\hat{P}(σ|c)}{\hat{P}(σ|suf(c))} \right) N(c) > C
*

where *c* is the context labelling the terminal node, *N(c)* is the number of occurrences of *c* in the data. The cutoff *C* is specified on the scale of *χ^{2}*-quantiles Maechler-2004

*
C=C(α)=\frac{1}{2}qchisq(1-α,v), v=|A|-1
*

where *qchisq(p=1-α,v)* is the quantile function of a *χ^{2}* distribution with *v* degrees of freedom. The cutoff *C* is a threshold for the difference of deviances between a tree *S^{1}* and its subtree *S^{2}* obtained by pruning the terminal node *c*. Typical values for *α* are *5\%* and *1\%*, yielding *p=0.95* and *p=0.99* respectively. For more details, see Gabadinho 2016.

A probabilistic suffix tree, i.e., an object of class `PSTf`

.

Alexis Gabadinho

Bejerano, G. & Yona, G. (2001). Variations on probabilistic suffix trees: statistical modeling and prediction of protein families. *Bioinformatics*, 17, pp. 23-43.

Gabadinho, A. & Ritschard, G. (2016). Analyzing State Sequences with Probabilistic Suffix Trees: The PST R Package. *Journal of Statistical Software*, **72**(3), pp. 1-39.

Maechler, M. & Buehlmann, P. (2004). Variable Length Markov Chains: Methodology, Computing, and Software *Journal of Computational and Graphical Statistics*, 13, pp. 435-455.

Ron, D.; Singer, Y. & Tishby, N. (1996). The power of amnesia: Learning probabilistic automata with variable memory length *Machine Learning*, 25, pp. 117-149.

1 2 3 4 5 6 7 8 9 10 11 12 13 |

PST documentation built on May 19, 2017, 2:36 p.m.

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at ian@mutexlabs.com.

Please suggest features or report bugs in the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.