Rule

java.lang.Object
- keel.Algorithms.Rule_Learning.Slipper.Rule

```
public class Rule
extends java.lang.Object
```
Representation of a string of simple rules chained by 'and's: exemple[a1][=|>|<=]v1 && exemple[a2][=|>=|<=]v2 The rule has also a positive value (confidence) associated.

Since:

JDK1.2

Version:

1.1

Author:

Written by Alberto Fernández (University of Granada) 01/07/2008, Modified by Xavi Solé (La Salle, Ramón Llull University - Barcelona) 03/12/2008

Field Summary

Fields
Modifier and Type Field and Description

static int EQUAL
Flag for equal operator

static int GREATER
Flag for greater operator

static int LOWER
Flag for lower operator

Fields
Modifier and Type	Field and Description
`static int`	`EQUAL` Flag for equal operator
`static int`	`GREATER` Flag for greater operator
`static int`	`LOWER` Flag for lower operator

Constructor Summary

Constructors
Constructor and Description

Rule()
Constructs an empty rule.

Constructors
Constructor and Description
`Rule()` Constructs an empty rule.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`apply(MyDataset data)` It returns the number of the instances covered by the rule in a given dataset
`int`	`apply(MyDataset data, Mask select)` Returns the number of the instances covered by the rule in a given dataset
`int`	`apply(MyDataset data, Mask select, int ignore)` Returns the number of the instances covered by the rule in a given dataset.
`keel.Algorithms.Rule_Learning.Slipper.Stats`	`apply(MyDataset data, Mask positives, Mask negatives)` It returns the number of true positives,true negatives,false positives and false negatives of the rule in a given dataset
`Rule`	`getCopy()` It returns a copy of this rule
`double`	`getCr()` Returns the confidence of the rule.
`static double`	`getDefaultW(MyDataset data, Mask actives, double[] distribution)` Computes W+ or W- for the default rule, according to the function W=sum(Di) i e R
`SimpleRule`	`getSimpleRule(int i)` Returns the i-ieth simple rule of this rule.
`java.lang.String`	`getType()` It returns the right side (class) of the rule.
`double`	`getW(MyDataset data, Mask actives, double[] distribution)` Computes W+ or W- for this rule, according to the function W=sum(Di) i e R
`void`	`grow(int attribute, double value, int operator)` Adds a simple rule to this rule.
`void`	`grow(SimpleRule sr)` Adds a simple rule to this rule.
`boolean`	`isEqual(Rule r)` Return wether this rule is equal to another given rule
`void`	`prune(int pos)` Deletes a simple rule from this chain
`void`	`setCr(double newCr)` Sets the new confidence of the rule.
`void`	`setCr(MyDataset data, Mask positives, Mask negatives, double[] distribution)` Computes the confidence of this rule, according to the equation 4 of [AAAI99]: Cr=1/2ln((W+ + 1/(2n))/(W_ + 1/(2n))) W+: sum of the weights of the positive instances that are covered by the current rule W_: sum of the weights of the negative instances that are covered by the current rule n: \|p\|+\|n\|
`void`	`setType(java.lang.String new_class)` It sets the right side of the rule.
`int`	`size()` Returns the size (number of simple rules) of the rule
`java.lang.String`	`toString()` Returns a string representation of this Rule, containing the String representation of each SimpleRule.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - GREATER
```
public static int GREATER
```
    Flag for greater operator
  - LOWER
```
public static int LOWER
```
    Flag for lower operator
  - EQUAL
```
public static int EQUAL
```
    Flag for equal operator
- Constructor Detail
  - Rule
```
public Rule()
```
    Constructs an empty rule.
- Method Detail
  - apply
```
public int apply(MyDataset data,
                 Mask select,
                 int ignore)
```
    Returns the number of the instances covered by the rule in a given dataset. This method allows to ignore a simple rule from that rule.
    
    Parameters:
    
    data - MyDataset the dataset
    
    select - Mask the mask with the active entries of the dataset
    
    ignore - int id of the single rule that it will be ignore in the applying of the rule
    
    Returns:
    
    number of instances (from the active entries) covered by the rule
  - apply
```
public int apply(MyDataset data,
                 Mask select)
```
    Returns the number of the instances covered by the rule in a given dataset
    
    Parameters:
    
    data - MyDataset the dataset
    
    select - Mask the mask with the active entries of the dataset
    
    Returns:
    
    number of instances (from the active entries) covered by the rule
  - apply
```
public int apply(MyDataset data)
```
    It returns the number of the instances covered by the rule in a given dataset
    
    Parameters:
    
    data - MyDataset the dataset
    
    Returns:
    
    number of instances (from the active entries) covered by the rule
  - apply
