Engee documentation

Discrete Transfer Function Estimator With Magnitude

Calculation of the estimate of the transfer function in the frequency domain.

blockType: DiscreteTransferFunctionEstimatorWithMagnitude

Path in the library:

/Signal Operations/Calculations/Power Spectrum Calculation/Discrete Transfer Function Estimator With Magnitude

Description

Block Discrete Transfer Function Estimator With Magnitude evaluates the transfer function of the system in the frequency domain using the method of averaged modified Welch periodograms.

The block splits the input data into overlapping segments. The length of the data segment and the amount of data overlap can be set using the block parameters. The sampling frequency of the block is equal to , where — the sampling interval of the input signals of the block.

First, the block applies a window function to two input signals and , and then scales them by the power of the window. The block performs a fast Fourier Transform (FFT) for each signal, naming them and . The block calculates  — square FFT . Then the block calculates  — the work and the conjugate value . Estimation of the output transfer function calculated by dividing on .

Ports

Input

# IN_1 — Input signal
vector | the matrix

Details

An input signal specified as a vector or matrix.

Input signals and must have the same size and data type.

Data types

Float32, Float64

Complex numbers support

I don’t

# IN_2 — Input signal
vector | the matrix

Details

An input signal specified as a vector or matrix.

Input signals and must have the same size and data type.

Data types

Float32, Float64

Complex numbers support

I don’t

Output

# OUT_1 — evaluation of the transfer function
vector | the matrix

Details

The estimate of the transfer function returned as a vector or matrix. For more information on how the block calculates the estimate of the transfer function, see Algorithms.

Data types

Float32, Float64

Complex numbers support

I don’t

Parameters

Main

# Window length source — the source of the window length
Same as input frame length

Details

The source of the window length value.

Values

Same as input frame length

Default value

Same as input frame length

Program usage name

WindowLengthSource

Tunable

No

Evaluatable

No

# Window overlap (%) — overlapping the window, %
Int64 integer

Details

The percentage of overlap between consecutive data windows, set as a scalar in the range [0,100).

Default value

0

Program usage name

WindowOverlap

Tunable

No

Evaluatable

Yes

# Averaging method — the averaging method
Running

Details

Set the averaging method. In the current implementation, only the method is available Running — the block calculates an equally weighted average value of the number of estimates of the spectrum specified by the parameter Number of spectral averages.

Values

Running

Default value

Running

Program usage name

AveragingMethod

Tunable

No

Evaluatable

No

# Number of spectral averages — number of spectral averages
Int64 integer

Details

Set the number of spectral averages. Block Discrete Transfer Function Estimator With Magnitude calculates the current score by averaging the latest estimates where — the number of spectral averages. It can be any positive integer scalar.

Dependencies

To use this parameter, set for the parameter Averaging method meaning Running.

Default value

1

Program usage name

NumberSpectralAverages

Tunable

No

Evaluatable

Yes

# FFT length source — the source of the FFT length
Property

Details

By default, the length of the FFT is determined by the parameter FFT length.

Values

Property

Default value

Property

Program usage name

FFTLengthSource

Tunable

No

Evaluatable

No

# FFT length — FFT length
Int64 integer

Details

Set the length of the FFT that the block Discrete Transfer Function Estimator With Magnitude It is used to calculate spectral estimates. It can be any positive integer scalar.

Default value

128

Program usage name

FFTLength

Tunable

No

Evaluatable

Yes

# Window function — window function
Hann

Details

Set the window function for the block Discrete Transfer Function Estimator With Magnitude.

Values

Hann

Default value

Hann

Program usage name

WindowFunction

Tunable

No

Evaluatable

No

# Frequency range — frequency range
One-sided

Details

Set the frequency range for estimating the transfer function.

Meaning One-sided means that the block Discrete Transfer Function Estimator With Magnitude calculates a one-way transfer function of real input signals and .

Values

One-sided

Default value

One-sided

Program usage name

FrequencyRange

Tunable

No

Evaluatable

No

# Output magnitude squired coherence estimate — estimation of the square of the output coherence value
Logical

Details

Select this option to calculate and output an estimate of the coherence square using the averaged modified Welch periodogram method. The coherence square score shows how well the two input signals match each other at each frequency.

Default value

false (switched off)

Program usage name

OutputMagnitudeSquiredCoherenceEstimate

Tunable

No

Evaluatable

No

Algorithms

The method of averaged modified Welch periodograms

Details

For two input signals and The block performs the following steps:

  1. Multiplies the input signals by the window function and scales the result by the power of the window.

  2. Performs FFT of signals and and gets the values and .

  3. Calculates current power spectral density estimates , and the current cross-estimation of the power spectral density taking the moving average of the last elements of vectors , and accordingly:





The estimate of the transfer function is calculated by dividing on .

The square of the coupling coefficient defined as: