varImp: varImp

In varImp: RF Variable Importance for Arbitrary Measures

Description

Computes the variable importance for arbitrary measures from the 'measures' package.

Usage

varImp(
  object,
  mincriterion = 0,
  conditional = FALSE,
  threshold = 0.2,
  nperm = 1,
  OOB = TRUE,
  pre1.0_0 = conditional,
  measure = "multiclass.Brier",
  ...
)

Arguments

object	An object as returned by cforest.
mincriterion	The value of the test statistic or 1 - p-value that must be exceeded in order to include a split in the computation of the importance. The default mincriterion = 0 guarantees that all splits are included.
conditional	a logical determining whether unconditional or conditional computation of the importance is performed.
threshold	The threshold value for (1 - p-value) of the association between the variable of interest and a covariate, which must be exceeded inorder to include the covariate in the conditioning scheme for the variable of interest (only relevant if conditional = TRUE). A threshold value of zero includes all covariates.
nperm	The number of permutations performed.
OOB	A logical determining whether the importance is computed from the out-of-bag sample or the learning sample (not suggested).
pre1.0_0	Prior to party version 1.0-0, the actual data values were permuted according to the original permutation importance suggested by Breiman (2001). Now the assignments to child nodes of splits in the variable of interest are permuted as described by Hapfelmeier et al. (2012), which allows for missing values in the explanatory variables and is more efficient wrt memory consumption and computing time. This method does not apply to conditional variable importances.
measure	The name of the measure of the 'measures' package that should be used for the variable importance calculation.
...	Further arguments (like positive or negativ class) that are needed by the measure.

Details

Many measures have not been tested for the usefulness of random forests variable importance. Use at your own risk.

Value

Vector with computed permutation importance for each variable.

Examples

# multiclass case
data(iris)
iris.cf = cforest(Species ~ ., data = iris, control = cforest_unbiased(mtry = 2, ntree = 50))
set.seed(123)
vimp = varImp(object = iris.cf, measure = "multiclass.Brier")
vimp

Example output

Loading required package: measures
Loading required package: party
Loading required package: grid
Loading required package: mvtnorm
Loading required package: modeltools
Loading required package: stats4
Loading required package: strucchange
Loading required package: zoo

Attaching package: ‘zoo’

The following objects are masked from ‘package:base’:

    as.Date, as.Date.numeric

Loading required package: sandwich
Sepal.Length  Sepal.Width Petal.Length  Petal.Width 
  0.05590956   0.00482523   0.55182430   0.54020325 

varImp documentation built on July 1, 2020, 7:03 p.m.