```
public keel.Algorithms.Rule_Learning.Slipper.Stats apply(MyDataset data,
                                                         Mask positives,
                                                         Mask negatives)
```
    It returns the number of true positives,true negatives,false positives and false negatives of the rule in a given dataset
    
    Parameters:
    
    data - MyDataset the dataset
    
    positives - active positive instances of data
    
    negatives - active negative instances of data
    
    Returns:
    
    number of true positives, false positives, true negatives and false negatives of the rule in the following order: {tp,tn,fp,fn}
  - getDefaultW
```
public static double getDefaultW(MyDataset data,
                                 Mask actives,
                                 double[] distribution)
```
    Computes W+ or W- for the default rule, according to the function W=sum(Di) i e R
    
    Parameters:
    
    data - MyDataset the dataset
    
    actives - Mask the active entries (positives or negatives)
    
    distribution - double[] the distribution D of weights
    
    Returns:
    
    W=sum(Di) i e R (W+ if actives are positives, W- if they are negatives)
  - getW
```
public double getW(MyDataset data,
                   Mask actives,
                   double[] distribution)
```
    Computes W+ or W- for this rule, according to the function W=sum(Di) i e R
    
    Parameters:
    
    data - MyDataset the dataset
    
    actives - Mask the active entries
    
    distribution - double[] the distribution D
    
    Returns:
    
    W=sum(Di) i e R (W+ if actives are positives, W- if they are negatives)
  - setCr
```
public void setCr(MyDataset data,
                  Mask positives,
                  Mask negatives,
                  double[] distribution)
```
    Computes the confidence of this rule, according to the equation 4 of [AAAI99]: Cr=1/2ln((W+ + 1/(2n))/(W_ + 1/(2n))) W+: sum of the weights of the positive instances that are covered by the current rule W_: sum of the weights of the negative instances that are covered by the current rule n: |p|+|n|
    
    Parameters:
    
    data - MyDataset the dataset
    
    positives - Mask the positive entries
    
    negatives - Mask the negative entries
    
    distribution - double[] the distribution D of weights
  - setCr
```
public void setCr(double newCr)
```
    Sets the new confidence of the rule.
    
    Parameters:
    
    newCr - the new confidence.
  - getCr
```
public double getCr()
```
    Returns the confidence of the rule.
    
    Returns:
    
    the confidence of the rule.
  - getSimpleRule
```
public SimpleRule getSimpleRule(int i)
```
    Returns the i-ieth simple rule of this rule.
    
    Parameters:
    
    i - position of the simple rule
    
    Returns:
    
    the i-ieth simple rule of this rule.
  - grow
```
public void grow(int attribute,
                 double value,
                 int operator)
```
    Adds a simple rule to this rule.
    
    Parameters:
    
    attribute - int attribute id (position of the attribute)
    
    value - double attribute's value
    
    operator - int rule operator
  - grow
```
public void grow(SimpleRule sr)
```
    Adds a simple rule to this rule.
    
    Parameters:
    
    sr - SimpleRule the simple rule
  - setType
```
public void setType(java.lang.String new_class)
```
    It sets the right side of the rule.
    
    Parameters:
    
    new_class - double new class of the rule
  - getType
```
public java.lang.String getType()
```
    It returns the right side (class) of the rule.
    
    Returns:
    
    the right side (class) of the rule.
  - getCopy
```
public Rule getCopy()
```
    It returns a copy of this rule
    
    Returns:
    
    a copy of this rule
  - prune
```
public void prune(int pos)
```
    Deletes a simple rule from this chain
    
    Parameters:
    
    pos - int position of the simple rule of the rule
  - size
```
public int size()
```
    Returns the size (number of simple rules) of the rule
    
    Returns:
    
    the size (number of simple rules) of the rule
  - isEqual
```
public boolean isEqual(Rule r)
```
    Return wether this rule is equal to another given rule
    
    Parameters:
    
    r - Rule the given rule
    
    Returns:
    
    true if this rule is equal to the given rule
  - toString
```
public java.lang.String toString()
```
    Returns a string representation of this Rule, containing the String representation of each SimpleRule.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    a string representation of this Rule, containing the String representation of each SimpleRule.

Class Rule

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

GREATER

LOWER

EQUAL

Constructor Detail

Rule

Method Detail

apply

apply

apply

apply

getDefaultW

getW

setCr

setCr

getCr

getSimpleRule

grow

grow

setType

getType

getCopy

prune

size

isEqual

toString