transltform3d

Transformación geométrica de traslación 3D

Desde R2022b

Descripción

Un objeto transltform3d almacena información sobre una transformación geométrica de traslación 3D y permite las transformaciones directas e inversas.

Creación

Puede crear un objeto transltform3d 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.

• fitgeotform3d (Medical Imaging Toolbox): calcula una transformación geométrica que asigna pares de puntos de control entre dos imágenes.

• La función transltform3d aquí descrita.

Sintaxis

tform = transltform3d

tform = transltform3d(t)

tform = transltform3d(tx,ty,tz)

tform = transltform3d(translMat)

tform = transltform3d(tformIn)

Descripción

tform = transltform3d crea un objeto transltform3d que realiza la transformación de identidad.

tform = transltform3d(t) crea un objeto transltform3d que realiza una transformación de traslación en función de la cantidad de traslación t especificada.

tform = transltform3d(tx,ty,tz) crea un objeto transltform3d que realiza una transformación de traslación con las cantidades de traslación especificadas tx, ty y tz en las direcciones x, y y z, respectivamente.

tform = transltform3d(translMat) crea un objeto transltform3d a partir de la matriz de transformación de traslación 3D especificada, translMat.

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

Argumentos de entrada

t — Cantidad de traslación

[0 0 0] (predeterminado) | Vector numérico de 3 elementos

Cantidad de traslación, especificada como vector numérico de 3 elementos con forma [t_x t_y t_z]. Estas cantidades de traslación corresponden a los valores t_x, t_y y t_z de la matriz de transformación de traslación definida por A.

Este argumento establece la propiedad Translation.

Tipos de datos: double | single

tx — Cantidad de traslación en la dirección x

0 (predeterminado) | Escalar numérico

Cantidad de traslación en la dirección x, especificada como escalar numérico. Este argumento establece el primer elemento de la propiedad Translation.

ty — Cantidad de traslación en la dirección y

0 (predeterminado) | Escalar numérico

Cantidad de traslación en la dirección y, especificada como escalar numérico. Este argumento establece el segundo elemento de la propiedad Translation.

tz — Cantidad de traslación en la dirección z

0 (predeterminado) | Escalar numérico

Cantidad de traslación en la dirección z, especificada como escalar numérico. Este argumento establece el tercer elemento de la propiedad Translation.

translMat — Transformación de traslación 3D directa

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

Transformación de traslación 3D directa, especificada como matriz numérica de 4 por 4. Al crear el objeto, también puede especificar translMat 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 3D de traslación válida, A tiene la forma:

$${\rm A}=\left[\begin{array}{cccc}1& 0& 0& t_x\\ 0& 1& 0& t_y\\ 0& 0& 1& t_z\\ 0& 0& 0& 1\end{array}\right]$$

t_x, t_y y t_z son la cantidad de traslación en las direcciones x, y y z, respectivamente, y establecen la propiedad Translation.

Este argumento establece la propiedad A.

Tipos de datos: double | single

tformIn — Transformación geométrica 3D de traslación

objeto affinetform3d | objeto rigidtform3d | objeto simtform3d | objeto transltform3d

Transformación geométrica de traslación 3D, especificada como objeto affinetform3d, objeto rigidtform3d, objeto simtform3d u objeto transltform3d.

Argumentos de salida

tform — Transformación geométrica 3D de traslación

objeto transltform3d

Transformación geométrica 3D de traslación, devuelta como un objeto transltform3d.

Propiedades

A — Transformación de traslación 3D directa

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

Transformación de traslació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 de traslación, A tiene la forma:

$${\rm A}=\left[\begin{array}{cccc}1& 0& 0& t_x\\ 0& 1& 0& t_y\\ 0& 0& 1& t_z\\ 0& 0& 0& 1\end{array}\right]$$

donde t_x, t_y y t_z son la cantidad de traslación en las direcciones x, y y z, respectivamente, y corresponden a la propiedad Translation.

Tipos de datos: double | single

Translation — Cantidad de traslación

[0 0 0] (predeterminado) | Vector numérico de 3 elementos

Cantidad de traslación, especificada como vector numérico de 3 elementos con forma [t_x t_y t_z].

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 de traslación 3D

Especifique la cantidad de traslación.

t = [10 20.5 15];

Cree un objeto transltform3d que realice la traslación especificada.

tform = transltform3d(t)

tform = 
  transltform3d with properties:

    Dimensionality: 3
       Translation: [10 20.5000 15]

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

Examine el valor de la propiedad A.

tform.A

ans = 4×4

    1.0000         0         0   10.0000
         0    1.0000         0   20.5000
         0         0    1.0000   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:

• transltform3d 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 transltform3d. 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

Consulte también

affinetform3d | rigidtform3d | simtform3d | imwarp

Temas

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