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}}}}
====DELAY - delay a signal====
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&rarr;variable<BR><var>TYP</var>&ne;2&rarr;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
|}


Copies input <var>x</var> to output <var>y</var>, delaying it by one evaluation step.


=====Usage:=====
;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>DELAY <var>x</var></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:
=====Inputs:=====
::<var>TYP</var>=<code>0</code> or <code>linear</code>
 
::<var>T</var>=<code>0</code>
;<var>x</var>
::<math>Y[i,j]_t =  
 
\begin{cases}
:Any data type.
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
=====Outputs:=====
\end{cases}
 
</math>
;<var>y</var>
:;running average:
 
::<var>TYP</var>=<code>0</code> or <code>linear</code>
:The same data type as <var>x</var>.
::<var>T</var>&gt;<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>&lt;<var>T</var>&lt;<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 13: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 or linear
T=0
{\displaystyle 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}}}
running average
TYP=0 or linear
T>0; T is the (integer) number of averaging cycles
{\displaystyle 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}}}
exponential average
TYP=1 or exponential
0<T<1; T is the averaging factor
{\displaystyle 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}}}
minimum
TYP=2 or minimum
T is not used
{\displaystyle 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}}}
maximum
TYP=3 or maximum
T is not used
{\displaystyle 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}}}
See also

<SP-atoms>

Navigation menu

Personal tools