maketform

Crear una estructura de transformación espacial en N dimensiones (TFORM)

No se recomienda usar la función maketform para transformaciones geométricas 2D y 3D. Para obtener más información, consulte Historial de versiones.

Sintaxis

T = maketform("affine",A)

T = maketform("projective",P)

T = maketform("custom",ndims_in,ndims_out,forward_fcn,inverse_fcn,tdata)

T = maketform("box",tsize,outCornerStart,outCornerEnd)

T = maketform("box",inCorners,outCorners)

T = maketform("composite",T1,T2,...,TL)

T = maketform("composite",[T1,T2,...,TL])

Descripción

Crear transformaciones afines y proyectivas en N dimensiones a partir de matrices

T = maketform("affine",A) crea una estructura de transformación espacial T para una transformación afín en N dimensiones especificada como una matriz A. La estructura de transformación T tiene tanto transformaciones directas como inversas.

Una estructura de transformación espacial (denominada estructura TFORM) se puede utilizar con las funciones tformarray, tformfwd y tforminv.

T = maketform("projective",P) crea una estructura TFORM para una transformación proyectiva en N dimensiones especificada como una matriz P. T tiene tanto transformaciones directas como inversas.

Crear una transformación a partir de funciones directas o inversas

T = maketform("custom",ndims_in,ndims_out,forward_fcn,inverse_fcn,tdata) crea una estructura TFORM personalizada T basada en identificadores de función y parámetros provistos por el usuario. ndims_in y ndims_out son los números de las dimensiones de entrada y salida. forward_fcn y inverse_fcn son identificadores de función para funciones directas e inversas. El argumento tdata puede ser cualquier arreglo de MATLAB^® y suele utilizarse para almacenar parámetros de la transformación personalizada. Se puede acceder a forward_fcn e inverse_fcn a través del campo tdata de T.

Crear una transformación para referencias espaciales

T = maketform("box",tsize,outCornerStart,outCornerEnd) crea una estructura TFORM afín en N dimensiones T que asigna un cuadro de entrada definido por las coordenadas de una esquina, ones(1,N), y tamaño tsize, a un cuadro de salida definido por las esquinas opuestas outCornerStart y outCornerEnd. La estructura TFORM "box" suele utilizarse para registrar los subíndices de fila y columna de una imagen o arreglo para algún sistema de coordenadas mundial.

T = maketform("box",inCorners,outCorners) crea una estructura TFORM afín en N dimensiones T. La transformación asigna un cuadro de entrada definido por las esquinas opuestas inCorners(1,:) e inCorners(2,:) a un cuadro de salida definido por las esquinas opuestas outCorners(1,:) y outCorners(2,:).

Crear una transformación compuesta

T = maketform("composite",T1,T2,...,TL) crea una estructura TFORM T que es un compuesto de transformaciones T1, T2, ..., TL, especificadas como estructuras TFORM separadas por comas. Las funciones directa e inversa de T son composiciones funcionales de las funciones hacia directas e inversas de las transformaciones de los componentes T1, T2, ..., TL.

T = maketform("composite",[T1,T2,...,TL]) crea una estructura TFORM T que es un compuesto de transformaciones T1, T2, ..., TL, especificadas en un vector. Las funciones directa e inversa de T son composiciones funcionales de las funciones directas e inversas de las transformaciones de los componentes T1, T2, ..., TL.

Ejemplos

Calcular los límites de una imagen de salida transformada

Lea una imagen en el área de trabajo y muéstrela.

I = imread('cameraman.tif');
figure
imshow(I)

Cree una estructura de transformación espacial que estire una imagen.

T = maketform('affine',[.5 0 0; .5 2 0; 0 0 1]);

Calcule los límites de la imagen de salida, dado el tamaño de la imagen de entrada y la transformación espacial. Las dimensiones de la imagen de entrada son 256 por 256. Los límites de la imagen de salida reflejan la transformación: 256 por 512.

outb = findbounds(T,[0 0;256 256])

outb = 2×2

     0     0
   256   512

Aplique la transformación y muestre la imagen.

transformedI = imtransform(I,T);
figure
imshow(transformedI)

Argumentos de entrada

A — Transformación afín

Matriz de (N+1) por (N+1) | Matriz de (N+1) por N

