Programmer Guide/Command Reference/EVAL/formants: Difference between revisions

From STX Wiki
Jump to navigationJump to search
m (1 revision: Initial import)
No edit summary
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
=====formants=====
Format tracking algorithm.
Format tracking algorithm.
;Usage:<code>formants(<var>cf</var>, <var>ca</var>, <var>f0</var>, <var>mflag</var>, <var>bias</var>, <var>lmin</var>)</code>
:;<var>cf</var>:a matrix containing the frequencies of the formant candidates in Hz
::*number of frames: N=<code>nrow(''cf'')</code>
::*maximum number of candidates M=<code>ncol(''cf'')</code>
::*each row of ''cf'' contains the candidates of one frame
::*if <code>''cf''[i,k]=0 (0&le;i<N, 0&le;k<M)</code> the number of candidates in frame i equals k
::*the frequencies of frame i must be in ascending order: <code>''cf''[i,j]<''cf''[i,j+1] (0&le;j<k-1)</code>
:;<var>ca</var>:a matrix containing the amplitudes of formant candidates in dB
::*''ca'' must be a matrix with the same dimensions as ''cf''<BR>or a scalar, if amplitudes should not be used for formant tracking
:;<var>f0</var>:f0 vector
::*''f0'' must be a vector with length N containing the f0 values int Hz<BR>or a scalar, if f0 should not be used for formant tracking
::*if ''f0'' is supplied, the formant tracking is only applied to voiced regions
:;<var>mflag</var>:selects the tracking method
::*currently only one method (''mflag''=0) is implemented (see [[Programmer_Guide/SPU_Reference/FORMANTS|sp-atom FORMANTS]] for more details)
::*a second method using a formant modell is under development
:;<var>bias</var>:tracking bias in Hz
:;<var>lmin</var>:the minimum length of a track in frames
;Result: A matrix with N rows and L columns. Each column ''l'' contains the formant track with order ''l''+1. L is the maximum formant order or the maximum number of parallel tracks.
;See also: [[../f0ac|f0ac]], [[../lpc|lpc]], [[../cepstrum|cepstrum]], [[../ipeak|ipeak]],  [[Programmer_Guide/SPU_Reference/FORMANTS|sp-atom FORMANTS]]


=====Usage:=====
[[../#Functions|<function list>]]
 
<code>formants(<var>type</var>, <var>fcd</var>, <var>f0</var>, <var>fmd</var>, <var>dt</var>, <var>kdt</var>, <var>minsd</var>)</code>
 
=====Parameters:=====
 
;<var>type</var>
 
:The type of formant candidate array:
 
:<code>0</code> - frequencies only. <code>fcd(i,j)</code> = frq of candidate j in frame i
 
:<code>1</code> - frequencies and amplitudes. <code>fcd(i,2*j)</code> = frq of candidate j in frame i
 
:<code>fcd(i,2*j+1)</code> = mp of candidate j in frame i
 
;<var>fcd</var>
 
:The array of formant candidates, format defined by the argument <var>type</var>.
 
;<var>f0</var>
 
:The f0 vector.
 
;<var>fmd</var>
 
:The formant model parameters:
 
:fmd(i,0) = minimum frequency of formant i
 
:fmd(i,1) = maximum frequency of formant i
 
:fmd(i,2) = maximum frequency slope of formant i (Hz / kdt)
 
:fmd(i,3) = maximum amplitude slope of formant i (dB / kdt)
 
;<var>dt</var>
 
:The hopsize.
 
;<var>kdt</var>
 
:The reference time for the slope values of the model (in seconds). The default is the same as <var>dt</var>.
 
;<var>minsd</var>
 
:The minimum duration of the tracking sections (in seconds). The default is <code>2 *</code> <var>dt</var>.
 
=====Function:=====
 
Formant tracking algorithm.
 
=====Result:=====
 
The formant frequency tracks.
 
=====Return Type:=====
 
array

Latest revision as of 20:16, 21 April 2011

Format tracking algorithm.

Usage
formants(cf, ca, f0, mflag, bias, lmin)
cf
a matrix containing the frequencies of the formant candidates in Hz
  • number of frames: N=nrow(cf)
  • maximum number of candidates M=ncol(cf)
  • each row of cf contains the candidates of one frame
  • if cf[i,k]=0 (0≤i<N, 0≤k<M) the number of candidates in frame i equals k
  • the frequencies of frame i must be in ascending order: cf[i,j]<cf[i,j+1] (0≤j<k-1)
ca
a matrix containing the amplitudes of formant candidates in dB
  • ca must be a matrix with the same dimensions as cf
    or a scalar, if amplitudes should not be used for formant tracking
f0
f0 vector
  • f0 must be a vector with length N containing the f0 values int Hz
    or a scalar, if f0 should not be used for formant tracking
  • if f0 is supplied, the formant tracking is only applied to voiced regions
mflag
selects the tracking method
  • currently only one method (mflag=0) is implemented (see sp-atom FORMANTS for more details)
  • a second method using a formant modell is under development
bias
tracking bias in Hz
lmin
the minimum length of a track in frames
Result
A matrix with N rows and L columns. Each column l contains the formant track with order l+1. L is the maximum formant order or the maximum number of parallel tracks.
See also
f0ac, lpc, cepstrum, ipeak, sp-atom FORMANTS

<function list>

Retrieved from "https://mediawiki.kfs.oeaw.ac.at/stx/docs/wiki/index.php?title=Programmer_Guide/Command_Reference/EVAL/formants&oldid=4178"

Navigation menu

Personal tools