R/fftrees_cuerank.R
fftrees_cuerank.Rd
fftrees_cuerank
takes an FFTrees
object x
and
optimizes its goal.threshold
(from x$params
) for all cues in
newdata
(of type data
).
fftrees_cuerank(x = NULL, newdata = NULL, data = "train", rounding = NULL)
An FFTrees
object.
A dataset with cues to be ranked (as data frame).
The type of data with cues to be ranked (as character: 'train'
, 'test'
, or 'dynamic'
).
Default: data = 'train'
.
integer. An integer value indicating the decimal digit
to which non-integer numeric cue thresholds are to be rounded.
Default: rounding = NULL
(i.e., no rounding).
A modified FFTrees
object (with cue rank information
for the current data
type in x$cues$stats
).
fftrees_cuerank
creates a data frame cuerank_df
that is added to x$cues$stats
.
Note that the cue directions and thresholds computed by FFTrees
always predict positive criterion values (i.e., TRUE
or signal,
rather than FALSE
or noise).
Using these thresholds for negative exits (i.e., for predicting instances of
FALSE
or noise) usually requires a reversal (e.g., negating cue direction).
fftrees_cuerank
is called (twice) by the fftrees_grow_fan
algorithm
to grow fast-and-frugal trees (FFTs).