Tuning Wrapper Function

Description

Convenience function to train a method using different tuning parameters.

Usage

  tuner(method, tunerange, ...)

Arguments

method	a character string. Name of the R function to train the method.
tunerange	a list. A list that specifies the range of values to be used for each tuning parameter. Each element of the list should be a vector that specifies the values to be tested for the tuning parameter. The element must be named after the corresponding tuning parameter of the method (see examples).
…	additional information passed to method (such as formula, data, subset, etc.).

Details

This function can be used to train any method using different values for its tuning parameter(s). The result can be passed directly to stability to compare the stability of results based on different values of the tuning parameter.

Value

A list that contains all fitted model objects.

Additional information about the range of values used for the tuning parameters is attached to the resulting object as an attribute.

See Also

stability

Examples

library("stablelearner")




library("partykit")

## tuning cforest using different values of its tuning parameter mtry
r <- tuner("cforest", tunerange = list(mtry = 1:4), formula = Species ~ ., data = iris)

## assess stability (with B = 10 for illustration to avoid excessive computation times)
stability(r, control = stab_control(seed = 1234, B = 10))

Call:
cforest(formula = Species ~ ., data = iris, mtry = 1L)
cforest(formula = Species ~ ., data = iris, mtry = 2L)
cforest(formula = Species ~ ., data = iris, mtry = 3L)
cforest(formula = Species ~ ., data = iris, mtry = 4L)

Sampler:
B = 10 
Resampling method = Bootstrap sampling with 100.0% data 
Evaluation method = OOB 

## receive information about the range of tuning parameters
attr(r, "range")

  mtry
1    1
2    2
3    3
4    4