at.tuwien.ifs.somtoolbox.visualization
Interface BackgroundImageVisualizer

All Superinterfaces:
java.lang.Comparable<BackgroundImageVisualizer>
All Known Subinterfaces:
QualityMeasureVisualizer
All Known Implementing Classes:
AbstractBackgroundImageVisualizer, AbstractItemVisualizer, AbstractMatrixVisualizer, ActivityHistogram, AdaptiveCoordinatesVisualizer, CategoryPieChartVisualizer, ClusterConnectionsVisualizer, ComparisonVisualizer, ComponentPlanesVisualizer, EntropyVisualizer, FlowBorderlineVisualizer, FuzzyColourCodingVisualiser, GapVisualiser, HitHistogramVisualizer, IntrinsicDistanceVisualizer, MappingDistortionVisualizer, MetroMapVisualizer, MinimumSpanningTreeVisualizer, NeighbourhoodGraph, PMatrix, QuantizationErrorVisualizer, RegressionVisualiser, RhythmPatternsAttributeVisualizer, SearchResultHistogramVisualizer, SilhouetteVisualizer, SmoothedCountHistograms, SmoothedDataHistograms, ThematicClassMapVisualizer, TopographicErrorVisualizer, TopographicProductVisualizer, TrustwothinessVisualizer, UMatrix

public interface BackgroundImageVisualizer
extends java.lang.Comparable<BackgroundImageVisualizer>

Interface defining a visualisation of a SOM. If you want to provide new visualisers, you have to implement this interface and register your visualisation in Visualizations.getAvailableVisualizations(). If your visualisation requires user input to e.g. control parameters, extend AbstractBackgroundImageVisualizer.VisualizationControlPanel to add your specific control panel inputs.

Version:
$Id: BackgroundImageVisualizer.java 4162 2011-02-11 16:40:02Z mayer $
Author:
Michael Dittenbach, Rudolf Mayer

Field Summary
static java.lang.String CACHE_KEY_SECTION_SEPARATOR
           
static int DEFAULT_BACKGROUND_VISUALIZATION_SCALE
           
 
Method Summary
 AbstractBackgroundImageVisualizer.VisualizationControlPanel getControlPanel()
          Gets the visualisation control panel.
 java.lang.String getDefaultVisualisationFileName(int currentVariant)
          Generates the default file name for the current visualisation
 java.lang.String getHTMLVisualisationControl(java.util.Map params)
          Returns HTML control elements (inputs) to be used by the webserver version of the SOM.
 int getNumberOfVisualizations()
           
 int getPreferredScaleFactor()
          Return the preferred scale factor for interpolation for this visualisation.
 java.awt.image.BufferedImage getVisualization(int variantIndex, GrowingSOM gsom, int width, int height)
          Returns a visualisation image.
 java.lang.String getVisualizationDescription(int variantIndex)
          Gets the descriptions of a specified visualisation variant.
 java.lang.String[] getVisualizationDescriptions()
          Gets the descriptions of all visualisation variants provided by this visualiser.
 java.util.HashMap<java.lang.String,java.awt.image.BufferedImage> getVisualizationFlavours(int index, GrowingSOM gsom, int width, int height)
          Returns all visualisation flavours of the given variant, e.g.
 java.util.HashMap<java.lang.String,java.awt.image.BufferedImage> getVisualizationFlavours(int index, GrowingSOM gsom, int width, int height, int maxFlavours)
          Returns all visualisation flavours of the given variant just as getVisualizationFlavours(int, GrowingSOM, int, int), but limiting the number of flavours to the given maximum number.
 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)
          Returns all visualisation flavours of the given variant just as getVisualizationFlavours(int, GrowingSOM, int, int), but limiting the number of flavours by the given parameters.
 java.lang.String getVisualizationName(int variantIndex)
          Gets the name of a specified visualisation variant.
 java.lang.String[] getVisualizationNames()
          Gets the names of all visualisation variants provided by this visualiser.
 java.lang.String getVisualizationShortName(int variantIndex)
          Gets the short name of a specified visualisation variant.
 java.lang.String[] getVisualizationShortNames()
          Gets the short names of all visualisation variants provided by this visualiser.
 java.lang.String[] needsAdditionalFiles()
          Checks whether this visualisation still needs some input files to generate an image.
 void setInputObjects(SharedSOMVisualisationData inputObjects)
          Sets the input objects needed to create visualisations.
 void setMap(MapPNode map)
          Sets the map this visualiser operates on.
 void setSOMData(SOMInputReader reader)
          Sets the input data needed to create visualisations.
 void setVisualizationUpdateListener(VisualizationUpdateListener listener)
          Sets a new listener for visualisation update events.
 
Methods inherited from interface java.lang.Comparable
compareTo
 

Field Detail

DEFAULT_BACKGROUND_VISUALIZATION_SCALE