Transformación afín, especificada como una matriz de (N+1) por (N+1) o una matriz de (N+1) por N, donde N es la dimensionalidad de la transformación afín. La matriz debe ser no singular y real.

Si A es (N+1) por (N+1), la última columna de A debe ser [zeros(N,1);1]. De lo contrario, A aumenta automáticamente, de modo que la última columna es [zeros(N,1);1]. La matriz A define una transformación directa de modo que tformfwd(U,T), donde U es un vector de 1 por N, devuelve un vector de 1 por N X, de modo que X = U * A(1:N,1:N) + A(N+1,1:N).

Tipos de datos: double

P — Transformación proyectiva

Matriz de (N+1) por (N+1)

Transformación proyectiva, especificada como una matriz de (N+1) por (N+1), donde N es la dimensionalidad de la transformación proyectiva. La matriz debe ser no singular y real. P(N+1,N+1) no puede ser 0.

La matriz P define una transformación directa de modo que tformfwd(U,T), donde U es un vector de 1 por N, devuelve un vector de 1 por N X, de modo que X = W(1:N)/W(N+1), donde W = [U 1] * P.

Tipos de datos: double

ndims_in — Número de dimensiones de entrada

entero positivo

Número de dimensiones de entrada, especificado como un entero positivo.

Tipos de datos: double

ndims_out — Número de dimensiones de salida

entero positivo

Número de dimensiones de salida, especificado como un entero positivo.

Tipos de datos: double

forward_fcn — Función directa

identificador de función | []

Función directa, especificada como un identificador de función que admite la sintaxis X = forward_fcn(U,T). U es una matriz de numpts por ndims_in cuyas filas son puntos en el espacio de entrada de la transformación y X es una matriz de numpts por ndims_out cuyas filas son puntos en el espacio de salida de la transformación.

forward_fcn puede estar vacío.

Tipos de datos: function_handle

inverse_fcn — Función inversa

identificador de función

Función inversa, especificada como un identificador de función que admite la sintaxis U = inverse_fcn(X,T). U es una matriz de numpts por ndims_in cuyas filas son puntos en el espacio de entrada de la transformación y X es una matriz de numpts por ndims_out cuyas filas son puntos en el espacio de salida de la transformación.

inverse_fcn puede estar vacío. Sin embargo, para usar la estructura TFORM T con la función tformarray, debe definir inverse_fcn.

Tipos de datos: function_handle

tdata — Parámetros de una transformación personalizada

Arreglo

Parámetros de una transformación personalizada, especificados como arreglo.

Tipos de datos: double

tsize — Tamaño del cuadro de entrada

Vector de N elementos de enteros positivos

Tamaño del cuadro de entrada, especificado como vector de N elementos de enteros positivos.

Tipos de datos: double

outCornerStart — Coordenadas de la esquina inicial en el espacio de salida

Vector de N elementos

Coordenadas de la esquina inicial en el espacio de salida, especificadas como vector de N elementos. outCornerStart(k) y outCornerEnd(k) deben ser diferentes a menos que tsize(k) sea 1, en cuyo caso se asume que el factor escalar afín a lo largo de la dimensión k-ésima es 1.0.

Tipos de datos: double

outCornerEnd — Coordenadas de la esquina opuesta en el espacio de salida

Vector de N elementos

Coordenadas de la esquina opuesta en el espacio de salida, especificadas como vector de N elementos. outCornerStart(k) y outCornerEnd(k) deben ser diferentes a menos que tsize(k) sea 1, en cuyo caso se asume que el factor escalar afín en la dimensión k-ésima es 1.0.

Tipos de datos: double

inCorners — Coordenadas de la esquina en el espacio de entrada

Matriz numérica de N por 2

Coordenadas de la esquina en el espacio de entrada, especificadas como una matriz numérica de n por 2. La primera columna representa las coordenadas de una esquina y la segunda columna representa las coordenadas de la esquina opuesta. inCorners(1,k) y inCorners(2,k) deben ser diferentes a menos que outCorners(1,k) youtCorners(2,k) sean iguales.

Tipos de datos: double

outCorners — Coordenadas de la esquina en el espacio de salida

Matriz numérica de N por 2

Coordenadas de la esquina en el espacio de salida, especificadas como una matriz numérica de n por 2. La primera columna representa las coordenadas de una esquina y la segunda columna representa las coordenadas de la esquina opuesta. outCorners(1,k) y outCorners(2,k) deben ser diferentes a menos que inCorners(1,k) yinCorners(2,k) sean iguales.

