weka.core.pmml.TransformationDictionary Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of weka-stable Show documentation
The Waikato Environment for Knowledge Analysis (WEKA), a machine learning workbench. This is the stable version. Apart from bugfixes, this version does not receive any other updates.
There is a newer version: 3.8.6
Show newest version
/*
 *    This program is free software; you can redistribute it and/or modify
 *    it under the terms of the GNU General Public License as published by
 *    the Free Software Foundation; either version 2 of the License, or
 *    (at your option) any later version.
 *
 *    This program is distributed in the hope that it will be useful,
 *    but WITHOUT ANY WARRANTY; without even the implied warranty of
 *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *    GNU General Public License for more details.
 *
 *    You should have received a copy of the GNU General Public License
 *    along with this program; if not, write to the Free Software
 *    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

/*
 *    TransformationDictionary.java
 *    Copyright (C) 2008 University of Waikato, Hamilton, New Zealand
 *
 */

package weka.core.pmml;

import java.io.Serializable;
import java.util.ArrayList;

import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

import weka.core.Attribute;
import weka.core.Instances;
import weka.core.SerializedObject;

/**
 * Class encapsulating the TransformationDictionary element. Contains
 * a list of DefineFunctions and DerivedFields (if any).
 * 
 * @author Mark Hall (mhall{[at]}pentaho{[dot]}com
 * @version $Revision 1.0 $
 */
class TransformationDictionary implements Serializable {
  
  /** The defined functions (if any) */
  protected ArrayList m_defineFunctions = new ArrayList();
  
  /** The derived fields (if any) */
  protected ArrayList m_derivedFields = 
    new ArrayList();
  
  /**
   * Construct a new TransformationDictionary
   * 
   * @param dictionary the Element containing the dictionary
   * @param dataDictionary the data dictionary as an Instances object
   * @throws Exception if there is a problem constructing the transformation
   * dictionary
   */
  protected TransformationDictionary(Element dictionary, 
                                  Instances dataDictionary) throws Exception {
    
    // set up incoming field definitions
    ArrayList incomingFieldDefs = new ArrayList();
    for (int i = 0; i < dataDictionary.numAttributes(); i++) {
      incomingFieldDefs.add(dataDictionary.attribute(i));
    }
    
    // get any derived fields and DefineFunctions
    NodeList derivedL = dictionary.getChildNodes();
    for (int i = 0; i < derivedL.getLength(); i++) {
      Node child = derivedL.item(i);
      if (child.getNodeType() == Node.ELEMENT_NODE) {
        String tagName = ((Element)child).getTagName();
        if (tagName.equals("DerivedField")) {
          DerivedFieldMetaInfo df = new DerivedFieldMetaInfo((Element)child, incomingFieldDefs, null);
          m_derivedFields.add(df);
        } else if (tagName.equals("DefineFunction")) {
          DefineFunction defF = new DefineFunction((Element)child, null);
          m_defineFunctions.add(defF);
        }
      }
    }
  }
  
  /**
   * Set the field definitions for the derived fields. Usually called once the
   * structure of the mining schema has been determined. Calling this method
   * with an array list of field definitions in the order of attributes in the
   * mining schema will allow the expressions used in the derived fields to
   * access the correct attribute values from the incoming instances. This is
   * necessary because construction of the TransformationDictionary uses the
   * data dictionary to reference fields (the order of fields in the data dictionary
   * is not guaranteed to be the same as the order in the mining schema).
   * 
   * @param fieldDefs the definition of the incoming fields as an array list of attributes
   * @throws Exception if a problem occurs
   */
  protected void setFieldDefsForDerivedFields(ArrayList fieldDefs) throws Exception {
    for (int i = 0; i < m_derivedFields.size(); i++) {
      m_derivedFields.get(i).setFieldDefs(fieldDefs);
    }
  }
  
  /**
   * Set the field definitions for the derived fields. Usually called once the
   * structure of the mining schema has been determined. Calling this method
   * with an array list of field definitions in the order of attributes in the
   * mining schema will allow the expressions used in the derived fields to
   * access the correct attribute values from the incoming instances. This is
   * necessary because construction of the TransformationDictionary uses the
   * data dictionary to reference fields (the order of fields in the data dictionary
   * is not guaranteed to be the same as the order in the mining schema).
   * 
   * @param fieldDefs the definition of the incoming fields as an Instances object
   * @throws Exception if a problem occurs
   */
  protected void setFieldDefsForDerivedFields(Instances fieldDefs) throws Exception {
    ArrayList tempDefs = new ArrayList();
    for (int i = 0; i < fieldDefs.numAttributes(); i++) {
      tempDefs.add(fieldDefs.attribute(i));
    }
    setFieldDefsForDerivedFields(tempDefs);
  }
  
  protected ArrayList getDerivedFields() {
    return new ArrayList(m_derivedFields);
  }
  
  /**
   * Get a named DefineFunction. Returns a deep copy of the
   * function.
   * 
   * @param functionName the name of the function to get
   * @return the named function or null if it cannot be found
   * @throws Exception if there is a problem deep copying the function
   */
  protected DefineFunction getFunction(String functionName) throws Exception {

    DefineFunction copy = null;
    DefineFunction match = null;
    for (DefineFunction f : m_defineFunctions) {
      if (f.getName().equals(functionName)) {
        match = f;
        //System.err.println("Found a match!!!");
        break;
      }
    }
    
    if (match != null) {
      SerializedObject so = new SerializedObject(match, false);
      copy = (DefineFunction)so.getObject();
      //System.err.println(copy);
    }
    
    return copy;
  }
  
  public String toString() {
    StringBuffer buff = new StringBuffer();
    
    buff.append("Transformation dictionary:\n");
    
    if (m_derivedFields.size() > 0) {
      buff.append("derived fields:\n");
      for (DerivedFieldMetaInfo d : m_derivedFields) {
        buff.append("" + d.getFieldAsAttribute() + "\n");
      }
    }
    
    if (m_defineFunctions.size() > 0) {
      buff.append("\nfunctions:\n");
      for (DefineFunction f : m_defineFunctions) {
        buff.append(f.toString("  ") + "\n");
      }
    }
    
    buff.append("\n");
    
    return buff.toString();
  }
}