at.tuwien.ifs.somtoolbox.visualization
Class ActivityHistogram

java.lang.Object
  extended by at.tuwien.ifs.somtoolbox.visualization.AbstractBackgroundImageVisualizer
      extended by at.tuwien.ifs.somtoolbox.visualization.AbstractMatrixVisualizer
          extended by at.tuwien.ifs.somtoolbox.visualization.AbstractItemVisualizer
              extended by at.tuwien.ifs.somtoolbox.visualization.ActivityHistogram
All Implemented Interfaces:
BackgroundImageVisualizer, MatrixVisualizer, java.lang.Comparable<BackgroundImageVisualizer>

 class ActivityHistogram
extends AbstractItemVisualizer

This is the implementation of an Activity Histogram.
FIXME: there are a lot of common parts with ComponentPlanesVisualizer ==> make a superclass for both of them.

Version:
$Id: ActivityHistogram.java 4163 2011-02-11 17:08:02Z mayer $
Author:
Roman Gerger, Florian Mistelbauer, Rudolf Mayer

Nested Class Summary
private  class ActivityHistogram.ActivityHistrogramControlPanel
          Implements the control UI for this visualisation.
 
Nested classes/interfaces inherited from class at.tuwien.ifs.somtoolbox.visualization.AbstractItemVisualizer
AbstractItemVisualizer.AbstractSelectedItemVisualizerControlPanel
 
Nested classes/interfaces inherited from class at.tuwien.ifs.somtoolbox.visualization.AbstractBackgroundImageVisualizer
AbstractBackgroundImageVisualizer.ContourInterpolationMode, AbstractBackgroundImageVisualizer.ContourMode, AbstractBackgroundImageVisualizer.VisualizationControlPanel
 
Field Summary
private  java.lang.String dataPoint
           
private  InputData inputData
           
 
Fields inherited from class at.tuwien.ifs.somtoolbox.visualization.AbstractItemVisualizer
currentElement
 
Fields inherited from class at.tuwien.ifs.somtoolbox.visualization.AbstractMatrixVisualizer
maximumMatrixValue, minimumMatrixValue, palette
 
Fields inherited from class at.tuwien.ifs.somtoolbox.visualization.AbstractBackgroundImageVisualizer
cache, CACHE_KEY_SEPARATOR, contourInterpolationMode, contourMode, controlPanel, currentZDimSlice, inputObjects, log, map, MAX_CACHE_SIZE_MB, neededInputObjects, NUM_VISUALIZATIONS, numberOfContours, opacity, preferredScaleFactor, VISUALIZATION_DESCRIPTIONS, VISUALIZATION_NAMES, VISUALIZATION_SHORT_NAMES, visualizationUpdateListener, zSize
 
Fields inherited from interface at.tuwien.ifs.somtoolbox.visualization.BackgroundImageVisualizer
CACHE_KEY_SECTION_SEPARATOR, DEFAULT_BACKGROUND_VISUALIZATION_SCALE
 
Constructor Summary
ActivityHistogram()
           
 
Method Summary
 java.awt.image.BufferedImage createVisualization(int index, GrowingSOM gsom, int width, int height)
          Draws the activity histogram.
protected  java.lang.String getVisualisationSpecificCacheKey(int currentVariant)
           
 java.util.HashMap<java.lang.String,java.awt.image.BufferedImage> getVisualizationFlavours(int index, GrowingSOM gsom, int width, int height)
          Default implementation which returns a map of size 1 with the standard, unparameterised visualisation of the given variant.
 java.util.HashMap<java.lang.String,java.awt.image.BufferedImage> getVisualizationFlavours(int index, GrowingSOM gsom, int width, int height, int maxFlavours)
          Default implementation equal to AbstractBackgroundImageVisualizer.getVisualizationFlavours(int, GrowingSOM, int, int).
 java.util.HashMap<java.lang.String,java.awt.image.BufferedImage> getVisualizationFlavours(int index, GrowingSOM gsom, int width, int height, java.util.Map<java.lang.String,java.lang.String> flavourParameters)
          Default implementation equal to AbstractBackgroundImageVisualizer.getVisualizationFlavours(int, GrowingSOM, int, int).
 void setInputObjects(SharedSOMVisualisationData inputObjects)
          Implementing sub-classes shall override this method if they need to set some specific input object related information.
 
Methods inherited from class at.tuwien.ifs.somtoolbox.visualization.AbstractMatrixVisualizer
computeHitHistogram, computeSpline, constrainWithinPalette, createImage, drawContour, getCurrentPalette, getMaximumMatrixValue, getMinimumMatrixValue, getPalette, getPreferredPaletteName, getVisualization, invalidateCache, isInterpolate, reversePalette, setDefaultInterpolate, setInterpolate, setPalette
 
