Programmer Guide/SPU Reference/SPECTRUM - Revision history

Jw at 14:10, 13 October 2015

2015-10-13T14:10:40Z

← Older revision		Revision as of 16:10, 13 October 2015
Line 91:		Line 91:
	The value of C can be used to shift/scale the amplitudes into a user defined range (e.g. to get absolute sound pressure values).		The value of C can be used to shift/scale the amplitudes into a user defined range (e.g. to get absolute sound pressure values).

	Spectrum parameters{\|		Spectrum parameters
			{\|
	\|-		\|-
	\|value of TYP		\|value of TYP

Jw at 06:41, 13 October 2015

2015-10-13T06:41:02Z

← Older revision		Revision as of 08:41, 13 October 2015
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
			{{SPAtomTemplate}}
	====SPECTRUM - fft spectrum====		====SPECTRUM - fft spectrum====

Jw at 06:40, 13 October 2015

2015-10-13T06:40:49Z

← Older revision		Revision as of 08:40, 13 October 2015
Line 9:		Line 9:

	{\|		{\|
			! style="text-align:leftr;"\|Name
			! Description
			! Default
	\|-		\|-
	\|X		\|X
Line 39:		Line 42:

	{\|		{\|
			! style="text-align:leftr;"\|Name
			! Description
	\|-		\|-
	\|~~<var>~~Y~~</var>~~		\|Y
	\|complex or amplitude spectrum (depends on TYP)		\|complex or amplitude spectrum (depends on TYP)
	\|-		\|-

Jw: /* Inputs: */

2015-10-12T12:48:20Z

Inputs:

← Older revision		Revision as of 14:48, 12 October 2015
Line 9:		Line 9:

	{\|		{\|
	\|-
	\|
	\|
	\|
	\|-		\|-
	\|X		\|X

Toni: moved Programmer Guide/SPU Reference/SPECTRUM - fft spectrum to Programmer Guide/SPU Reference/SPECTRUM

2011-04-28T10:09:21Z

moved Programmer Guide/SPU Reference/SPECTRUM - fft spectrum to Programmer Guide/SPU Reference/SPECTRUM

← Older revision	Revision as of 12:09, 28 April 2011
(No difference)

Admin: 1 revision: Initial import

2010-11-18T16:31:55Z

1 revision: Initial import

← Older revision	Revision as of 18:31, 18 November 2010
(No difference)

193.171.195.8: initial import

2010-05-17T13:05:27Z

initial import

New page

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
====SPECTRUM - fft spectrum====

=====Usage:=====

<code>SPECTRUM <var>X TYP C LFFT SP MAMI MAMX MPV</var></code>

=====Inputs:=====

{|
|-
|
|
|
|-
|X
|signal vector (nX samples)
|no default
|-
|TYP
|selects the type of output spectrum
|def.=LOGARITHMIC
|-
|C
|spectrum scale factor (linear; def=1) or offset (dB, def=0)
|-
|LFFT
|fft length for spectrum computation
|def.= next 2M >= nX
|-
|SP
|starting point for phase locking (in samples)
|-
|MAMI,MAMX
|minimum and maximum amplitude for phase masking
|-
|MPV
|value for masked phase
|def.=0
|}

=====Outputs:=====

{|
|-
|<var>Y</var>
|complex or amplitude spectrum (depends on TYP)
|-
|P
|phase spectrum (if TYP not equal COMPLEX)
|-
|LFFT
|fft length used for spectrum computation (may differ from input LFFT)
|}

=====Function:=====

This function computes the complex spectrum or the amplitude and phase spectrum of the input signal by using the fft. The output format is selected by the input <var>TYP</var>.

If <var>SP</var> is connected, phase locking is performed and the value of <var>SP</var> is used as analysis starting point (in samples). The phase locking algorithm converts the fft phase of the current frame to a phase relative to the specified starting point (e.g. the begin of the 1st frame)

[[File:1278.png]]

with:

reI, imI the real and imaginary part of fft-bin I
[[File:1307.png]] unlocked phase
[[File:1308.png]] locked phase
SP starting time of signal in samples (reference time)
N fft length

The inputs <var>MAMI</var> and <var>MAMX</var> can be used to set the phase values for amplitudes outside the specified (linear!) amplitude range to the constant value supplied with input <var>MPV</var> (default=0). This 'masking' method was implemented to compute the phases for 'relevant components' only and is applied only if one or both of the inputs <var>MAMI</var> and <var>MAMX</var> are connected.

phase masking:

PI = [[File:1307.png]] or [[File:1309.png]] if <var>MAMI</var> <= aI (<= <var>MAMX</var> )
MPV otherwise

with:

PI is the value of output P and aI is the amplitude of fft-bin I

Note: it is also possible to supply a minimum amplitude MAMI only

The phase algorithms are still in development and we are working on more efficient methods for phase locking, unwrapping and masking.

To get comparable amplitudes for different frame lengths (= NX, length of vector X), the signal is scaled by the factor 1/NX. If NX is not a power of 2, the fft-length is set to the next power of 2 greater than NX and the signal is zero padded.

The value of C can be used to shift/scale the amplitudes into a user defined range (e.g. to get absolute sound pressure values).

Spectrum parameters{|
|-
|value of TYP
|output Y
|output P
|-
|0 or <code>COMPLEX</code>
|complex spectrum:Y2I = C.reI, Y2I+1 = C.imI
|not used
|-
|1 or <code>POWER</code>
|power spectrum:YI = C.aI2
|phase spectrum:[[File:1307.png]] if input SP is not connected and[[File:1308.png]] if input SP is connectedphase values are scaled to the range –p to +p (using a module operation)
|-
|2 or <code>LINEAR</code>
|amplitude spectrum:YI = C.aI
|-
|3 or <code>LOGARITHMIC</code>
|logarithmic amplitude spectrum in dB:YI = 20.log10(aI) + C
|-
|4 or <code>REALIMAG</code>
|real part of complex spectrum:YI = C.reI
|imaginary part of complex spectrum:YI = C.imI
|}

with: N is the length of the fft, I is the index of the fft<nowiki>-</nowiki>bin (I=0..N/2+1)