Package net.imglib2.interpolation.randomaccess

Class NearestNeighborInterpolator<T>

java.lang.Object
net.imglib2.AbstractEuclideanSpace
net.imglib2.position.transform.AbstractPositionableTransform<RandomAccess<T>>
net.imglib2.position.transform.Round<RandomAccess<T>>
net.imglib2.interpolation.randomaccess.NearestNeighborInterpolator<T>
Type Parameters:
T -
All Implemented Interfaces:
EuclideanSpace, Positionable, RealLocalizable, RealPositionable, RealRandomAccess<T>, Sampler<T>
public class NearestNeighborInterpolator<T> extends Round<RandomAccess<T>> implements RealRandomAccess<T>
RealRandomAccess to a RandomAccess by nearest neighbor interpolation.

In ImgLib2, the coordinate of a sample corresponds to the 'center' point of the sample, i.e. the location at which the sample was acquired. This scheme is intuitive in both rasters and irregularly samples data but can trigger confusion when displaying images on a screen with a pixel raster which, in this scheme, spans the range [-0.5,width-0.5]. In the screen-friendly alternative scheme, where sample coordinates reference the top left corner of the pixel rectangle representing a sample the range covered by an image is [0,width], however, coordinate transfer functions other than translation and homogeneous scaling generate different results than in the center-scheme. Rendering an image using FloorInterpolator means using the top-left-scheme, rendering it using NearestNeighborInterpolator, NLinearInterpolator, or LanczosInterpolator means using the center-scheme.

Author:
Tobias Pietzsch, Stephan Preibisch, Stephan Saalfeld

  • Constructor Details

    • NearestNeighborInterpolator

      protected NearestNeighborInterpolator(NearestNeighborInterpolator<T> nearestNeighborInterpolator)

    • NearestNeighborInterpolator

      protected NearestNeighborInterpolator(RandomAccessible<T> randomAccessible)

  • Method Details

    • get

      public T get()
      Description copied from interface: Sampler
      Access the actual T instance providing access to a pixel, sub-pixel or integral region value the Sampler points at.
      Specified by:
      get in interface Sampler<T>

    • copy

      public NearestNeighborInterpolator<T> copy()
      Specified by:
      copy in interface Sampler<T>
      Returns:
      - A new Sampler in the same state accessing the same values. It does NOT copy T, just the state of the Sampler. Otherwise use T.copy() if available. Sampler.copy().get() == Sampler.get(), i.e. both hold the same value, not necessarily the same instance (this is the case for an ArrayCursor for example)

    • copyRealRandomAccess

      public NearestNeighborInterpolator<T> copyRealRandomAccess()
      Specified by:
      copyRealRandomAccess in interface RealRandomAccess<T>