net.imglib2

Interface RealRandomAccessible<T>

All Superinterfaces:

EuclideanSpace, Typed<T>

All Known Subinterfaces:

RealRandomAccessibleRealInterval<T>, RealRandomAccessibleView<T>

All Known Implementing Classes:

AbstractConvertedRealRandomAccessible, BiConvertedRealRandomAccessible, BiConvertedRealRandomAccessibleRealInterval, ConvertedRealRandomAccessible, ConvertedRealRandomAccessibleRealInterval, ExtendedRealRandomAccessibleRealInterval, FunctionRealRandomAccessible, Interpolant, RealPositionRealRandomAccessible

public interface RealRandomAccessible<T>
extends EuclideanSpace, Typed<T>

f:Rⁿ→T

A function over real space that can create a random access Sampler.

If your algorithm takes a RealRandomAccessible, this usually means that you expect that the domain is infinite. (In contrast to this, RealRandomAccessibleRealIntervals have a finite domain.)

Similarly to a RandomAccessible, a RealRandomAccessible might be defined only partially within the space.

Author:

Stephan Saalfeld

Method Summary

Modifier and Type	Method and Description
default T	getAt(double... position) Convenience method to query a RealRandomAccessible for the value at a position.
default T	getAt(float... position) Convenience method to query a RealRandomAccessible for the value at a position.
default T	getAt(RealLocalizable position) Convenience method to query a RealRandomAccessible for the value at a position.
RealRandomAccess<T>	realRandomAccess() Create a random access sampler for real coordinates.
RealRandomAccess<T>	realRandomAccess(RealInterval interval)
default RealRandomAccessibleView<T>	realView() Provides a gateway for creating light-weight views into this RealRandomAccessible.

Methods inherited from interface net.imglib2.EuclideanSpace

numDimensions

Methods inherited from interface net.imglib2.Typed

getType

Method Detail

realRandomAccess

RealRandomAccess<T> realRandomAccess()

Create a random access sampler for real coordinates.

Returns:

random access sampler

realRandomAccess

RealRandomAccess<T> realRandomAccess(RealInterval interval)

getAt

default T getAt(float... position)

Convenience method to query a RealRandomAccessible for the value at a position.

WARNING: This method is VERY SLOW, and memory inefficient when used in tight loops, or called many times!!! Use realRandomAccess() when efficiency is important.

This method is a short cut for realRandomAccess().setPositionAndGet( position );

Parameters:

position, - length must be ≥ EuclideanSpace.numDimensions()

Returns:

value of the the RandomAccessible at position.

getAt

default T getAt(double... position)

Convenience method to query a RealRandomAccessible for the value at a position.

WARNING: This method is VERY SLOW, and memory inefficient when used in tight loops, or called many times!!! Use realRandomAccess() when efficiency is important.

This method is a short cut for realRandomAccess().setPositionAndGet( position );

Parameters:

position, - length must be ≥ EuclideanSpace.numDimensions()

Returns:

value of the the RandomAccessible at position.

getAt

default T getAt(RealLocalizable position)

Convenience method to query a RealRandomAccessible for the value at a position.

WARNING: This method is VERY SLOW, and memory inefficient when used in tight loops, or called many times!!! Use realRandomAccess() when efficiency is important.

This method is a short cut for realRandomAccess().setPositionAndGet( position );

Parameters:

position, - EuclideanSpace.numDimensions() must be ≥ EuclideanSpace.numDimensions()

Returns:

value of the the RandomAccessible at position.

realView

default RealRandomAccessibleView<T> realView()

Provides a gateway for creating light-weight views into this RealRandomAccessible.

A view is itself a RealRandomAccessible or RandomAccessible whose accessors transform coordinates and/or values on-the-fly without copying the underlying data. Consecutive transformations are concatenated and simplified to provide optimally efficient accessors.

Note, that accessors provided by a view are read/write. Changing pixels in a view changes the underlying image data. (Value converters are an exception.)

Returns:

gateway for creating light-weight views into this RealRandomAccessible.