showcues: Visualize cue accuracies (as points in ROC space)
In FFTrees: Generate, Visualise, and Evaluate Fast-and-Frugal Decision Trees

showcues

R Documentation

Visualize cue accuracies (as points in ROC space)

Description

showcues plots the cue accuracies of an FFTrees object created by the FFTrees function (as points in ROC space).

If the optional arguments cue.accuracies and alt.goal are specified, their values take precedence over the corresponding settings of an FFTrees object x (but do not change x).

showcues is called when the main plot.FFTrees function is set to what = "cues".

Usage

showcues(
  x = NULL,
  cue.accuracies = NULL,
  alt.goal = NULL,
  main = NULL,
  top = 5,
  quiet = list(ini = TRUE, fin = FALSE, set = TRUE),
  ...
)

Arguments

`x`	An `FFTrees` object created by the `FFTrees` function.
`cue.accuracies`	An optional data frame specifying cue accuracies directly (without specifying `FFTrees` object `x`).
`alt.goal`	An optional alternative goal to sort the current cue accuracies (without using the goal of `FFTrees` object `x`).
`main`	A main plot title (as character string).
`top`	How many of the top cues should be highlighted (as an integer)?
`quiet`	Should user feedback messages be suppressed (as a list of 3 logical arguments)? Default: `quiet = list(ini = TRUE, fin = FALSE, set = FALSE)`.
`...`	Graphical parameters (passed to `plot`).

Value

A plot showing cue accuracies (of an FFTrees object) (as points in ROC space).

Examples

# Create fast-and-frugal trees (FFTs) for heart disease:
heart.fft <- FFTrees(formula = diagnosis ~ .,
                     data = heart.train,
                     data.test = heart.test,
                     main = "Heart Disease",
                     decision.labels = c("Healthy", "Diseased")
                     )

# Show cue accuracies (in ROC space):
showcues(heart.fft,
         main = "Predicting heart disease")

FFTrees documentation built on June 7, 2023, 5:56 p.m.