rules-class {arules}R Documentation

Class “rules” — A Set of Rules

Description

The rules class represents a set of rules.

Note that the class can also represent a multiset of rules with duplicated elements. Duplicated elements can be removed with unique.

Objects from the Class

Objects are the result of calling the function apriori. Objects can also be created by calls of the form new("rules", ...).

Slots

lhs:
Object of class itemMatrix; the left-hand-sides of the rules (antecedents)
rhs:
Object of class itemMatrix; the right-hand-sides of the rules (consequents)
quality:
a data.frame

Extends

Class associations, directly.

Methods

coerce
signature(from = "rules", to = "data.frame"); represents the set of rules as a data.frame
itemInfo
signature(object = "rules"); returns the whole item information data frame including item labels
itemLabels
signature(object = "rules"); returns the item labels used to encode the rules
items
signature(x = "rules"); returns for each rule the union of the items in the lhs and rhs (i.e., the itemsets which generated the rule) as an itemMatrix
generatingItemsets
signature(x = "rules"); returns a collection of the itemsets which generated the rules (one itemset for each rule). Note that the collection can be a multiset and contain duplicated elements. Use unique to remove duplicates and obtain a proper set.
labels
signature(object = "rules"); returns labels for the rules ("{lhs} => {rhs}") as a character vector. The representation can be customized using the additional parameter ruleSep and parameters for label defined in itemMatrix
itemLabels
signature(object = "rules"); returns the item labels as a character vector. The index for each lable is the column index of the item in the binary matrix.
lhs
signature(x = "rules"); returns the itemMatrix representing the left-hand-side of the rules (antecedents)
lhs<-
signature(x = "rules"); replaces the itemMatrix representing the left-hand-side of the rules (antecedents)
rhs
signature(x = "rules"); returns the itemMatrix representing the right-hand-side of the rules (consequents)
rhs<-
signature(x = "rules"); replaces the itemMatrix representing the right-hand-side of the rules (consequents)
summary
signature(object = "rules")

See Also

[-methods, apriori, c, duplicated, inspect, length, match, sets, size, subset, associations-class, itemMatrix-class,

Examples

data("Adult")

## Mine rules.
rules <- apriori(Adult, parameter = list(support = 0.4))

## Select a subset of rules using partial matching on the items 
## in the right-hand-side and a quality measure
rules.sub <- subset(rules, subset = rhs %pin% "sex" & lift > 1.3)

## Display rules.
inspect(SORT(rules.sub)[1:3])

[Package arules version 1.0-0 Index]