# tforminv

Apply inverse N-D spatial transformation

**The tforminv function is not recommended for 2-D and 3-D
geometric transformations. Use the transformPointsInverse
function instead. For more information, see Compatibility Considerations.**

## Syntax

## Description

`[`

applies the `U1,U2,...,U_ndims_in`

] = tforminv(`T`

,`X1,X2,...,X_ndims_out`

)`ndims_out`

-to-`ndims_in`

inverse
transformation defined in `T`

to the coordinate arrays
`X1,X2,...,X_ndims_out`

. The transformation maps the point
`[X1(k) X2(k) ... X_ndims_out(k)]`

to the point ```
[U1(k)
U2(k) ... U_ndims_in(k)]
```

.

The number of input coordinate arrays, `ndims_out`

, must equal
`T.ndims_out`

. The number of output coordinate arrays,
`ndims_in`

, must equal `T.ndims_in`

. The
arrays `X1,X2,...,X_ndims_out`

can have any dimensionality, but
must be the same size. The output arrays `U1,U2,...,U_ndims_in`

must be this size also.

applies the `U`

= tforminv(`T`

,`X`

)`ndims_out`

-to-`ndims_in`

inverse
transformation defined in `T`

to array `X`

.

When

`X`

is a 2-D matrix with dimensions*m*-by-`ndims_out`

matrix,`U`

is a 2-D matrix with dimensions*m*-by-`ndims_in`

.`tforminv`

applies the transformation to each row of`X`

.`tforminv`

maps the point`X`

(*k*, : ) to the point`U`

(*k*, : ).When

`X`

is an (*N*+1)-dimensional array,`tforminv`

maps the point`X`

(*k*_{1},*k*_{2}, … ,*k*_{N}, : ) to the point`U`

(*k*_{1},*k*_{2}, … ,*k*_{N}, : ).`size(X,N+1)`

must equal`ndims_out`

.`U`

is an (*N*+1)-dimensional array, with`size(U,I)`

equal to`size(X,I)`

for`I`

= 1, … ,*N*, and`size(U,N+1)`

equal to`ndims_in`

.

The syntax `U = tforminv(X,T)`

is an older form of this syntax
that remains supported for backward compatibility.

`[`

maps one (`U1,U2,...,U_ndims_in`

] = tforminv(`T`

,`X`

)*N*+1)-dimensional array to `ndims_in`

equally sized *N*-dimensional arrays.

maps `U`

= tforminv(`T`

,`X1,X2,...,X_ndims_out`

)`ndims_out`

*N*-dimensional arrays to one (*N*+1)-dimensional
array.

## Examples

## Input Arguments

## Output Arguments

## Extended Capabilities

## Version History

**Introduced before R2006a**