: r = imref3d
: r = imref3d (imageSize)
: r = imref3d (imageSize, pixelExtentInWorldX, pixelExtentInWorldY, pixelExtentInWorldZ)
: r = imref3d (imageSize, xWorldLimits, yWorldLimits, zWorldLimits)

Reference 3-D image to world coordinates.

Creates an imref3d object referencing a 3-D m-by-n-by-p image with the size imageSize to world coordinates. The world extent is either given by xWorldLimits, yWorldLimits and xWorldLimits or computed from pixelExtentInWorldX, pixelExtentInWorldY and pixelExtentInWorldZ. imageSize is [2, 2, 2] by default.

Intrinsic coordinates are x = 1.0, y = 1.0, z = 1.0 in the center of the top left pixel in the first plane and x = n, y = m, z = p in the center of the bottom right pixel in the last plane. Spatial resolution in each dimension can be different.

imref3d object has the following properties:

ImageSize - two element integer vector with image height and width in pixels.

XWorldLimits - limits of the image along the x-axis in world units specified as a two element real vector [xMin, xMax].

YWorldLimits - limits of the image along the y-axis in world units specified as a two element real vector [yMin, yMax].

ZWorldLimits - limits of the image along the z-axis in world units specified as a two element real vector [zMin, zMax].

PixelExtentInWorldX - pixel extent along the x-axis in world units specified as a real scalar.

PixelExtentInWorldY - pixel extent along the y-axis in world units specified as a real scalar.

PixelExtentInWorldZ - pixel extent along the z-axis in world units specified as a real scalar.

ImageExtentInWorldX - image extent along the x-axis in world units specified as a real scalar.

ImageExtentInWorldY - image extent along the y-axis in world units specified as a real scalar.

ImageExtentInWorldZ - image extent along the z-axis in world units specified as a real scalar.

XIntrinsicLimits - limits of the image along the x-axis in intrinsic units, equals to [n - 0.5, n + 0.5].

YIntrinsicLimits - limits of the image along the y-axis in intrinsic units, equals to [m - 0.5, m + 0.5].

ZIntrinsicLimits - limits of the image along the z-axis in intrinsic units, equals to [p - 0.5, p + 0.5].

See also: imref2d.

Package: image