|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectweka.associations.Associator
weka.associations.Tertius
public class Tertius
Finds rules according to confirmation measure (Tertius-type algorithm).
For more information see:
P. A. Flach, N. Lachiche (1999). Confirmation-Guided Discovery of first-order rules with Tertius. Machine Learning. 42:61-95.
@article{Flach1999, author = {P. A. Flach and N. Lachiche}, journal = {Machine Learning}, pages = {61-95}, title = {Confirmation-Guided Discovery of first-order rules with Tertius}, volume = {42}, year = {1999} }Valid options are:
-K <number of values in result> Set maximum number of confirmation values in the result. (default: 10)
-F <frequency threshold> Set frequency threshold for pruning. (default: 0)
-C <confirmation threshold> Set confirmation threshold. (default: 0)
-N <noise threshold> Set noise threshold : maximum frequency of counter-examples. 0 gives only satisfied rules. (default: 1)
-R Allow attributes to be repeated in a same rule.
-L <number of literals> Set maximum number of literals in a rule. (default: 4)
-G <0=no negation | 1=body | 2=head | 3=body and head> Set the negations in the rule. (default: 0)
-S Consider only classification rules.
-c <class index> Set index of class attribute. (default: last).
-H Consider only horn clauses.
-E Keep equivalent rules.
-M Keep same clauses.
-T Keep subsumed rules.
-I <0=always match | 1=never match | 2=significant> Set the way to handle missing values. (default: 0)
-O Use ROC analysis.
-p <name of file> Set the file containing the parts of the individual for individual-based learning.
-P <0=no output | 1=on stdout | 2=in separate window> Set output of current values. (default: 0)
Field Summary | |
---|---|
static int |
EXPLICIT
Way of handling missing values: min counterinstances |
static int |
IMPLICIT
Way of handling missing values: max counterinstances |
static int |
SIGNIFICANT
Way of handling missing values: missing as a particular value |
Constructor Summary | |
---|---|
Tertius()
Constructor that sets the options to the default values. |
Method Summary | |
---|---|
void |
buildAssociations(Instances instances)
Method that launches the search to find the rules with the highest confirmation. |
java.lang.String |
classificationTipText()
Returns the tip text for this property. |
java.lang.String |
classIndexTipText()
Returns the tip text for this property. |
java.lang.String |
confirmationThresholdTipText()
Returns the tip text for this property. |
java.lang.String |
confirmationValuesTipText()
Returns the tip text for this property. |
boolean |
disabled_getEquivalent()
Get the value of equivalent. |
java.io.File |
disabled_getPartFile()
Get the value of partFile. |
boolean |
disabled_getSameClause()
Get the value of sameClause. |
boolean |
disabled_getSubsumption()
Get the value of subsumption. |
void |
disabled_setEquivalent(boolean v)
Set the value of equivalent. |
void |
disabled_setPartFile(java.io.File v)
Set the value of partFile. |
void |
disabled_setSameClause(boolean v)
Set the value of sameClause. |
void |
disabled_setSubsumption(boolean v)
Set the value of subsumption. |
java.lang.String |
equivalentTipText()
Returns the tip text for this property. |
java.lang.String |
frequencyThresholdTipText()
Returns the tip text for this property. |
Capabilities |
getCapabilities()
Returns default capabilities of the classifier. |
boolean |
getClassification()
Get the value of classification. |
int |
getClassIndex()
Get the value of classIndex. |
double |
getConfirmationThreshold()
Get the value of confirmationThreshold. |
int |
getConfirmationValues()
Get the value of confirmationValues. |
double |
getFrequencyThreshold()
Get the value of frequencyThreshold. |
boolean |
getHornClauses()
Get the value of hornClauses. |
SelectedTag |
getMissingValues()
Get the value of missingValues. |
SelectedTag |
getNegation()
Get the value of negation. |
double |
getNoiseThreshold()
Get the value of noiseThreshold. |
int |
getNumberLiterals()
Get the value of numberLiterals. |
java.lang.String[] |
getOptions()
Gets the current settings of the Tertius object. |
boolean |
getRepeatLiterals()
Get the value of repeatLiterals. |
SimpleLinkedList |
getResults()
returns the results |
boolean |
getRocAnalysis()
Get the value of rocAnalysis. |
TechnicalInformation |
getTechnicalInformation()
Returns an instance of a TechnicalInformation object, containing detailed information about the technical background of this class, e.g., paper reference or book this class is based on. |
SelectedTag |
getValuesOutput()
Get the value of valuesOutput. |
java.lang.String |
globalInfo()
Returns a string describing this associator. |
java.lang.String |
hornClausesTipText()
Returns the tip text for this property. |
java.util.Enumeration |
listOptions()
Returns an enumeration describing the available options. |
static void |
main(java.lang.String[] args)
Main method. |
java.lang.String |
missingValuesTipText()
Returns the tip text for this property. |
java.lang.String |
negationTipText()
Returns the tip text for this property. |
java.lang.String |
noiseThresholdTipText()
Returns the tip text for this property. |
java.lang.String |
numberLiteralsTipText()
Returns the tip text for this property. |
java.lang.String |
partFileTipText()
Returns the tip text for this property. |
java.lang.String |
repeatLiteralsTipText()
Returns the tip text for this property. |
void |
resetOptions()
Resets the options to the default values. |
java.lang.String |
rocAnalysisTipText()
Returns the tip text for this property. |
void |
run()
Run the search. |
java.lang.String |
sameClauseTipText()
Returns the tip text for this property. |
void |
search()
Search in the space of hypotheses the rules that have the highest confirmation. |
void |
setClassification(boolean v)
Set the value of classification. |
void |
setClassIndex(int v)
Set the value of classIndex. |
void |
setConfirmationThreshold(double v)
Set the value of confirmationThreshold. |
void |
setConfirmationValues(int v)
Set the value of confirmationValues. |
void |
setFrequencyThreshold(double v)
Set the value of frequencyThreshold. |
void |
setHornClauses(boolean v)
Set the value of hornClauses. |
void |
setMissingValues(SelectedTag v)
Set the value of missingValues. |
void |
setNegation(SelectedTag v)
Set the value of negation. |
void |
setNoiseThreshold(double v)
Set the value of noiseThreshold. |
void |
setNumberLiterals(int v)
Set the value of numberLiterals. |
void |
setOptions(java.lang.String[] options)
Parses a given list of options. |
void |
setRepeatLiterals(boolean v)
Set the value of repeatLiterals. |
void |
setRocAnalysis(boolean v)
Set the value of rocAnalysis. |
void |
setValuesOutput(SelectedTag v)
Set the value of valuesOutput. |
java.lang.String |
subsumptionTipText()
Returns the tip text for this property. |
java.lang.String |
toString()
Outputs the best rules found with their confirmation value and number of counter-instances. |
java.lang.String |
valuesOutputTipText()
Returns the tip text for this property. |
Methods inherited from class weka.associations.Associator |
---|
forName, makeCopies, makeCopy |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final int EXPLICIT
public static final int IMPLICIT
public static final int SIGNIFICANT
Constructor Detail |
---|
public Tertius()
Method Detail |
---|
public java.lang.String globalInfo()
public TechnicalInformation getTechnicalInformation()
getTechnicalInformation
in interface TechnicalInformationHandler
public void resetOptions()
public java.util.Enumeration listOptions()
listOptions
in interface OptionHandler
public void setOptions(java.lang.String[] options) throws java.lang.Exception
-K <number of values in result> Set maximum number of confirmation values in the result. (default: 10)
-F <frequency threshold> Set frequency threshold for pruning. (default: 0)
-C <confirmation threshold> Set confirmation threshold. (default: 0)
-N <noise threshold> Set noise threshold : maximum frequency of counter-examples. 0 gives only satisfied rules. (default: 1)
-R Allow attributes to be repeated in a same rule.
-L <number of literals> Set maximum number of literals in a rule. (default: 4)
-G <0=no negation | 1=body | 2=head | 3=body and head> Set the negations in the rule. (default: 0)
-S Consider only classification rules.
-c <class index> Set index of class attribute. (default: last).
-H Consider only horn clauses.
-E Keep equivalent rules.
-M Keep same clauses.
-T Keep subsumed rules.
-I <0=always match | 1=never match | 2=significant> Set the way to handle missing values. (default: 0)
-O Use ROC analysis.
-p <name of file> Set the file containing the parts of the individual for individual-based learning.
-P <0=no output | 1=on stdout | 2=in separate window> Set output of current values. (default: 0)
setOptions
in interface OptionHandler
options
- The list of options as an array of strings.
java.lang.Exception
- if an option is not supported.public java.lang.String[] getOptions()
getOptions
in interface OptionHandler
public java.lang.String confirmationValuesTipText()
public int getConfirmationValues()
public void setConfirmationValues(int v)
v
- Value to assign to confirmationValues.public java.lang.String frequencyThresholdTipText()
public double getFrequencyThreshold()
public void setFrequencyThreshold(double v)
v
- Value to assign to frequencyThreshold.public java.lang.String confirmationThresholdTipText()
public double getConfirmationThreshold()
public void setConfirmationThreshold(double v)
v
- Value to assign to confirmationThreshold.public java.lang.String noiseThresholdTipText()
public double getNoiseThreshold()
public void setNoiseThreshold(double v)
v
- Value to assign to noiseThreshold.public java.lang.String repeatLiteralsTipText()
public boolean getRepeatLiterals()
public void setRepeatLiterals(boolean v)
v
- Value to assign to repeatLiterals.public java.lang.String numberLiteralsTipText()
public int getNumberLiterals()
public void setNumberLiterals(int v)
v
- Value to assign to numberLiterals.public java.lang.String negationTipText()
public SelectedTag getNegation()
public void setNegation(SelectedTag v)
v
- Value to assign to negation.public java.lang.String classificationTipText()
public boolean getClassification()
public void setClassification(boolean v)
v
- Value to assign to classification.public java.lang.String classIndexTipText()
public int getClassIndex()
public void setClassIndex(int v)
v
- Value to assign to classIndex.public java.lang.String hornClausesTipText()
public boolean getHornClauses()
public void setHornClauses(boolean v)
v
- Value to assign to hornClauses.public java.lang.String equivalentTipText()
public boolean disabled_getEquivalent()
public void disabled_setEquivalent(boolean v)
v
- Value to assign to equivalent.public java.lang.String sameClauseTipText()
public boolean disabled_getSameClause()
public void disabled_setSameClause(boolean v)
v
- Value to assign to sameClause.public java.lang.String subsumptionTipText()
public boolean disabled_getSubsumption()
public void disabled_setSubsumption(boolean v)
v
- Value to assign to subsumption.public java.lang.String missingValuesTipText()
public SelectedTag getMissingValues()
public void setMissingValues(SelectedTag v)
v
- Value to assign to missingValues.public java.lang.String rocAnalysisTipText()
public boolean getRocAnalysis()
public void setRocAnalysis(boolean v)
v
- Value to assign to rocAnalysis.public java.lang.String partFileTipText()
public java.io.File disabled_getPartFile()
public void disabled_setPartFile(java.io.File v) throws java.lang.Exception
v
- Value to assign to partFile.
java.lang.Exception
- if file cannot be openedpublic java.lang.String valuesOutputTipText()
public SelectedTag getValuesOutput()
public void setValuesOutput(SelectedTag v)
v
- Value to assign to valuesOutput.public Capabilities getCapabilities()
getCapabilities
in interface CapabilitiesHandler
getCapabilities
in class Associator
Capabilities
public void buildAssociations(Instances instances) throws java.lang.Exception
buildAssociations
in class Associator
instances
- The instances to be used for generating the rules.
java.lang.Exception
- if rules can't be built successfully.public void run()
run
in interface java.lang.Runnable
public void search()
public SimpleLinkedList getResults()
public java.lang.String toString()
toString
in class java.lang.Object
public static void main(java.lang.String[] args)
args
- the commandline parameters
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |