blob: d2a4e26b632704c62166b87efd29c7b455aef501 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
.. _affine:
================================================================================
Affine transformation
================================================================================
.. versionadded:: 6.0.0
The affine transformation applies translation and scaling/rotation terms on the
x,y,z coordinates, and translation and scaling on the temporal coordinate.
+---------------------+----------------------------------------------------------+
| **Alias** | affine |
+---------------------+----------------------------------------------------------+
| **Domain** | 4D |
+---------------------+----------------------------------------------------------+
| **Input type** | XYZT |
+---------------------+----------------------------------------------------------+
| **output type** | XYZT |
+---------------------+----------------------------------------------------------+
By default, the parameters are set for an identity transforms. The transformation
is reversible unless the determinant of the sji matrix is 0, or `tscale` is 0
Parameters
################################################################################
Optional
-------------------------------------------------------------------------------
.. option:: +xoff=<value>
Offset in X. Default value: 0
.. option:: +yoff=<value>
Offset in Y. Default value: 0
.. option:: +zoff=<value>
Offset in Z. Default value: 0
.. option:: +toff=<value>
Offset in T. Default value: 0
.. option:: +s11=<value>
Rotation/scaling term. Default value: 1
.. option:: +s12=<value>
Rotation/scaling term. Default value: 0
.. option:: +s13=<value>
Rotation/scaling term. Default value: 0
.. option:: +s21=<value>
Rotation/scaling term. Default value: 0
.. option:: +s22=<value>
Rotation/scaling term. Default value: 1
.. option:: +s23=<value>
Rotation/scaling term. Default value: 0
.. option:: +s31=<value>
Rotation/scaling term. Default value: 0
.. option:: +s32=<value>
Rotation/scaling term. Default value: 0
.. option:: +s33=<value>
Rotation/scaling term. Default value: 1
.. option:: +tscale=<value>
Time scaling term. Default value: 1
Mathematical description
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
.. math::
:label: formula
\begin{align}
\begin{bmatrix}
X \\
Y \\
Z \\
T \\
\end{bmatrix}^{dest} =
\begin{bmatrix}
xoff \\
yoff \\
zoff \\
toff \\
\end{bmatrix} +
\begin{bmatrix}
s11 & s12 & s13 & 0 \\
s21 & s22 & s23 & 0 \\
s31 & s32 & s33 & 0 \\
0 & 0 & 0 & tscale \\
\end{bmatrix}
\begin{bmatrix}
X \\
Y \\
Z \\
T \\
\end{bmatrix}^{source}
\end{align}
|