screen.FSelector.relief: RReliefF screening algorithm

View source: R/fselector.R

screen.FSelector.reliefR Documentation

RReliefF screening algorithm

Description

The relief algorithm implements the RReliefF (Robnik-Sikonja & Kononenko, 1997) feature quality estimation algorithm, an extension to ReliefF (Kononenko, 1994) and Relief (Kira & Rendell, 1992) algorithms. RReliefF is compatible with both classification and regression problems and is well-suited to X with strong associations between features.

Usage

screen.FSelector.relief(
  Y,
  X,
  family,
  neighbours.count = formals(relief)$neighbours.count,
  sample.size = formals(relief)$sample.size,
  selector = c("cutoff.biggest.diff", "cutoff.k", "cutoff.k.percent"),
  k = switch(selector, cutoff.k = ceiling(0.5 * ncol(X)), cutoff.k.percent = 0.5, NULL),
  verbose = FALSE,
  ...
)

Arguments

Y

Outcome (numeric vector). See SuperLearner for specifics.

X

Predictor variable(s) (data.frame or matrix). See SuperLearner for specifics.

family

Error distribution to be used in the model: gaussian or binomial. Currently unused. See SuperLearner for specifics.

neighbours.count

Number of neighboring observations to find for each observation sampled from X

sample.size

Number of observations to sample from X

selector

A string corresponding to a subset selecting function implemented in the FSelector package. One of: cutoff.biggest.diff, cutoff.k, cutoff.k.percent, or "all". Note that "all" is a not a function but indicates pass-thru should be performed in the case of a filter which selects rather than ranks features. Default: "cutoff.biggest.diff".

k

Passed through to the selector in the case where selector is cutoff.k or cutoff.k.percent. Otherwise, should remain NULL (the default). For cutoff.k, this is an integer indicating the number of features to keep from X. For cutoff.k.percent, this is instead the proportion of features to keep.

verbose

Should debugging messages be printed? Default: FALSE.

...

Currently unused.

Value

A logical vector with length equal to ncol(X).

References

https://www.aaai.org/Library/AAAI/1992/aaai92-020.php, https://doi.org/10.1007/3-540-57868-4_57, http://dl.acm.org/citation.cfm?id=645526.657141

Examples

data(iris)
Y <- as.numeric(iris$Species=="setosa")
X <- iris[,-which(colnames(iris)=="Species")]
screen.FSelector.relief(Y, X, binomial(), selector = "cutoff.k.percent", k = 0.75)

data(mtcars)
Y <- mtcars$mpg
X <- mtcars[,-which(colnames(mtcars)=="mpg")]
screen.FSelector.relief(Y, X, gaussian(), neighbours.count = 3, sample.size = 15)

# based on examples in SuperLearner package
set.seed(1)
n <- 100
p <- 20
X <- matrix(rnorm(n*p), nrow = n, ncol = p)
X <- data.frame(X)
Y <- X[, 1] + sqrt(abs(X[, 2] * X[, 3])) + X[, 2] - X[, 3] + rnorm(n)

library(SuperLearner)
sl = SuperLearner(Y, X, family = gaussian(), cvControl = list(V = 2),
                  SL.library = list(c("SL.glm", "All"),
                                    c("SL.glm", "screen.FSelector.relief")))
sl
sl$whichScreen

saraemoore/SLScreenExtra documentation built on Nov. 4, 2023, 9:31 p.m.