C5_rules: C5.0 rule-based classification models

In parsnip: A Common API to Modeling and Analysis Functions

C5.0 rule-based classification models

Description

C5_rules() defines a model that derives feature rules from a tree for prediction. A single tree or boosted ensemble can be used. This function can fit classification models.

\Sexpr[stage=render,results=rd]{parsnip:::make_engine_list("C5_rules")}

More information on how parsnip is used for modeling is at https://www.tidymodels.org/.

Usage

C5_rules(mode = "classification", trees = NULL, min_n = NULL, engine = "C5.0")

Arguments

mode	A single character string for the type of model. The only possible value for this model is "classification".
trees	A non-negative integer (no greater than 100) for the number of members of the ensemble.
min_n	An integer greater between zero and nine for the minimum number of data points in a node that are required for the node to be split further.
engine	A single character string specifying what computational engine to use for fitting.

Details

C5.0 is a classification model that is an extension of the C4.5 model of Quinlan (1993). It has tree- and rule-based versions that also include boosting capabilities. C5_rules() enables the version of the model that uses a series of rules (see the examples below). To make a set of rules, an initial C5.0 tree is created and flattened into rules. The rules are pruned, simplified, and ordered. Rule sets are created within each iteration of boosting.

This function only defines what type of model is being fit. Once an engine is specified, the method to fit the model is also defined. See set_engine() for more on setting the engine, including how to set engine arguments.

The model is not trained or fit until the fit() function is used with the data.

Each of the arguments in this function other than mode and engine are captured as quosures. To pass values programmatically, use the injection operator like so:

value <- 1
C5_rules(argument = !!value)

References

Quinlan R (1993). C4.5: Programs for Machine Learning. Morgan Kaufmann Publishers.

https://www.tidymodels.org, Tidy Modeling with R, searchable table of parsnip models

See Also

C50::C5.0(), C50::C5.0Control(), \Sexpr[stage=render,results=rd]{parsnip:::make_seealso_list("C5_rules")}

Examples

show_engines("C5_rules")

C5_rules()

parsnip documentation built on Aug. 18, 2023, 1:07 a.m.