de.unihalle.informatik.MiToBo.color.visualization
Class ArrayToColorMapImage

java.lang.Object
  extended by de.unihalle.informatik.Alida.operator.ALDOperator
      extended by de.unihalle.informatik.MiToBo.core.operator.MTBOperator
          extended by de.unihalle.informatik.MiToBo.color.visualization.ArrayToColorMapImage
All Implemented Interfaces:
de.unihalle.informatik.Alida.datatypes.ALDConfigurationValidator, de.unihalle.informatik.Alida.operator.events.ALDOperatorExecutionProgressEventListener, EventListener

@ALDAOperator(genericExecutionMode=ALL,
              level=APPLICATION)
public class ArrayToColorMapImage
extends MTBOperator

This operator visualizes a 2D array using a specified color mapping.

Negative and positive values are shown highly saturated in the corresponding color for the negative and positive value ranges, respectively. Values close to zero appear almost white, i.e. least saturated.
The default color map is a red-blue color map, i.e. negative values are shown in blue, positive ones in red.

Author:
moeller

Nested Class Summary
static class ArrayToColorMapImage.RangeColor
          Possible colors to colorize value ranges.
 
Nested classes/interfaces inherited from class de.unihalle.informatik.Alida.operator.ALDOperator
de.unihalle.informatik.Alida.operator.ALDOperator.HidingMode
 
Field Summary
protected  ArrayToColorMapImage.RangeColor colorNegative
          Color for negative values.
protected  ArrayToColorMapImage.RangeColor colorPositive
          Color for positive values.
protected  double[][] inputArray
          Input array to visualize.
protected  MTBImageRGB targetImage
          Optional target image for result.
 
Fields inherited from class de.unihalle.informatik.Alida.operator.ALDOperator
completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider
 
Constructor Summary
ArrayToColorMapImage()
          Default constructor.
ArrayToColorMapImage(double[][] array)
          Constructor.
 
Method Summary
protected static double convertRangeColorToHue(ArrayToColorMapImage.RangeColor c)
          Converts given color to hue value.
 MTBImageRGB getResultImage()
          Returns the result color image.
protected  void operate()
          This method does the actual work.
 void setNegativeColor(ArrayToColorMapImage.RangeColor c)
          Color for negative values.
 void setPositiveColor(ArrayToColorMapImage.RangeColor c)
          Color for positive values.
 void setTargetImage(MTBImageRGB tImage)
          Set target image.
 
Methods inherited from class de.unihalle.informatik.MiToBo.core.operator.MTBOperator
readResolve
 
Methods inherited from class de.unihalle.informatik.Alida.operator.ALDOperator
addOperatorExecutionProgressEventListener, fieldContained, fireOperatorExecutionProgressEvent, getALDPortHashAccessKey, getConstructionMode, getHidingMode, getInInoutNames, getInInoutNames, getInNames, getInOutNames, getMissingRequiredInputs, getName, getNumParameters, getOutInoutNames, getOutNames, getParameter, getParameterDescriptor, getParameterNames, getSupplementalNames, getVerbose, getVersion, handleOperatorExecutionProgressEvent, isConfigured, print, print, print, printInterface, printInterface, readHistory, reinitializeParameterDescriptors, removeOperatorExecutionProgressEventListener, runOp, runOp, runOp, setConstructionMode, setHidingMode, setName, setParameter, setVerbose, toStringVerbose, unconfiguredItems, validate, validateCustom, validateGeneric, writeHistory, writeHistory, writeHistory
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

inputArray

@Parameter(label="Input Array",
           required=true,
           dataIOOrder=1,
           direction=IN,
           description="Input array.")
protected double[][] inputArray
Input array to visualize.

If the array has h rows and w columns, the result image gets a size of w x h.


colorPositive

@Parameter(label="Positive range color",
           required=false,
           dataIOOrder=1,
           direction=IN,
           description="Positive color.")
protected ArrayToColorMapImage.RangeColor colorPositive
Color for positive values.


colorNegative

@Parameter(label="Negative range color",
           required=false,
           dataIOOrder=2,
           direction=IN,
           description="Negative color.")
protected ArrayToColorMapImage.RangeColor colorNegative
Color for negative values.


targetImage

@Parameter(label="Target image",
           required=false,
           dataIOOrder=3,
           direction=IN,
           description="Target image.")
protected transient MTBImageRGB targetImage
Optional target image for result.

If left unset a new image is generated.

Constructor Detail

ArrayToColorMapImage

public ArrayToColorMapImage()
                     throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException
Default constructor.

Throws:
de.unihalle.informatik.Alida.exceptions.ALDOperatorException

ArrayToColorMapImage

public ArrayToColorMapImage(double[][] array)
                     throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException
Constructor.

Parameters:
array - Input array.
Throws:
de.unihalle.informatik.Alida.exceptions.ALDOperatorException
Method Detail

getResultImage

public MTBImageRGB getResultImage()
Returns the result color image.


setTargetImage

public void setTargetImage(MTBImageRGB tImage)
Set target image.

Parameters:
tImage - Image where to plot the result.

setPositiveColor

public void setPositiveColor(ArrayToColorMapImage.RangeColor c)
Color for positive values.

Parameters:
c - Color to use.

setNegativeColor

public void setNegativeColor(ArrayToColorMapImage.RangeColor c)
Color for negative values.

Parameters:
c - Color to use.

operate

protected void operate()
                throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException,
                       de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException
This method does the actual work.

Specified by:
operate in class de.unihalle.informatik.Alida.operator.ALDOperator
Throws:
de.unihalle.informatik.Alida.exceptions.ALDOperatorException
de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

convertRangeColorToHue

protected static double convertRangeColorToHue(ArrayToColorMapImage.RangeColor c)
Converts given color to hue value.

Parameters:
c - Color identifier.
Returns:
Hue value.


Copyright © 2010–2015 Martin Luther University Halle-Wittenberg. All rights reserved.