All Downloads are FREE. Search and download functionalities are using the official Maven repository.

weka.knowledgeflow.steps.StripChart Maven / Gradle / Ivy

Go to download

The Waikato Environment for Knowledge Analysis (WEKA), a machine learning workbench. This version represents the developer version, the "bleeding edge" of development, you could say. New functionality gets added to this version.

There is a newer version: 3.9.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 3 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, see .
 */

/*
 *    StripChart.java
 *    Copyright (C) 2015 University of Waikato, Hamilton, New Zealand
 *
 */

package weka.knowledgeflow.steps;

import weka.core.Instance;
import weka.core.WekaException;
import weka.gui.knowledgeflow.KFGUIConsts;
import weka.knowledgeflow.Data;
import weka.knowledgeflow.StepManager;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;

/**
 * A step that can display a viewer showing a right-to-left scrolling chart
 * for streaming data
 *
 * @author Mark Hall (mhall{[at]}pentaho{[dot]}com)
 * @version $Revision: $
 */
@KFStep(name = "StripChart", category = "Visualization",
  toolTipText = "Plot streaming data", iconPath = KFGUIConsts.BASE_ICON_PATH
    + "StripChart.gif")
public class StripChart extends BaseStep {

  private static final long serialVersionUID = -2569383350174947630L;

  /** Parties interested in knowing about updates */
  protected List m_plotListeners =
    new ArrayList();

  /** Frequency for plotting x values */
  protected int m_xValFreq = 500;

  /**
   * Plot every m_refreshFrequency'th point
   */
  private int m_refreshFrequency = 5;

  private int m_userRefreshWidth = 1;

  /** True if we've been reset */
  protected boolean m_reset;

  /**
   * Holds the number of attribute values (10 max) to plot if processing an
   * incoming instance stream
   */
  protected int m_instanceWidth;

  /**
   * GUI Tip text
   *
   * @return the tip text for this option
   */
  public String xLabelFreqTipText() {
    return "Show x axis labels this often";
  }

  /**
   * Get the x label frequency
   *
   * @return the x label frequency
   */
  public int getXLabelFreq() {
    return m_xValFreq;
  }

  /**
   * Set the x label frequency
   *
   * @param freq the x label frequency
   */
  public void setXLabelFreq(int freq) {
    m_xValFreq = freq;
  }

  /**
   * GUI Tip text
   *
   * @return a String value
   */
  public String refreshFreqTipText() {
    return "Plot every x'th data point";
  }

  /**
   * Set how often (in x axis points) to refresh the display
   *
   * @param freq an int value
   */
  public void setRefreshFreq(int freq) {
    m_refreshFrequency = freq;
  }

  /**
   * Get the refresh frequency
   *
   * @return an int value
   */
  public int getRefreshFreq() {
    return m_refreshFrequency;
  }

  /**
   * GUI Tip text
   *
   * @return a String value
   */
  public String refreshWidthTipText() {
    return "The number of pixels to shift the plot by every time a point"
      + " is plotted.";
  }

  /**
   * Set how many pixels to shift the plot by every time a point is plotted
   *
   * @param width the number of pixels to shift the plot by
   */
  public void setRefreshWidth(int width) {
    if (width > 0) {
      m_userRefreshWidth = width;
    }
  }

  /**
   * Get how many pixels to shift the plot by every time a point is plotted
   *
   * @return the number of pixels to shift the plot by
   */
  public int getRefreshWidth() {
    return m_userRefreshWidth;
  }

  @Override
  public void stepInit() throws WekaException {
    m_reset = true;
  }

