Package weka.associations
Class FilteredAssociator
java.lang.Object
weka.associations.AbstractAssociator
weka.associations.SingleAssociatorEnhancer
weka.associations.FilteredAssociator
- All Implemented Interfaces:
Serializable,Cloneable,Associator,CapabilitiesHandler,OptionHandler,RevisionHandler
Class for running an arbitrary associator on data that has been passed through an arbitrary filter. Like the associator, the structure of the filter is based exclusively on the training data and test instances will be processed by the filter without changing their structure.
Valid options are:
-F <filter specification> Full class name of filter to use, followed by filter options. eg: "weka.filters.unsupervised.attribute.Remove -V -R 1,2" (default: weka.filters.MultiFilter with weka.filters.unsupervised.attribute.ReplaceMissingValues)
-c <the class index> The class index. (default: -1, i.e. unset)
-W Full name of base associator. (default: weka.associations.Apriori)
Options specific to associator weka.associations.Apriori:
-N <required number of rules output> The required number of rules. (default = 10)
-T <0=confidence | 1=lift | 2=leverage | 3=Conviction> The metric type by which to rank rules. (default = confidence)
-C <minimum metric score of a rule> The minimum confidence of a rule. (default = 0.9)
-D <delta for minimum support> The delta by which the minimum support is decreased in each iteration. (default = 0.05)
-U <upper bound for minimum support> Upper bound for minimum support. (default = 1.0)
-M <lower bound for minimum support> The lower bound for the minimum support. (default = 0.1)
-S <significance level> If used, rules are tested for significance at the given level. Slower. (default = no significance testing)
-I If set the itemsets found are also output. (default = no)
-R Remove columns that contain all missing values (default = no)
-V Report progress iteratively. (default = no)
-A If set class association rules are mined. (default = no)
-c <the class index> The class index. (default = last)
- Version:
- $Revision: 5504 $
- Author:
- Len Trigg (trigg@cs.waikato.ac.nz), FracPete (fracpete at waikato dot ac dot nz)
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidbuildAssociations(Instances data) Build the associator on the filtered data.Returns the tip text for this propertyReturns the tip text for this propertyReturns default capabilities of the associator.intGets the class indexGets the filter used.String[]Gets the current settings of the Associator.Returns the revision string.Returns a string describing this AssociatorReturns an enumeration describing the available options.static voidMain method for running this class.voidsetClassIndex(int value) Sets the class indexvoidSets the filtervoidsetOptions(String[] options) Parses a given list of options.toString()Output a representation of this associatorMethods inherited from class weka.associations.SingleAssociatorEnhancer
associatorTipText, getAssociator, setAssociatorMethods inherited from class weka.associations.AbstractAssociator
forName, makeCopies, makeCopy
-
Constructor Details
-
FilteredAssociator
public FilteredAssociator()Default constructor.
-
-
Method Details
-
globalInfo
Returns a string describing this Associator- Returns:
- a description of the Associator suitable for displaying in the explorer/experimenter gui
-
listOptions
Returns an enumeration describing the available options.- Specified by:
listOptionsin interfaceOptionHandler- Overrides:
listOptionsin classSingleAssociatorEnhancer- Returns:
- an enumeration of all the available options.
-
setOptions
Parses a given list of options. Valid options are:-F <filter specification> Full class name of filter to use, followed by filter options. eg: "weka.filters.unsupervised.attribute.Remove -V -R 1,2" (default: weka.filters.MultiFilter with weka.filters.unsupervised.attribute.ReplaceMissingValues)
-c <the class index> The class index. (default: -1, i.e. unset)
-W Full name of base associator. (default: weka.associations.Apriori)
Options specific to associator weka.associations.Apriori:
-N <required number of rules output> The required number of rules. (default = 10)
-T <0=confidence | 1=lift | 2=leverage | 3=Conviction> The metric type by which to rank rules. (default = confidence)
-C <minimum metric score of a rule> The minimum confidence of a rule. (default = 0.9)
-D <delta for minimum support> The delta by which the minimum support is decreased in each iteration. (default = 0.05)
-U <upper bound for minimum support> Upper bound for minimum support. (default = 1.0)
-M <lower bound for minimum support> The lower bound for the minimum support. (default = 0.1)
-S <significance level> If used, rules are tested for significance at the given level. Slower. (default = no significance testing)
-I If set the itemsets found are also output. (default = no)
-R Remove columns that contain all missing values (default = no)
-V Report progress iteratively. (default = no)
-A If set class association rules are mined. (default = no)
-c <the class index> The class index. (default = last)
- Specified by:
setOptionsin interfaceOptionHandler- Overrides:
setOptionsin classSingleAssociatorEnhancer- Parameters:
options- the list of options as an array of strings- Throws:
Exception- if an option is not supported
-
getOptions
Gets the current settings of the Associator.- Specified by:
getOptionsin interfaceOptionHandler- Overrides:
getOptionsin classSingleAssociatorEnhancer- Returns:
- an array of strings suitable for passing to setOptions
-
filterTipText
Returns the tip text for this property- Returns:
- tip text for this property suitable for displaying in the explorer/experimenter gui
-
setFilter
Sets the filter- Parameters:
value- the filter with all options set.
-
getFilter
Gets the filter used.- Returns:
- the current filter
-
classIndexTipText
Returns the tip text for this property- Returns:
- tip text for this property suitable for displaying in the explorer/experimenter gui
-
setClassIndex
public void setClassIndex(int value) Sets the class index- Parameters:
value- the class index
-
getClassIndex
public int getClassIndex()Gets the class index- Returns:
- the index of the class attribute
-
getCapabilities
Returns default capabilities of the associator.- Specified by:
getCapabilitiesin interfaceAssociator- Specified by:
getCapabilitiesin interfaceCapabilitiesHandler- Overrides:
getCapabilitiesin classSingleAssociatorEnhancer- Returns:
- the capabilities of this associator
- See Also:
-
buildAssociations
Build the associator on the filtered data.- Parameters:
data- the training data- Throws:
Exception- if the Associator could not be built successfully
-
toString
Output a representation of this associator -
getRevision
Returns the revision string.- Specified by:
getRevisionin interfaceRevisionHandler- Overrides:
getRevisionin classAbstractAssociator- Returns:
- the revision
-
main
Main method for running this class.- Parameters:
args- commandline arguments, use "-h" for full list
-