Methods inherited from class at.tuwien.ifs.somtoolbox.visualization.AbstractBackgroundImageVisualizer
buildCacheKey, checkNeededObjectsAvailable, checkVariantIndex, clearVisualisationCache, compareTo, createVisualization, drawBackground, escapeFileName, getCache, getCacheKey, getControlPanel, getDefaultVisualisationFileName, getDefaultVisualisationFileName, getHTMLVisualisationControl, getNumberOfVisualizations, getPreferredScaleFactor, getVariantException, getVisualizationDescription, getVisualizationDescriptions, getVisualizationName, getVisualizationNames, getVisualizationShortName, getVisualizationShortNames, invalidateCache, logImageCache, needsAdditionalFiles, setMap, setSOMData, setVisualizationUpdateListener
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

dataPoint

private java.lang.String dataPoint

inputData

private InputData inputData
Constructor Detail

ActivityHistogram

public ActivityHistogram()
Method Detail

getVisualisationSpecificCacheKey

protected java.lang.String getVisualisationSpecificCacheKey(int currentVariant)
Overrides:
getVisualisationSpecificCacheKey in class AbstractMatrixVisualizer

createVisualization

public java.awt.image.BufferedImage createVisualization(int index,
                                                        GrowingSOM gsom,
                                                        int width,
                                                        int height)
                                                 throws SOMToolboxException
Draws the activity histogram. Given one input point it calculates the Euclidian distance to each weight vector.

Specified by:
createVisualization in class AbstractBackgroundImageVisualizer
Parameters:
index - the index of the variant to use
gsom - the GrowingSOM to take build the visualisation for
width - the desired width of the image, in pixels
height - the desired height of the image, in pixels.
Returns:
an image for this visualisation.
Throws:
SOMToolboxException - If the InputData is not provided

getVisualizationFlavours

public java.util.HashMap<java.lang.String,java.awt.image.BufferedImage> getVisualizationFlavours(int index,
                                                                                                 GrowingSOM gsom,
                                                                                                 int width,
                                                                                                 int height)
                                                                                          throws SOMToolboxException
Description copied from class: AbstractBackgroundImageVisualizer
Default implementation which returns a map of size 1 with the standard, unparameterised visualisation of the given variant. Subclasses that want to return more flavours should override this method.

Specified by:
getVisualizationFlavours in interface BackgroundImageVisualizer
Overrides:
getVisualizationFlavours in class AbstractBackgroundImageVisualizer
Throws:
SOMToolboxException

getVisualizationFlavours

public java.util.HashMap<java.lang.String,java.awt.image.BufferedImage> getVisualizationFlavours(int index,
                                                                                                 GrowingSOM gsom,
                                                                                                 int width,
                                                                                                 int height,
                                                                                                 int maxFlavours)
                                                                                          throws SOMToolboxException
Description copied from class: AbstractBackgroundImageVisualizer
Default implementation equal to AbstractBackgroundImageVisualizer.getVisualizationFlavours(int, GrowingSOM, int, int).

Specified by:
getVisualizationFlavours in interface BackgroundImageVisualizer
Overrides:
getVisualizationFlavours in class AbstractBackgroundImageVisualizer
Throws:
SOMToolboxException

getVisualizationFlavours

public java.util.HashMap<java.lang.String,java.awt.image.BufferedImage> getVisualizationFlavours(int index,
                                                                                                 GrowingSOM gsom,
                                                                                                 int width,
                                                                                                 int height,
                                                                                                 java.util.Map<java.lang.String,java.lang.String> flavourParameters)
                                                                                          throws SOMToolboxException
Description copied from class: AbstractBackgroundImageVisualizer
Default implementation equal to AbstractBackgroundImageVisualizer.getVisualizationFlavours(int, GrowingSOM, int, int).

Specified by:
getVisualizationFlavours in interface BackgroundImageVisualizer
Overrides:
getVisualizationFlavours in class AbstractBackgroundImageVisualizer
Throws:
SOMToolboxException

setInputObjects

public void setInputObjects(SharedSOMVisualisationData inputObjects)
Description copied from class: AbstractBackgroundImageVisualizer
Implementing sub-classes shall override this method if they need to set some specific input object related information.

Specified by:
setInputObjects in interface BackgroundImageVisualizer
Overrides:
setInputObjects in class AbstractBackgroundImageVisualizer
Parameters:
inputObjects - the new input objects
See Also:
SOMVisualisationData