Programmer Guide/SPU Reference/DELAY: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
|||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
== | Copies input <var>X</var> to output <var>Y</var>, delaying it by one evaluation step. | ||
==<code>[SPU DELAY <var>X</var> OUT <var>Y</var>]</code>== | |||
{|class="einrahmen" | |||
!input !!description !!data type !!value type!!default value | |||
|- | |||
|<var>X</var>||data to be averaged ||number, vector, matrix ||variable | |||
|- | |||
|<var>TYP</var>||averaging method ||number (int.), string||constant | |||
|- | |||
|<var>T</var>||averaging parameter, depends on method ||number or n.c.||<var>TYP</var>=1→variable<BR><var>TYP</var>≠2→constant | |||
|- | |||
|<var>RS</var>||reset flag||number or n.c. ||variable | |||
|- | |||
!output !!description !!data type !!value type!!comment | |||
|- | |||
|<var>Y</var>||averaged input data ||same type as <var>X</var> ||variable | |||
|} | |||
;Description: | |||
The averaging algorithm is defined by the inputs <var>TYP</var> and <var>T</var>. The atom averages the elements <var>X</var>[''i'',''j'']<sub>''t''</sub> over evaluation cycles t (''i''=row index, ''j''=column index, ''t''=cycle counter) and stores the averaged value in the element <var>Y</var>[''i'',''j'']<sub>''t''</sub>. | |||
<code> | The cycle counter ''t'' is initialized with 0 and incremented by 1 after each evaluation cycle. The cycle counter is reset, if the input <var>RS</var> is set to a value greater than <code>0</code>. The input <var>RS</var> is checked each time the SPU is started. | ||
:;infinite average: | |||
=== | ::<var>TYP</var>=<code>0</code> or <code>linear</code> | ||
::<var>T</var>=<code>0</code> | |||
;<var> | ::<math>Y[i,j]_t = | ||
\begin{cases} | |||
: | X[i,j]_t & \mbox{if }t=0 \\ | ||
\frac{1}{t+1}(t.Y[i,j]_{t-1}+X[i,j]_t) & \mbox{if }t>0 | |||
= | \end{cases} | ||
</math> | |||
;<var> | :;running average: | ||
::<var>TYP</var>=<code>0</code> or <code>linear</code> | |||
: | ::<var>T</var>><code>0</code>; <var>T</var> is the (integer) number of averaging cycles | ||
::<math>Y[i,j]_t = | |||
\begin{cases} | |||
\frac{1}{t+1}\sum_{z=0}^t X[i,j]_z & \mbox{if }0\leqslant t < T \\ | |||
\frac{1}{T}\sum_{z=0}^{T-1}X[i,j]_{t-z} & \mbox{if }t\geqslant T | |||
\end{cases} | |||
</math> | |||
:;exponential average: | |||
::<var>TYP</var>=<code>1</code> or <code>exponential</code> | |||
::<code>0</code><<var>T</var><<code>1</code>; <var>T</var> is the averaging factor | |||
::<math>Y[i,j]_t = | |||
\begin{cases} | |||
X[i,j]_t & \mbox{if }t=0\mbox{ (or }T\mbox{ out of range)}\\ | |||
\sqrt{T}.Y[i,j]_{t-1}+(1-\sqrt{T}).X[i,j]_t & \mbox{if }t>0 | |||
\end{cases} | |||
</math> | |||
:;minimum: | |||
::<var>TYP</var>=<code>2</code> or <code>minimum</code> | |||
::<var>T</var> is not used | |||
::<math>Y[i,j]_t = | |||
\begin{cases} | |||
X[i,j]_t & \mbox{if }t=0 \\ | |||
min(Y[i,j]_{t-1},X[i,j]_t) & \mbox{if }t>0 | |||
\end{cases} | |||
</math> | |||
:;maximum: | |||
::<var>TYP</var>=<code>3</code> or <code>maximum</code> | |||
::<var>T</var> is not used | |||
::<math>Y[i,j]_t = | |||
\begin{cases} | |||
X[i,j]_t & \mbox{if }t=0 \\ | |||
max(Y[i,j]_{t-1},X[i,j]_t) & \mbox{if }t>0 | |||
\end{cases} | |||
</math> | |||
;See also: | |||
<[[../#Signal Processing Atoms|SP-atoms]]> | |||
<!-- AN, 2.5.2011 --> |
Revision as of 12:29, 6 May 2011
Copies input X to output Y, delaying it by one evaluation step.
[SPU DELAY X OUT Y]
input | description | data type | value type | default value |
---|---|---|---|---|
X | data to be averaged | number, vector, matrix | variable | |
TYP | averaging method | number (int.), string | constant | |
T | averaging parameter, depends on method | number or n.c. | TYP=1→variable TYP≠2→constant | |
RS | reset flag | number or n.c. | variable | |
output | description | data type | value type | comment |
Y | averaged input data | same type as X | variable |
- Description
The averaging algorithm is defined by the inputs TYP and T. The atom averages the elements X[i,j]t over evaluation cycles t (i=row index, j=column index, t=cycle counter) and stores the averaged value in the element Y[i,j]t.
The cycle counter t is initialized with 0 and incremented by 1 after each evaluation cycle. The cycle counter is reset, if the input RS is set to a value greater than 0
. The input RS is checked each time the SPU is started.
- infinite average
- TYP=
0
orlinear
- T=
0
- running average
- TYP=
0
orlinear
- T>
0
; T is the (integer) number of averaging cycles - exponential average
- TYP=
1
orexponential
0
<T<1
; T is the averaging factor- minimum
- TYP=
2
orminimum
- T is not used
- maximum
- TYP=
3
ormaximum
- T is not used
- See also
<SP-atoms>