Tipos de datos: double

T1,T2,...,TL — Transformaciones de componentes

Estructuras TFORM

Transformaciones de componentes, especificadas como estructuras TFORM.

Las entradas T1, T2, ..., TL están ordenadas justo como lo estarían si se utilizara la notación estándar para la composición de funciones: T = T1 ⚬ T2 ⚬ ... ⚬ TL. La composición es asociativa, pero no conmutativa. Esto significa que para aplicar T a la entrada U, debe aplicar TL en primer lugar y T1 en último lugar. Por lo tanto, si L = 3, por ejemplo, tformfwd(U,T) es igual que tformfwd(tformfwd(tformfwd(U,T3),T2),T1). Los componentes T1 a TL deben ser compatibles en términos de los números de dimensiones de entrada y salida.

T tiene una función de transformación directa definida solo si todas las transformaciones de componentes tienen funciones de transformación directa definidas. T tiene una función de transformación inversa definida solo si todas las transformaciones de componentes tienen funciones de transformación inversas definidas.

Tipos de datos: function_handle

Argumentos de salida

T — Transformación espacial multidimensional

Estructura TFORM

Transformación espacial multidimensional, devuelta como estructura TFORM.

Capacidades ampliadas

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 antes de R2006a

R2021b: Compatibilidad con entornos basados en hilos

Ahora maketform es compatible con los entornos basados en hilos.

R2018b: No se recomienda usar maketform para transformaciones geométricas 2D y 3D

No se recomienda usar la función maketform para transformaciones geométricas 2D y 3D. En su lugar, cree una transformación geométrica 2D o 3D de estas formas:

• Defina una transformación afín o proyectiva 2D a partir de una matriz de 3 por 3 utilizando el objeto affinetform2d, rigidtform2d, simtform2d, transltform2d o projtform2d.

• Defina una transformación afín 3D a partir de una matriz de 4 por 4 utilizando el objeto affinetform3d, rigidtform3d, simtform3d o transltform3d.

• Defina una transformación afín, proyectiva, polinómica u otra no lineal 2D a partir de pares de puntos de control utilizando la función fitgeotform2d.

• Defina una transformación geométrica 2D o 3D a partir de funciones de asignación por puntos utilizando el objeto geometricTransform2d o geometricTransform3d.

Para más información sobre objetos de transformación geométrica 2D y 3D, consulte Visión general del proceso de transformación geométrica 2D y 3D.

Esta tabla muestra algunas sintaxis de maketform con el código de reemplazo recomendado.

Uso no recomendado	Reemplazo recomendado
Crear una transformación afín 2D a partir de una matriz de 3 por 3 A. A = [0.5 0 0; 0.5 2 0; 0 0 1]; T = maketform("affine",A);	Crear un objeto affinetform2d. A = [0.5 0 0; 0.5 2 0; 0 0 1]; T = affinetform2d(A);
Crear una transformación afín 2D que asigne cada fila de U a la fila correspondiente de X. Los argumentos U y X definen las esquinas de triángulos como una matriz de 3 por 2. U = [21.6 64.2; 71.1 70.3; 28.7 48.3]; X = [10.7 30.6; 40.5 50.6; 20.6 10.7]; T = maketform("affine",U,X);	Crear un objeto affinetform2d usando la función fitgeotform2d. U = [21.6 64.2; 71.1 70.3; 28.7 48.3]; X = [10.7 30.6; 40.5 50.6; 20.6 10.7]; T = fitgeotform2d(U,X,"affine");
Crear una transformación proyectiva 2D que asigne cada fila de U a la fila correspondiente de X. Los argumentos U y X definen las esquinas de cuadrángulos como una matriz de 4 por 2. U = [121 94; 319 79; 128 292; 352 281]; X = [165 113; 354 130; 143 285; 354 312]; T = maketform("projective",U,X);	Crear un objeto projtform2d usando la función fitgeotform2d. U = [121 94; 319 79; 128 292; 352 281]; X = [165 113; 354 130; 143 285; 354 312]; T = fitgeotform2d(U,X,"projective");

Consulte también

tformfwd | tforminv | fliptform | tformarray

Temas

• N-Dimensional Spatial Transformations