imref2d

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

Descripción

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

La imagen se muestrea frecuentemente en el sistema de coordenadas mundial planar x e y de forma que los valores intrínsecos de x se alinean con los valores mundiales de x, y los valores intrínsecos de y se alinean con los valores mundiales de y. La resolución en cada dimensión puede ser diferente.

Creación

Puede crear un objeto imref2d de los modos siguientes.

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

• La función imref2d aquí descrita.

Sintaxis

R = imref2d

R = imref2d(imageSize)

R = imref2d(imageSize,pixExtentWorldX,pixExtentWorldY)

R = imref2d(imageSize,xWorldLim,yWorldLim)

Descripción

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

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

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

R = imref2d(imageSize,xWorldLim,yWorldLim) también especifica los límites de la imagen en las dimensiones x e y 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

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

Argumentos de salida

R — Referencias espaciales 2D

objeto imref2d

Referencias espaciales 2D, devueltas como un objeto imref2d.

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, especificado como escalar numérico. El objeto imref2d establece 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, especificado como escalar numérico. El objeto imref2d establece este valor como PixelExtentInY * ImageSize(1).

Tipos de datos: double

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.

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

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 numérico 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 numérico de 2 elementos [yMin yMax].

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 m por n (o una imagen m por n por p), XIntrinsicLimits 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 m por n (o una imagen m por n por p), YIntrinsicLimits es igual a [0.5, m+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 de referencia espacial 2D conociendo el tamaño de la imagen y los límites mundiales

Lea una imagen 2D en escala de grises en el área de trabajo.

A = imread('pout.tif');

Cree un objeto imref2d, especificando el tamaño y los límites mundiales de la imagen asociada al objeto.

xWorldLimits = [2 5];
yWorldLimits = [3 6];
RA = imref2d(size(A),xWorldLimits,yWorldLimits)

RA = 
  imref2d with properties:

           XWorldLimits: [2 5]
           YWorldLimits: [3 6]
              ImageSize: [291 240]
    PixelExtentInWorldX: 0.0125
    PixelExtentInWorldY: 0.0103
    ImageExtentInWorldX: 3
    ImageExtentInWorldY: 3
       XIntrinsicLimits: [0.5000 240.5000]
       YIntrinsicLimits: [0.5000 291.5000]

Muestre la imagen, especificando el objeto de referencia espacial. Las coordenadas de los ejes reflejan las coordenadas mundiales.

figure
imshow(A,RA);

Crear un objeto de referencia espacial 2D conociendo el tamaño de la imagen y la resolución

Lea una imagen 2D en escala de grises en el área de trabajo.

m = dicominfo('knee1.dcm');
A = dicomread(m);

Cree un objeto imref2d, especificando el tamaño y la resolución de los píxeles. El archivo DICOM contiene un campo de metadatos PixelSpacing que especifica la resolución de la imagen en cada dimensión en milímetros por píxel.

RA = imref2d(size(A),m.PixelSpacing(2),m.PixelSpacing(1))

RA = 
  imref2d with properties:

           XWorldLimits: [0.1562 160.1562]
           YWorldLimits: [0.1562 160.1562]
              ImageSize: [512 512]
    PixelExtentInWorldX: 0.3125
    PixelExtentInWorldY: 0.3125
    ImageExtentInWorldX: 160
    ImageExtentInWorldY: 160
       XIntrinsicLimits: [0.5000 512.5000]
       YIntrinsicLimits: [0.5000 512.5000]

Muestre la imagen, especificando el objeto de referencia espacial. Las coordenadas de los ejes reflejan las coordenadas mundiales.

figure
imshow(A,RA,'DisplayRange',[0 512])

Compare la anchura de la imagen en las coordenadas mundiales y en las coordenadas intrínsecas. Esta anchura de imagen en las coordinadas intrínsecas, con unidades de píxeles, es:

RA.ImageSize(1)

ans = 
512

Esta anchura de imagen en las coordinadas mundiales, con unidades de milímetros, es:

RA.ImageExtentInWorldX

ans = 
160

Más acerca de

Sistema de coordenadas intrínsecas

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

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

Sugerencias

• Puede crear un objeto imref2d para una imagen RGB. Si crea el objeto especificando la propiedad ImageSize como un vector de tres elementos (como el devuelto por la función size), únicamente los dos primeros elementos se utilizan para establecer ImageSize.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• imref2d 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

imref3d | imwarp | imshow

Temas

• Desplazar el intervalo de coordenadas X e Y de la imagen mostrada
• Specify Fill Values in Geometric Transformation Output
• Sistemas de coordenadas de imagen
• Define World Coordinate System of Image