FFTrees (version 1.1.8)

cuerank: Calculate the marginal accuracy of all cues in a dataframe. For each cue, the threshold that maximizes the criterion is selected.

Description

Calculate the marginal accuracy of all cues in a dataframe. For each cue, the threshold that maximizes the criterion is selected.

Usage

cuerank(formula = NULL, data = NULL, tree.criterion = "v", numthresh.method = "o", rounding = NULL, verbose = F, cue.rules = NULL)

Arguments

formula

A formula specifying a binary criterion as a function of multiple variables

data

A dataframe containing variables in formula

tree.criterion

A string indicating how to rank cues. "v" = HR - FAR, "d" = d-prime.

numthresh.method

A string indicating how to calculate cue splitting thresholds. "m" = median split, "o" = split that maximizes the tree criterion.

rounding

An integer indicating digit rounding for non-integer numeric cue thresholds. The default is NULL which means no rounding. A value of 0 rounds all possible thresholds to the nearest integer, 1 rounds to the nearest .1 (etc.).

verbose

A logical value indicating whether or not to print ongoing diagnostics

cue.rules

An optional df specifying how to make decisions for each cue. Must contain columns "cue", "class", "threshold" and "direction"

Value

A dataframe containing best thresholds and marginal classification statistics for each cue

Examples

 # What are the best thresholds for each cue in the mushrooms dataset?
 mushrooms.cues <- cuerank(formula = poisonous ~.,
                           data = mushrooms)