La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

affinetform3d

Transformación geométrica afín 3D

Desde R2022b. Recomendado en lugar de affine3d.

Descripción

Un objeto affinetform3d almacena información sobre una transformación geométrica afín 3D y permite las transformaciones directas e inversas.

Creación

Puede crear un objeto affinetform3d de los modos siguientes:

• imregtform: estima una transformación geométrica que asigna una imagen variable a una imagen fija usando la optimización de similitud.

• randomAffine3d: crea una transformación afín 3D aleatoria.

• Funciones de otras toolboxes que devuelven transformaciones geométricas, incluyendo, entre otras, las siguientes:

  • fitgeotform3d (Medical Imaging Toolbox)

• La función affinetform3d aquí descrita.

Sintaxis

tform = affinetform3d

tform = affinetform3d(affineMat)

tform = affinetform3d(tformIn)

Descripción

tform = affinetform3d crea un objeto affinetform3d que realiza una transformación de identidad.

tform = affinetform3d(affineMat) crea un objeto affinetform3d a partir de una matriz de transformación afín 3D especificada, affineMat.

tform = affinetform3d(tformIn) crea un objeto affinetform3d a partir de otro objeto de transformación geométrica, tformIn, que representa una transformación geométrica afín 3D válida.

Argumentos de entrada

affineMat — Transformación afín 3D directa

Matriz identidad de 4 por 4 (predeterminado) | Matriz numérica de 4 por 4 | Matriz numérica de 3 por 4

Transformación afín 3D directa, especificada como matriz numérica de 4 por 4. Al crear el objeto, también puede especificar affineMat como matriz numérica de 3 por 4. En este caso, el objeto concatena el vector fila [0 0 0 1] al final de la matriz, formando una matriz de 4 por 4.

En una transformación afín 3D válida, A tiene la forma siguiente:

$${\rm A}=\left[\begin{array}{cccc}a& b& c& d\\ e& f& g& h\\ i& j& k& l\\ 0& 0& 0& 1\end{array}\right]$$

Este argumento establece la propiedad A.

Tipos de datos: double | single

tformIn — Transformación geométrica afín 3D

objeto affinetform3d | objeto rigidtform3d | objeto simtform3d | objeto transltform3d

Transformación geométrica afín 3D, especificada como objeto affinetform3d, rigidtform3d, simtform3d o transltform3d.

Argumentos de salida

tform — Transformación geométrica afín 3D

objeto affinetform3d

Transformación geométrica afín 3D, devuelta como un objeto affinetform3d.

Propiedades

A — Transformación afín 3D directa

Matriz identidad de 4 por 4 (predeterminado) | Matriz numérica de 4 por 4

Transformación afín 3D directa, especificada como matriz numérica de 4 por 4. El valor predeterminado de A es la matriz identidad.

La matriz A transforma el punto (u, v, w) en el espacio de coordenadas de entrada en el punto (, x, y, z) en el espacio de coordenadas de salida utilizando la convención:

$$\left[\begin{array}{c}x\\ y\\ z\\ 1\end{array}\right]={\rm A}\times \left[\begin{array}{c}u\\ v\\ w\\ 1\end{array}\right]$$

En una transformación afín, A tiene la forma siguiente:

$${\rm A}=\left[\begin{array}{cccc}a& b& c& d\\ e& f& g& h\\ i& j& k& l\\ 0& 0& 0& 1\end{array}\right]$$

Tipos de datos: double | single

Dimensionality — Dimensionalidad de la transformación geométrica

Solo lectura: 3 (predeterminado)

Esta propiedad o parámetro es de solo lectura.

Dimensionalidad de la transformación geométrica tanto para puntos de entrada como de salida, devuelta como el valor 3.

Tipos de datos: double

Funciones del objeto

invert	Invertir la transformación geométrica
outputLimits	Encontrar los límites espaciales de salida dados los límites espaciales de entrada
transformPointsForward	Aplicar transformación geométrica directa
transformPointsInverse	Aplicar la transformación geométrica inversa

Ejemplos

Crear una transformación afín 3D

Defina una matriz de transformación geométrica de 4 por 4. Esta matriz especifica una transformación afín que consiste en traslación y escalado anisotrópico.

[sx,sy,sz] = deal(2,2,2.5);
[tx,ty,tz] = deal(10,20.5,15);
A = [sx 0 0 tx; 0 sy 0 ty; 0 0 sz tz; 0 0 0 1];

Cree un objeto affinetform3d que realice el escalado y la traslación.

tform = affinetform3d(A)

tform = 
  affinetform3d with properties:

    Dimensionality: 3

                 A: [2.0000         0         0   10.0000
                          0    2.0000         0   20.5000
                          0         0    2.5000   15.0000
                          0         0         0    1.0000]

Examine el valor de la propiedad A.

tform.A

ans = 4×4

    2.0000         0         0   10.0000
         0    2.0000         0   20.5000
         0         0    2.5000   15.0000
         0         0         0    1.0000

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• affinetform3d 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 genera código, solo puede especificar objetos singulares. Los arreglos de objetos no son compatibles.

• El código generado no puede devolver un objeto affinetform3d. En su lugar, puede devolver un arreglo numérico, como el valor de la propiedad A.

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 R2022b

R2022b: Recomendado en lugar de affine3d

A partir de la versión R2022b, la mayoría de funciones de Image Processing Toolbox™ crean y realizan transformaciones geométricas utilizando la convención de la premultiplicación. El objeto affinetform3d almacena la información sobre las transformaciones geométricas afines 3D en un formato coherente con la convención de premultiplicación.

No se recomienda el objeto affine3d porque utiliza la convención de posmultiplicación. Aunque no está previsto eliminar el objeto affine3d por el momento, puede simplificar sus flujos de transformación geométrica cambiando al objeto affinetform3d. Para obtener más información, consulte Migrate Geometric Transformations to Premultiply Convention.

Consulte también

Funciones

• rigidtform3d | simtform3d | transltform3d | imwarp

Temas

• Visión general del proceso de transformación geométrica 2D y 3D
• Representación matricial de transformaciones geométricas