// Copyright 2015 Georg-August-Universität Göttingen, Germany // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package de.ugoe.cs.cpdp.wekaclassifier; import java.util.ArrayList; import java.util.Arrays; import java.util.Collections; import java.util.LinkedList; import java.util.List; import java.util.Random; import java.util.logging.Level; import de.ugoe.cs.util.console.Console; import weka.classifiers.AbstractClassifier; import weka.core.Attribute; import weka.core.Instance; import weka.core.Instances; import weka.filters.Filter; import weka.filters.unsupervised.attribute.Discretize; /** *

* WHICH classifier after Menzies et al. *

* * @author Steffen Herbold */ public class WHICH extends AbstractClassifier { /** * default id. */ private static final long serialVersionUID = 1L; /** * number of bins used for discretization of data */ private int numBins = 7; /** * number of new rules generate within each rule generation iteration */ private final int numNewRules = 5; /** * number of rule generation iterations */ private final int newRuleIterations = 20; /** * maximal number of tries to improve the best score */ private final int maxIter = 100; /** * best rule determined by the training, i.e., the classifier */ private WhichRule bestRule = null; /* * (non-Javadoc) * * @see weka.classifiers.Classifier#buildClassifier(weka.core.Instances) */ @Override public void buildClassifier(Instances traindata) throws Exception { WhichStack whichStack = new WhichStack(); Discretize discretize = new Discretize(); discretize.setBins(numBins); discretize.setIgnoreClass(true); discretize.setInputFormat(traindata); Instances discretizedData = Filter.useFilter(traindata, discretize); // init WHICH stack for (int j = 0; j < discretizedData.numAttributes(); j++) { Attribute attr = discretizedData.attribute(j); for (int k = 0; k < attr.numValues(); k++) { // create rules for single variables WhichRule rule = new WhichRule(Arrays.asList(new Integer[] { j }), Arrays.asList(new Double[] { (double) k }), Arrays.asList(new String[] { attr.value(k) })); rule.scoreRule(discretizedData); whichStack.push(rule); } } double curBestScore = whichStack.bestScore; int iter = 0; do { // generate new rules for (int i = 0; i < newRuleIterations; i++) { whichStack.generateRules(numNewRules, discretizedData); } if (curBestScore >= whichStack.bestScore) { // no improvement, terminate break; } curBestScore = whichStack.bestScore; iter++; } while (iter < maxIter); bestRule = whichStack.bestRule(); } /* * (non-Javadoc) * * @see weka.classifiers.AbstractClassifier#classifyInstance(weka.core.Instance) */ @Override public double classifyInstance(Instance instance) { if (bestRule == null) { throw new RuntimeException("you have to build the classifier first!"); } return bestRule.applyRule(instance, false) ? 0.0 : 1.0; } /** *

* Internal helper class to handle WHICH rules. The compareTo method is NOT consistent with the * equals method! *

* * @author Steffen Herbold */ private class WhichRule implements Comparable { /** * indizes of the attributes in the data to which the rule is applied */ final List attributeIndizes; /** * index of the range for internal optimization during training */ final List rangeIndizes; /** * String of the range as created by Discretize. */ final List ranges; /** * support of the rule */ double support; /** * percentage of the defective matches where the rule applies */ double e1; /** * percentage of the non-defective matches where the rule does not apply */ double e2; /** * score of the rule */ double score; /** *

* Creates a new WhichRule. *

* * @param attributeIndizes * attribute indizes * @param rangeIndizes * range indizes * @param ranges * range strings */ public WhichRule(List attributeIndizes, List rangeIndizes, List ranges) { this.attributeIndizes = attributeIndizes; this.rangeIndizes = rangeIndizes; this.ranges = ranges; } /** *

* Combines two rules into a new rule *

* * @param rule1 * first rule in combination * @param rule2 * second rule in combination */ public WhichRule(WhichRule rule1, WhichRule rule2) { attributeIndizes = new ArrayList<>(rule1.attributeIndizes); rangeIndizes = new ArrayList<>(rule1.rangeIndizes); ranges = new ArrayList<>(rule1.ranges); for (int k = 0; k < rule2.attributeIndizes.size(); k++) { if (!attributeIndizes.contains(rule2.attributeIndizes.get(k))) { attributeIndizes.add(rule2.attributeIndizes.get(k)); rangeIndizes.add(rule2.rangeIndizes.get(k)); ranges.add(rule2.ranges.get(k)); } } } /** *

* Determines the score of a rule. *

* * @param traindata */ public void scoreRule(Instances traindata) { int numMatches = 0; int numMatchDefective = 0; int numMatchNondefective = 0; @SuppressWarnings("unused") int numNoMatchDefective = 0; @SuppressWarnings("unused") int numNoMatchNondefective = 0; for (int i = 0; i < traindata.size(); i++) { // check if rule applies if (applyRule(traindata.get(i), true)) { // to something numMatches++; if (traindata.get(i).classValue() == 1.0) { numMatchDefective++; } else { numMatchNondefective++; } } else { if (traindata.get(i).classValue() == 1.0) { numNoMatchDefective++; } else { numNoMatchNondefective++; } } } support = numMatches / ((double) traindata.size()); if (numMatches > 0) { e1 = numMatchNondefective / ((double) numMatches); e2 = numMatchDefective / ((double) numMatches); if (e2 > 0) { score = e1 / e2 * support; } else { score = 0; } } else { e1 = 0; e2 = 0; score = 0; } if (score == 0) { score = 0.000000001; // to disallow 0 total score } } /** *

* Checks if a rule applies to an instance. *

* * @param instance * the instance * @param isTraining * if true, the data is discretized training data and rangeIndizes are used; * otherwise the data is numeric and the range string is used. * @return true if the rule applies */ public boolean applyRule(Instance instance, boolean isTraining) { boolean result = true; for (int k = 0; k < attributeIndizes.size(); k++) { int attrIndex = attributeIndizes.get(k); if (isTraining) { double rangeIndex = rangeIndizes.get(k); double instanceValue = instance.value(attrIndex); result &= (instanceValue == rangeIndex); } else { String range = ranges.get(k); if ("'All'".equals(range)) { result = true; } else { double instanceValue = instance.value(attrIndex); double lowerBound; double upperBound; String[] splitResult = range.split("--"); if (splitResult.length > 1) { // second value is negative throw new RuntimeException("negative second value cannot be handled by WHICH yet"); } else { splitResult = range.split("-"); if (splitResult.length > 2) { // first value is negative if ("inf".equals(splitResult[1])) { lowerBound = Double.NEGATIVE_INFINITY; } else { lowerBound = -Double.parseDouble(splitResult[1]); } if (splitResult[2].startsWith("inf")) { upperBound = Double.POSITIVE_INFINITY; } else { upperBound = Double.parseDouble(splitResult[2] .substring(0, splitResult[2].length() - 2)); } } else { // first value is positive if (splitResult[0].substring(2, splitResult[0].length()) .equals("ll'")) { System.out.println("foo"); } lowerBound = Double.parseDouble(splitResult[0] .substring(2, splitResult[0].length())); if (splitResult[1].startsWith("inf")) { upperBound = Double.POSITIVE_INFINITY; } else { upperBound = Double.parseDouble(splitResult[1] .substring(0, splitResult[1].length() - 2)); } } } boolean lowerBoundMatch = (range.charAt(1) == '(' && instanceValue > lowerBound) || (range.charAt(1) == '[' && instanceValue >= lowerBound); boolean upperBoundMatch = (range.charAt(range.length() - 2) == ')' && instanceValue < upperBound) || (range.charAt(range.length() - 2) == ']' && instanceValue <= upperBound); result = lowerBoundMatch && upperBoundMatch; } } } return result; } /** *

* returns the score of the rule *

* * @return the score */ public double getScore() { return score; } /* * (non-Javadoc) * * @see java.lang.Comparable#compareTo(java.lang.Object) */ @Override public int compareTo(WhichRule other) { // !!this compareTo is NOT consistent with equals!! if (other == null) { return -1; } if (other.score < this.score) { return -1; } else if (other.score > this.score) { return 1; } else { return 0; } } /* * (non-Javadoc) * * @see java.lang.Object#equals(java.lang.Object) */ @Override public boolean equals(Object other) { if (other == null) { return false; } if (!(other instanceof WhichRule)) { return false; } WhichRule otherRule = (WhichRule) other; return attributeIndizes.equals(otherRule.attributeIndizes) && rangeIndizes.equals(otherRule.rangeIndizes) && ranges.equals(otherRule.ranges); } /* * (non-Javadoc) * * @see java.lang.Object#hashCode() */ @Override public int hashCode() { return 117 + attributeIndizes.hashCode() + rangeIndizes.hashCode() + ranges.hashCode(); } /* * (non-Javadoc) * * @see java.lang.Object#toString() */ @Override public String toString() { return "indizes: " + attributeIndizes + "\tranges: " + ranges + "\t score: " + score; } } /** *

* Internal helper class that handles the WHICH stack during training. Please not that this is * not really a stack, we just stick to the name given in the publication. *

* * @author Steffen Herbold */ private class WhichStack { /** * rules on the WhichStack */ List rules; /** * Currently sum of rule scores. */ double scoreSum; /** * Best rule score. */ double bestScore; /** * checks if a rule was added after the last sorting */ boolean pushAfterSort; /** * Internally used random number generator for creating new rules. */ Random rand = new Random(); /** *

* Creates a new WhichStack. *

* */ public WhichStack() { rules = new LinkedList<>(); scoreSum = 0.0; bestScore = 0.0; pushAfterSort = false; } /** *

* Adds a rule to the WhichStack *

* * @param rule * that is added. */ public void push(WhichRule rule) { rules.add(rule); scoreSum += rule.getScore(); if (rule.getScore() > bestScore) { bestScore = rule.getScore(); } pushAfterSort = true; } /** *

* Generates a new rule as a random combination of two other rules. The two rules are drawn * according to their scoring. *

* * @param numRules * @param traindata */ public void generateRules(int numRules, Instances traindata) { List newRules = new LinkedList<>(); for (int i = 0; i < numRules; i++) { WhichRule newRule; do { WhichRule rule1 = drawRule(); WhichRule rule2; do { rule2 = drawRule(); } while (rule2.equals(rule1)); newRule = new WhichRule(rule1, rule2); } while (newRules.contains(newRule)); newRules.add(newRule); } for (WhichRule newRule : newRules) { newRule.scoreRule(traindata); push(newRule); } } /** *

* Randomly draws a rule weighted by the score. *

* * @return drawn rule */ public WhichRule drawRule() { double randVal = rand.nextDouble() * scoreSum; double curSum = 0.0; for (WhichRule rule : rules) { curSum += rule.getScore(); if (curSum >= randVal) { return rule; } } Console.traceln(Level.SEVERE, "could not draw rule; bug in WhichStack.drawRule()"); return null; } /** *

* Returns the best rule. *

* * @return best rule */ public WhichRule bestRule() { if (rules.isEmpty()) { return null; } if (pushAfterSort) { Collections.sort(rules); } return rules.get(0); } } }