omeis.providers.re.codomain

Class CodomainChain

java.lang.Object

omeis.providers.re.codomain.CodomainChain

public class CodomainChain
extends Object

Queues the contexts that define the spatial domain transformations that have to be applied to the image.

A lookup table is built by composing all maps (in the same order as their contexts were enqueued) in a single tranformation and then by applying this map to each value in the codomain interval [intervalStart, intervalEnd] — note that, in order to compose the maps, this interval has to be both the domain and codomain of each transformation. The LUT is re-built everytime the definition of the codomain interval or the state of the queue changes.

Contexts are privately owned (add and update make copies) because we want to exclude the possibility that a context's state can be modified after the lookup table is built.

Since:

OME2.2

Version:

2.2 (Internal version: $Revision$ $Date: 2005/06/20 10:59:54 $)

Author:

Jean-Marie Burel j.burel@dundee.ac.uk,
Andrea Falconi a.falconi@dundee.ac.uk

Constructor Summary

Constructors

Constructor and Description
CodomainChain(int start, int end) Creates a new chain.
CodomainChain(int start, int end, List mapContexts) Creates a new chain.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(CodomainMapContext mapCtx) Adds a map context to the chain.
int	getIntervalEnd() Returns the upper bound of the codomain interval.
int	getIntervalStart() Returns the lower bound of the codomain interval.
void	remove() Removes all CodomainMapContexts except the identity and resets the interval.
void	remove(CodomainMapContext mapCtx) Removes a map context from the chain.
void	setInterval(int start, int end) Sets the codomain interval.
String	toString() Overrides the toString method.
int	transform(int x) Applies the transformation.
void	update(CodomainMapContext mapCtx) Updates a map context in the chain.

Methods inherited from class java.lang.Object

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

Constructor Detail

CodomainChain

public CodomainChain(int start,
             int end)

Creates a new chain. The chain will contain the identity context. So if no transformation is added, the transform method returns the input value. The interval defined by start and end must be a sub-interval of [QuantumStrategy.MIN, QuantumStrategy.MAX].

Parameters:

start - The lower bound of the codomain interval.

end - The upper bound of the codomain interval.

CodomainChain

public CodomainChain(int start,
             int end,
             List mapContexts)

Creates a new chain. The chain will contain the specified contexts — if mapContexts is null or empty, the chain will contain only the identity context. The interval defined by start and end has to be a sub-interval of [QuantumStrategy.MIN, QuantumStrategy.MAX].

Parameters:

start - The lower bound of the codomain interval.

end - The upper bound of the codomain interval.

mapContexts - The sequence of CodomainMapContext objects that define the chain. No two objects of the same class are allowed. The objects in this list are copied.

Throws:

IllegalArgumentException - If one of the contexts is already defined.

Method Detail

setInterval

public void setInterval(int start,
               int end)

Sets the codomain interval. This triggers an update of all map contexts in the chain and a re-build of the lookup table. The interval defined by start and end must be a sub-interval of [QuantumStrategy.MIN, QuantumStrategy.MAX].

Parameters:

start - The lower bound of the codomain interval.

end - The upper bound of the codomain interval.

getIntervalEnd

public int getIntervalEnd()

Returns the upper bound of the codomain interval.

Returns:

See above.

getIntervalStart

public int getIntervalStart()

Returns the lower bound of the codomain interval.

Returns:

See above.

remove

public void remove()

Removes all CodomainMapContexts except the identity and resets the interval.

add

public void add(CodomainMapContext mapCtx)

Adds a map context to the chain. This means that the transformation associated to the passed context will be applied after all the currently queued transformations. An exception will be thrown if the chain already contains an object of the same class as mapCtx. This is because we don't want to compose the same transformation twice. This method adds a copy of mapCtx to the chain. This is because we want to exclude the possibility that the context's state can be modified after the lookup table is built. This method triggers a re-build of the lookup table.

Parameters:

mapCtx - The context to add. Mustn't be null.

Throws:

IllegalArgumentException - If the context is already defined.

update

public void update(CodomainMapContext mapCtx)

Updates a map context in the chain. An exception will be thrown if the chain doesn't contain an object of the same class as mapCtx. This method replaces the old context with a copy of mapCtx. This is because we want to exclude the possibility that the context's state can be modified after the lookup table is built. This method triggers a re-build of the lookup table.

Parameters:

mapCtx - The context to add. Mustn't be null and already contained in the chain.

Throws:

IllegalArgumentException - If the specifed context doesn't exist.

remove

public void remove(CodomainMapContext mapCtx)

Removes a map context from the chain. This method removes the object (if any) in the chain that is an instance of the same class as mapCtx. This means that the transformation associated to the passed context won't be applied. This method triggers a re-build of the lookup table.

Parameters:

mapCtx - The context to remove.

transform

public int transform(int x)

Applies the transformation. This transformation is the result of the composition of all maps defined by the current chain. Composition follows the chain order.

Parameters:

x - The input value. Must be in the current codomain interval.

Returns:

The output value, y.

toString

public String toString()

Overrides the toString method.

Overrides:

toString in class Object

See Also:

Object.toString()