public class Tertius extends AbstractAssociator implements OptionHandler, java.lang.Runnable, TechnicalInformationHandler
@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)
Modifier and Type | Field and Description |
---|---|
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 and Description |
---|
Tertius()
Constructor that sets the options to the default values.
|
Modifier and Type | Method and Description |
---|---|
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
|
java.lang.String |
getRevision()
Returns the revision string.
|
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.
|
forName, makeCopies, makeCopy
public static final int EXPLICIT
public static final int IMPLICIT
public static final int SIGNIFICANT
public Tertius()
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 Associator
getCapabilities
in interface CapabilitiesHandler
getCapabilities
in class AbstractAssociator
Capabilities
public void buildAssociations(Instances instances) throws java.lang.Exception
buildAssociations
in interface 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 java.lang.String getRevision()
getRevision
in interface RevisionHandler
getRevision
in class AbstractAssociator
public static void main(java.lang.String[] args)
args
- the commandline parameters