imref3d

Establecer referencias en imágenes 3D con las coordenadas mundiales

Descripción

Un objeto imref3d almacena la relación entre las coordenadas intrínsecas ancladas a las columnas, filas y planos de una imagen 3D y la ubicación espacial de las ubicaciones de la mismas columnas, filas y planos en un sistema de coordenadas mundial.

La imagen se muestrea frecuentemente en las coordenadas mundiales planares x, y y z del sistema de coordenadas de forma que los valores intrínsecos de x, y y z se alinean con los valores mundiales de x, y y z, respectivamente. La resolución en cada dimensión puede ser diferente.

Creación

Puede crear un objeto imref3d de los modos siguientes.

• affineOutputView: almacenar la extensión espacial de una imagen que está deformada por una transformación geométrica afín 3D.

• La función imref3d aquí descrita

Sintaxis

R = imref3d

R = imref3d(imageSize)

R = imref3d(imageSize,pixExtentWorldX,pixExtentWorldY,pixExtentWorldZ)

R = imref3d(imageSize,xWorldLim,yWorldLim,zWorldLim)

Descripción

R = imref3d crea un objeto imref3d con valores predeterminados de propiedad.

R = imref3d(imageSize) especifica el tamaño de la imagen en cada dimensión espacial.

R = imref3d(imageSize,pixExtentWorldX,pixExtentWorldY,pixExtentWorldZ) también especifica la extensión espacial de un único píxel en las dimensiones x, y y z en el sistema de coordenadas mundial.

R = imref3d(imageSize,xWorldLim,yWorldLim,zWorldLim) también especifica los límites de la imagen en las dimensiones x, y y z en el sistema de coordenadas mundial.

Argumentos de entrada

imageSize — Número de elementos en cada dimensión espacial

Vector fila positivo de 2 elementos

Número de elementos en cada dimensión espacial, especificado como un vector fila positivo de 2 elementos. imageSize tiene la misma forma que la devuelta por la función size.

Este argumento establece la propiedad ImageSize.

Tipos de datos: double

pixExtentWorldX — Tamaño de un solo píxel en la dimensión x

número positivo

Tamaño de un solo píxel en la dimensión x medido en el sistema de coordenadas mundial, especificado como número positivo.

Este argumento establece la propiedad PixelExtentInWorldX.

Tipos de datos: double

pixExtentWorldY — Tamaño de un solo píxel en la dimensión y

número positivo

Tamaño de un solo píxel en la dimensión y medido en el sistema de coordenadas mundial, especificado como número positivo.

Este argumento establece la propiedad PixelExtentInWorldY.

Tipos de datos: double

pixExtentWorldZ — Tamaño de un solo píxel en la dimensión z

número positivo

Tamaño de un solo píxel en la dimensión z medido en el sistema de coordenadas mundial, especificado como número positivo.

Este argumento establece la propiedad PixelExtentInWorldZ.

Tipos de datos: double

xWorldLim — Límites de la imagen en la dimensión mundial x

Vector fila numérico de 2 elementos

Límites de la imagen en la dimensión mundial x, especificados como vector fila numérico de 2 elementos [xMin xMax].

Este argumento establece la propiedad XWorldLimits.

Tipos de datos: double

yWorldLim — Límites de la imagen en la dimensión mundial y

Vector fila numérico de 2 elementos

Límites de la imagen en la dimensión mundial y, especificados como vector fila numérico de 2 elementos [yMin yMax].

Este argumento establece la propiedad YWorldLimits.

Tipos de datos: double

zWorldLim — Límites de la imagen en la dimensión mundial z

Vector fila numérico de 2 elementos

Límites de la imagen en la dimensión mundial z, especificados como vector fila numérico de 2 elementos [zMin zMax].

Este argumento establece la propiedad ZWorldLimits.

Tipos de datos: double

Argumentos de salida

R — Referencias espaciales 3D

objeto imref3d

Referencias espaciales 3D, devueltas como un objeto imref3d.

Propiedades

ImageExtentInWorldX — Extensión de la imagen en la dimensión x en el sistema de coordenadas mundial

Escalar numérico

Extensión de la imagen en la dimensión x en el sistema de coordenadas mundial, especificada como escalar numérico. El objeto imref3d calcula este valor como PixelExtentInX * ImageSize(2).

Tipos de datos: double

ImageExtentInWorldY — Extensión de la imagen en la dimensión y en el sistema de coordenadas mundial

Escalar numérico

Extensión de la imagen en la dimensión y en el sistema de coordenadas mundial, especificada como escalar numérico. El objeto imref3d calcula este valor como PixelExtentInY * ImageSize(1).

Tipos de datos: double

ImageExtentInWorldZ — Extensión de la imagen en la dimensión z en el sistema de coordenadas mundial

Escalar numérico

Extensión de la imagen en la dimensión z en el sistema de coordenadas mundial, especificada como escalar numérico. El objeto imref3d calcula este valor como PixelExtentInZ * ImageSize(3).

Tipos de datos: double

ImageSize — Número de elementos en cada dimensión espacial

Vector fila positivo de 3 elementos

Número de elementos en cada dimensión espacial, especificado como vector fila positivo de 3 elementos. ImageSize tiene la misma forma que la devuelta por la función size.

Tipos de datos: double

PixelExtentInWorldX — Tamaño de un solo píxel en la dimensión x medido en el sistema de coordenadas mundial

número positivo