static final int DEFAULT_BACKGROUND_VISUALIZATION_SCALE
See Also:
Constant Field Values

CACHE_KEY_SECTION_SEPARATOR

static final java.lang.String CACHE_KEY_SECTION_SEPARATOR
See Also:
Constant Field Values
Method Detail

getVisualization

java.awt.image.BufferedImage getVisualization(int variantIndex,
                                              GrowingSOM gsom,
                                              int width,
                                              int height)
                                              throws SOMToolboxException
Returns a visualisation image.

Parameters:
variantIndex - 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 there was an error creating the visualisation

getNumberOfVisualizations

int getNumberOfVisualizations()
Returns:
Returns the number of visualizations

getVisualizationNames

java.lang.String[] getVisualizationNames()
Gets the names of all visualisation variants provided by this visualiser.

Returns:
a String array containing all names

getVisualizationName

java.lang.String getVisualizationName(int variantIndex)
Gets the name of a specified visualisation variant.

Parameters:
variantIndex - the index of the variant to use
Returns:
the name of the visualisation variant

getVisualizationShortNames

java.lang.String[] getVisualizationShortNames()
Gets the short names of all visualisation variants provided by this visualiser.

Returns:
a String array containing all short names

getVisualizationShortName

java.lang.String getVisualizationShortName(int variantIndex)
Gets the short name of a specified visualisation variant.

Parameters:
variantIndex - the index of the variant to use
Returns:
the short name of the visualisation variant

getVisualizationDescriptions

java.lang.String[] getVisualizationDescriptions()
Gets the descriptions of all visualisation variants provided by this visualiser.

Returns:
a String array containing all descriptions

getVisualizationDescription

java.lang.String getVisualizationDescription(int variantIndex)
Gets the descriptions of a specified visualisation variant.

Parameters:
variantIndex - the index of the variant to use
Returns:
the description of the visualisation variant

getControlPanel

AbstractBackgroundImageVisualizer.VisualizationControlPanel getControlPanel()
Gets the visualisation control panel.

Returns:
the control panel of this visualizer

needsAdditionalFiles

java.lang.String[] needsAdditionalFiles()
Checks whether this visualisation still needs some input files to generate an image.

Returns:
an array containing the names of the input objects needed

setVisualizationUpdateListener

void setVisualizationUpdateListener(VisualizationUpdateListener listener)
Sets a new listener for visualisation update events.

Parameters:
listener - the new listener to be registered

setInputObjects

void setInputObjects(SharedSOMVisualisationData inputObjects)
Sets the input objects needed to create visualisations.

Parameters:
inputObjects - the new input objects
See Also:
SOMVisualisationData

setSOMData

void setSOMData(SOMInputReader reader)
Sets the input data needed to create visualisations.

Parameters:
reader - the som input reader

setMap

void setMap(MapPNode map)
Sets the map this visualiser operates on.

Parameters:
map - the map

getHTMLVisualisationControl

java.lang.String getHTMLVisualisationControl(java.util.Map params)
Returns HTML control elements (inputs) to be used by the webserver version of the SOM. Only the inputs are required, the surrounding form will be provided.

Parameters:
params - the parameters as passed by the web request - used to select the values in the inputs.
Returns:
HTML code containing the inputs

getPreferredScaleFactor

int getPreferredScaleFactor()
Return the preferred scale factor for interpolation for this visualisation. This is useful for visualisations that do not want to be interpolated, or at least less interpolated, e.g. when they draw lines rather than having a matrix-height profile.


getVisualizationFlavours

java.util.HashMap<java.lang.String,java.awt.image.BufferedImage> getVisualizationFlavours(int index,
                                                                                          GrowingSOM gsom,
                                                                                          int width,
                                                                                          int height)
                                                                                          throws SOMToolboxException
Returns all visualisation flavours of the given variant, e.g. applying possible parameters to the visualisation, etc.
The keys in the map shall be specific suffixes that describe how the flavours were constructed, e.g. they might contain parameter names and values.

Throws:
SOMToolboxException

getVisualizationFlavours

java.util.HashMap<java.lang.String,java.awt.image.BufferedImage> getVisualizationFlavours(int index,
                                                                                          GrowingSOM gsom,
                                                                                          int width,
                                                                                          int height,
                                                                                          int maxFlavours)
                                                                                          throws SOMToolboxException
Returns all visualisation flavours of the given variant just as getVisualizationFlavours(int, GrowingSOM, int, int), but limiting the number of flavours to the given maximum number.

Throws:
SOMToolboxException

getVisualizationFlavours

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
Returns all visualisation flavours of the given variant just as getVisualizationFlavours(int, GrowingSOM, int, int), but limiting the number of flavours by the given parameters.

Throws:
SOMToolboxException

getDefaultVisualisationFileName

java.lang.String getDefaultVisualisationFileName(int currentVariant)
Generates the default file name for the current visualisation