Method ao/dtfe


  DTFE estimates transfer function between time-series objects.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
  DESCRIPTION: DTFE makes discrete transfer function estimates of the time-series
               in the input analysis objects. The estimate is done by taking
               the ratio of the DFTs between the two inputs at the
               specified frequencies.
 
  CALL:        b = dtfe(a1,a2,pl)
 
  INPUTS:      a1   - input analysis object
               a2   - input analysis object
               pl   - input parameter list
 
  OUTPUTS:     b    - output analysis object
 
  Parameters Description
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Method Details
Access public
Defining Class ao
Sealed 0
Static 0

Parameter Description

Default

no description
Key Default Value Options Description
dft
WIN {13, {'Rectangular', 'Welch', 'Bartlett', 'Hanning', 'Hamming', 'Nuttall3', 'Nuttall4', 'Nuttall3a', 'Nuttall3b', 'Nuttall4a', 'Nuttall4b', 'Nuttall4c', 'BH92', 'SFT3F', 'SFT3M', 'FTNI', 'SFT4F', 'SFT5F', 'SFT4M', 'FTHP', 'HFT70', 'FTSRS', 'SFT5M', 'HFT90D', 'HFT95', 'HFT116D', 'HFT144D', 'HFT169D', 'HFT196D', 'HFT223D', 'HFT248D', 'Kaiser', 'levelledHanning'}, 1} none The window to be applied to the data to remove the discontinuities at edges of segments. [default: taken from user prefs]
Only the design parameters of the window object are used. Enter a string value containing the window name e.g.
plist('Win', 'Kaiser', 'psll', 200)
plist('Win', 'BH92')
PSLL 200 none The peak sidelobe level for Kaiser windows.
Note: it is ignored for all other windows
SCALE 1
  • 1
  • 0
Scale the output according to the applied window resulting in [unit] rms.
F, FREQUENCIES, F0 -1 none The vector of frequencies at which to compute the DFT
or an AO where the x-axis is taken for the frequency values.
NBINS 5 none The number of bins either side of each frequency from which to compute the mean error.The error will be computed from the bins deltaF*[-Nbins-skip:-skip skip:skip+Nbins] where deltaF = fs/Nsamples is the frequency resolution.
SKIP 3 none The number of bins either side of each frequency to ignore when computing the mean error.
dtfe
ORDER, N 0
  • -1
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
The order of segment detrending:
  • -1 - no detrending
  • 0 - subtract mean
  • 1 - subtract linear fit
  • N - subtract fit of polynomial, order N
TIMES, SPLIT [] none The time range to analyze. If not empty, sets the time interval to operate on.
As in ao/split, the interval can be specified by:
  • a vector of doubles
  • a timespan object
  • a cell array of time strings
  • a vector of time objects

Example

plist('WIN', {13,{'Rectangular', 'Welch', 'Bartlett', 'Hanning', 'Hamming', 'Nuttall3', 'Nuttall4', 'Nuttall3a', 'Nuttall3b', 'Nuttall4a', 'Nuttall4b', 'Nuttall4c', 'BH92', 'SFT3F', 'SFT3M', 'FTNI', 'SFT4F', 'SFT5F', 'SFT4M', 'FTHP', 'HFT70', 'FTSRS', 'SFT5M', 'HFT90D', 'HFT95', 'HFT116D', 'HFT144D', 'HFT169D', 'HFT196D', 'HFT223D', 'HFT248D', 'Kaiser', 'levelledHanning'},1}, 'PSLL', [200], 'SCALE', [true], 'F', [-1], 'NBINS', [5], 'SKIP', [3], 'ORDER', [0], 'TIMES', [[]])

back to top back to top

Some information of the method ao/dtfe are listed below:
Class name ao
Method name dtfe
Category Signal Processing
Package name ltpda
VCS Version 967b0eec0dece803a81af8ef54ad2f8c784b20b2
Min input args 2
Max input args -1
Min output args 1
Max output args -1
Can be used as modifier 0
Supported numeric types {'double'}




©LTP Team