de.unihalle.informatik.MiToBo.enhance

Class GammaCorrection2D

java.lang.Object

de.unihalle.informatik.Alida.operator.ALDOperator

de.unihalle.informatik.MiToBo.core.operator.MTBOperator

de.unihalle.informatik.MiToBo.enhance.GammaCorrection2D

All Implemented Interfaces:

de.unihalle.informatik.Alida.datatypes.ALDConfigurationValidator, de.unihalle.informatik.Alida.operator.events.ALDOperatorExecutionProgressEventListener, EventListener

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

Gamma correction on a 8- oder 16-bit image for one- or multi-channel images. The gamma value can be set or automatically be computed.

Author:

Danny Misiak

Nested Class Summary

Nested classes/interfaces inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

de.unihalle.informatik.Alida.operator.ALDOperator.HidingMode, de.unihalle.informatik.Alida.operator.ALDOperator.HistoryConstructionMode

Field Summary

Fields

Modifier and Type	Field and Description
private Boolean	auto
private Integer	channel
private Double	gamma
private MTBImage	inputImage
private MTBImage	resultImage

Fields inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider

Constructor Summary

Constructors

Constructor and Description
GammaCorrection2D() Standard constructor.
GammaCorrection2D(MTBImage inimg, Double _gamma, Integer _channel) Constructor to create a new gamma correction 2D operator.
GammaCorrection2D(MTBImage inimg, Integer _channel) No gamma value is set.

Method Summary

Modifier and Type	Method and Description
private MTBImage	correctGamma(MTBImage inputImg, double gamma, int channel) Perform gamma correction to the specified channel of the input image, using the given gamma value.
private MTBImage	correctGammaAuto(MTBImage inputImg, int channel) Perform gamma correction to the specified channel of the input image.
Integer	getChannel() Get the image channel.
Double	getGamma() Get the gamma value.
boolean	getGammaToAuto() Get if gamma should be calculated automatically or not.
MTBImage	getInputImage() Get the input image.
MTBImage	getResultImage() Get the gamma corrected image.
protected void	operate() This method does the actual work.
void	setChannel(Integer _channel) Set the image channel.
void	setGamma(Double _gamma) Set the gamma value.
void	setGammaToAuto(boolean a) Set if gamma should be calculated automatically or not.
void	setInputImage(MTBImage inImg) Set the input image.
private void	useAutoGamma() Callback routine to change parameters.
void	validateCustom()

Methods inherited from class de.unihalle.informatik.MiToBo.core.operator.MTBOperator

readResolve

Methods inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

addOperatorExecutionProgressEventListener, addParameter, addParameter, addParameterUnconditioned, fieldContained, fireOperatorExecutionProgressEvent, getALDPortHashAccessKey, getConstructionMode, getDocumentation, getHidingMode, getInactiveParameterNames, getInInoutNames, getInInoutNames, getInNames, getInOutNames, getMissingRequiredInputs, getName, getNumParameters, getOutInoutNames, getOutNames, getParameter, getParameterDescriptor, getParameterDescriptorUnconditioned, getParameterNames, getParameterUnconditioned, getSupplementalNames, getVerbose, getVersion, handleOperatorExecutionProgressEvent, hasInOutParameters, hasParameter, isAnnotatedParameter, isConfigured, print, print, print, printInterface, printInterface, readHistory, reinitializeParameterDescriptors, removeOperatorExecutionProgressEventListener, removeParameter, runOp, runOp, runOp, setConstructionMode, setConstructionMode, setConstructionMode, setHidingMode, setName, setParameter, setParameterUnconditioned, setVerbose, toStringVerbose, unconfiguredItems, validate, validateGeneric, writeHistory, writeHistory, writeHistory

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

inputImage

@Parameter(label="Input Image",
           required=true,
           direction=IN,
           description="Input image",
           mode=STANDARD,
           dataIOOrder=0)
private transient MTBImage inputImage

gamma

@Parameter(label="Gamma Value",
           required=false,
           direction=INOUT,
           description="Gamma value.",
           mode=STANDARD,
           dataIOOrder=1)
private Double gamma

channel

@Parameter(label="Image Channel",
           required=true,
           direction=IN,
           description="Channel of image.",
           mode=STANDARD,
           dataIOOrder=2)
private Integer channel

auto

@Parameter(label="Auto Gamma",
           required=false,
           direction=IN,
           description="Automatic gamma value computation.",
           mode=STANDARD,
           callback="useAutoGamma",
           paramModificationMode=MODIFIES_INTERFACE,
           dataIOOrder=3)
private Boolean auto

resultImage

@Parameter(label="Result Image",
           direction=OUT,
           description="Gamma corrected image.")
private transient MTBImage resultImage

Constructor Detail

GammaCorrection2D

public GammaCorrection2D()
                  throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Standard constructor.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

GammaCorrection2D

public GammaCorrection2D(MTBImage inimg,
                         Double _gamma,
                         Integer _channel)
                  throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Constructor to create a new gamma correction 2D operator.

Parameters:

inimg - 2D input image for gamma correction

_gamma - gamma value to apply gamma correction

_channel - image channel to apply gamma correction, starts with 1

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

GammaCorrection2D

public GammaCorrection2D(MTBImage inimg,
                         Integer _channel)
                  throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

No gamma value is set. The gamma value is computed automatically.

gamma = log(r/maxInt)/ log(mean/maxInt)

maxInt is the maximum pixel intensity for all pixels in the image, for example 65535 for a 16-Bit pixel image

mean is the mean value over all image pixels

r is the half value of the pixel intensity range (32768 for 16-bit image)

Parameters:

inimg - 2D input image for gamma correction

_channel - image channel to apply gamma correction

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Method Detail

validateCustom

public void validateCustom()
                    throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Overrides:

validateCustom in class de.unihalle.informatik.Alida.operator.ALDOperator

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

useAutoGamma

private void useAutoGamma()

Callback routine to change parameters.

getInputImage

public MTBImage getInputImage()

Get the input image.

setInputImage

public void setInputImage(MTBImage inImg)

Set the input image.

getGamma

public Double getGamma()

Get the gamma value.

setGamma

public void setGamma(Double _gamma)

Set the gamma value.

getChannel

public Integer getChannel()

Get the image channel.

setChannel

public void setChannel(Integer _channel)

Set the image channel.

getResultImage

public MTBImage getResultImage()

Get the gamma corrected image.

setGammaToAuto

public void setGammaToAuto(boolean a)

Set if gamma should be calculated automatically or not.

getGammaToAuto

public boolean getGammaToAuto()

Get if gamma should be calculated automatically or not.

operate

protected void operate()
                throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

This method does the actual work.

Specified by:

operate in class de.unihalle.informatik.Alida.operator.ALDOperator

Throws:

de.unihalle.informatik.Alida.exceptions.ALDProcessingDAGException

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

correctGamma

private MTBImage correctGamma(MTBImage inputImg,
                              double gamma,
                              int channel)

Perform gamma correction to the specified channel of the input image, using the given gamma value.

Returns:

Gamma corrected image.

correctGammaAuto

private MTBImage correctGammaAuto(MTBImage inputImg,
                                  int channel)

Perform gamma correction to the specified channel of the input image. The gamma value is calculated automatically.

Returns:

Gamma corrected image.