select_best_tree selects (looks up and identifies) the best tree
from the set (or “fan”) of FFTs contained in the current FFTrees object x,
an existing type of data ('train' or 'test'), and
a goal for which corresponding statistics are available
in the designated data type (in x$trees$stats).
select_best_tree(x, data, goal)An integer denoting the tree that maximizes/minimizes goal in data.
An FFTrees object.
character. Must be either "train" or "test".
character. A goal to maximize or minimize when selecting a tree from an existing x
(for which values exist in x$trees$stats).
Importantly, select_best_tree only identifies and selects from the set of
existing trees with known statistics,
rather than creating new trees or computing new cue thresholds.
More specifically, goal is used for identifying and selecting the best of
an existing set of FFTs, but not for
computing new cue thresholds (see goal.threshold and fftrees_cuerank()) or
creating new trees (see goal.chase and fftrees_ranktrees()).
FFTrees for creating FFTs from and applying them to data.