Tamaño de un solo píxel en la dimensión x medido en el sistema de coordenadas mundial, especificado como número positivo.

Tipos de datos: double

PixelExtentInWorldY — Tamaño de un solo píxel en la dimensión y medido en el sistema de coordenadas mundial

número positivo

Tamaño de un solo píxel en la dimensión y medido en el sistema de coordenadas mundial, especificado como número positivo.

Tipos de datos: double

PixelExtentInWorldZ — Tamaño de un solo píxel en la dimensión z medido en el sistema de coordenadas mundial

número positivo

Tamaño de un solo píxel en la dimensión z medido en el sistema de coordenadas mundial, especificado como número positivo.

Tipos de datos: double

XWorldLimits — Límites de la imagen en la dimensión mundial x

Vector fila numérico de 2 elementos

Límites de la imagen en la dimensión mundial x, especificados como vector fila de 2 elementos, [xMin xMax].

Tipos de datos: double

YWorldLimits — Límites de la imagen en la dimensión mundial y

Vector fila numérico de 2 elementos

Límites de la imagen en la dimensión mundial y, especificados como vector fila de 2 elementos, [yMin yMax].

Tipos de datos: double

ZWorldLimits — Límites de la imagen en la dimensión mundial z

Vector fila numérico de 2 elementos

Límites de la imagen en la dimensión mundial z, especificados como vector fila de 2 elementos, [zMin zMax].

Tipos de datos: double

XIntrinsicLimits — Límites de la imagen en unidades intrínsecas en la dimensión x

Vector fila de 2 elementos

Límites de la imagen en unidades intrínsecas en la dimensión x, especificados como vector fila de 2 elementos [xMin xMax]. Para una imagen de m por n por p, es igual a [0.5, n+0.5].

Tipos de datos: double

YIntrinsicLimits — Límites de la imagen en unidades intrínsecas en la dimensión y

Vector fila de 2 elementos

Límites de la imagen en unidades intrínsecas en la dimensión y, especificados como vector fila de 2 elementos [yMin yMax]. Para una imagen de m por n por p, es igual a [0.5, m+0.5].

Tipos de datos: double

ZIntrinsicLimits — Límites de la imagen en unidades intrínsecas en la dimensión z

Vector fila de 2 elementos

Límites de la imagen en unidades intrínsecas en la dimensión z, especificados como vector fila de 2 elementos [zMin zMax]. Para una imagen de m por n por p, es igual a [0.5, p+0.5].

Tipos de datos: double

Funciones del objeto

contains	Determine if image contains points in world coordinate system
intrinsicToWorld	Convert from intrinsic to world coordinates
sizesMatch	Determine if object and image are size-compatible
worldToIntrinsic	Convert from world to intrinsic coordinates
worldToSubscript	Convert world coordinates to row and column subscripts

Ejemplos

Crear un objeto imref3d conociendo el tamaño de la imagen y la resolución de cada dimensión

Lea una imagen.

m = analyze75info("brainMRI.hdr");
A = analyze75read(m);

Cree un objeto imref3d asociado con la imagen, especificando el tamaño de los píxeles. El campo PixelDimensions de los metadatos del archivo especifica la resolución de cada dimensión en milímetros/píxel.

RA = imref3d(size(A),m.PixelDimensions(2),m.PixelDimensions(1),m.PixelDimensions(3));

RA = 

  imref3d with properties:

           XWorldLimits: [0.5000 128.5000]
           YWorldLimits: [0.5000 128.5000]
           ZWorldLimits: [0.5000 27.5000]
              ImageSize: [128 128 27]
    PixelExtentInWorldX: 1
    PixelExtentInWorldY: 1
    PixelExtentInWorldZ: 1
    ImageExtentInWorldX: 128
    ImageExtentInWorldY: 128
    ImageExtentInWorldZ: 27
       XIntrinsicLimits: [0.5000 128.5000]
       YIntrinsicLimits: [0.5000 128.5000]
       ZIntrinsicLimits: [0.5000 27.5000]

Examine la extensión de la imagen en cada dimensión en milímetros.

RA.ImageExtentInWorldX
RA.ImageExtentInWorldY
RA.ImageExtentInWorldZ

ans =

   128

ans =

   128

ans =

    27

Más acerca de

Sistema de coordenadas intrínsecas

Los valores de las coordenadas intrínsecas (x,y,z) del punto central de cualquier píxel son idénticos a los valores de los subíndices de la columna, la fila y el plano para ese píxel. Por ejemplo, el punto central del píxel de la fila 5, columna 3, plano 4 tiene las coordenadas intrínsecas x = 3.0, y = 5.0, z = 4.0.

El orden de especificación de las coordenadas (3.0,5.0,4.0) se invierte en las coordenadas intrínsecas relacionadas con los subíndices de los píxeles (5,3,4). Las coordenadas intrínsecas se definen en un plano continuo, mientras que las ubicaciones de los subíndices son ubicaciones discretas con valores enteros.

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• imref3d es compatible con la generación de código C y C++ (requiere MATLAB^® Coder™). Para obtener más información, consulte Code Generation for Image Processing.

• Cuando se genera código, puede especificar únicamente objetos determinados, ya que los arreglos de objetos no son compatibles.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con los entornos basados en hilos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Historial de versiones

Introducido en R2013a

Consulte también

imref2d | imregister

Temas

• Sistemas de coordenadas de imagen
• Define World Coordinate System of Image