  /**
   * Process an incoming data payload (if the step accepts incoming connections)
   *
   * @param data the data to process
   * @throws WekaException if a problem occurs
   */
  @SuppressWarnings("unchecked")
  @Override
  public synchronized void processIncoming(Data data) throws WekaException {
    if (isStopRequested()) {
      return;
    }

    if (getStepManager().isStreamFinished(data)) {
      // done
      // notify downstream steps of end of stream
      Data d = new Data(data.getConnectionName());
      getStepManager().throughputFinished(d);
      return;
    }

    getStepManager().throughputUpdateStart();
    if (m_plotListeners.size() > 0) {
      if (getStepManager().numIncomingConnectionsOfType(
        StepManager.CON_INSTANCE) > 0) {
        Instance instance =
          (Instance) data.getPayloadElement(StepManager.CON_INSTANCE);
        if (m_reset) {
          m_reset = false;
          List legendEntries = new ArrayList();
          int i;
          for (i = 0; i < instance.dataset().numAttributes() && i < 10; i++) {
            legendEntries.add(instance.dataset().attribute(i).name());
          }
          m_instanceWidth = i;

          for (PlotNotificationListener l : m_plotListeners) {
            l.setLegend(legendEntries, 0.0, 1.0);
          }
        }

        double[] dataPoint = new double[m_instanceWidth];
        for (int i = 0; i < dataPoint.length; i++) {
          if (!instance.isMissing(i)) {
            dataPoint[i] = instance.value(i);
          }
        }
        for (PlotNotificationListener l : m_plotListeners) {
          l.acceptDataPoint(dataPoint);
        }

      } else if (getStepManager().numIncomingConnectionsOfType(
        StepManager.CON_CHART) > 0) {
        if (m_reset) {
          m_reset = false;
          double min =
            data.getPayloadElement(StepManager.CON_AUX_DATA_CHART_MIN, 0.0);
          double max =
            data.getPayloadElement(StepManager.CON_AUX_DATA_CHART_MAX, 1.0);
          List legend =
            (List) data
              .getPayloadElement(StepManager.CON_AUX_DATA_CHART_LEGEND);
          for (PlotNotificationListener l : m_plotListeners) {
            l.setLegend(legend, min, max);
          }
        }
        double[] dataPoint =
          (double[]) data
            .getPayloadElement(StepManager.CON_AUX_DATA_CHART_DATA_POINT);
        for (PlotNotificationListener l : m_plotListeners) {
          l.acceptDataPoint(dataPoint);
        }
      }
    }
    getStepManager().throughputUpdateEnd();
  }

  /**
   * Get a list of incoming connection types that this step can accept. Ideally
   * (and if appropriate), this should take into account the state of the step
   * and any existing incoming connections. E.g. a step might be able to accept
   * one (and only one) incoming batch data connection.
   *
   * @return a list of incoming connections that this step can accept given its
   *         current state
   */
  @Override
  public List getIncomingConnectionTypes() {
    if (getStepManager().numIncomingConnections() == 0) {
      return Arrays.asList(StepManager.CON_INSTANCE, StepManager.CON_CHART);
    }

    return new ArrayList();
  }

  /**
   * Add a plot notification listener
   *
   * @param listener the listener to be notified
   */
  public synchronized void addPlotNotificationListener(
    PlotNotificationListener listener) {
    m_plotListeners.add(listener);
  }

  /**
   * Remove a plot notification listener
   *
   * @param l the listener to remove
   */
  public synchronized void removePlotNotificationListener(
    PlotNotificationListener l) {
    m_plotListeners.remove(l);
  }

  /**
   * Get a list of outgoing connection types that this step can produce. Ideally
   * (and if appropriate), this should take into account the state of the step
   * and the incoming connections. E.g. depending on what incoming connection is
   * present, a step might be able to produce a trainingSet output, a testSet
   * output or neither, but not both.
   *
   * @return a list of outgoing connections that this step can produce
   */
  @Override
  public List getOutgoingConnectionTypes() {
    return new ArrayList();
  }

  /**
   * When running in a graphical execution environment a step can make one or
   * more popup Viewer components available. These might be used to display
   * results, graphics etc. Returning null indicates that the step has no such
   * additional graphical views. The map returned by this method should be keyed
   * by action name (e.g. "View results"), and values should be fully qualified
   * names of the corresponding StepInteractiveView implementation. Furthermore,
   * the contents of this map can (and should) be dependent on whether a
   * particular viewer should be made available - i.e. if execution hasn't
   * occurred yet, or if a particular incoming connection type is not present,
   * then it might not be possible to view certain results.
   *
   * Viewers can implement StepInteractiveView directly (in which case they need
   * to extends JPanel), or extends the AbstractInteractiveViewer class. The
   * later extends JPanel, uses a BorderLayout, provides a "Close" button and a
   * method to add additional buttons.
   *
   * @return a map of viewer component names, or null if this step has no
   *         graphical views
   */
  @Override
  public Map getInteractiveViewers() {
    Map views = new LinkedHashMap();

    views.put("Show chart",
      "weka.gui.knowledgeflow.steps.StripChartInteractiveView");

    return views;
  }

  /**
   * StripChartInteractiveView implements this in order to receive data points.
   * Other potential viewer implementations could as well.
   */
  public interface PlotNotificationListener {

    void setLegend(List legendEntries, double min, double max);

    void acceptDataPoint(double[] dataPoint);
  }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy