Engee documentation

orderwaveform

Extraction of the temporal characteristics of the vibration signal.

Library

EngeeDSP

Syntax

Function call

  • xrec = orderwaveform(x,fs,rpm,orderList) — returns waveforms in the time domain corresponding to a given set of orders orderList in the input signal x. The signal x It is measured at a set rotation speed rpm expressed in rpm, and the argument fs sets the sampling rate in Hz. Vector orderList sets the desired orders, the waveforms of which are returned in the corresponding columns of the matrix xrec. For calculations, the function orderwaveform uses the Wold—Kalman filter.

Arguments

Input arguments

# x — input signal

+ vector

Details

The input signal is set as a column vector.

Типы данных

Float32, Float64

# fs — sampling rate
scalar

Details

The sampling frequency in Hz, set as a positive scalar.

# rpm — rotation speed
vector

Details

Rotation speeds, set as a vector of positive values expressed in rpm. Length of the argument rpm must match the length of the argument. x.

  • If there is a pulse signal of the tachometer, use the function tachorpm for direct extraction rpm.

  • If there is no pulse signal of the tachometer, use the function rpmtrack to extract rpm from the vibration signal.

# orderList — list of orders

+ vector

Details

A list of orders specified as a vector. The values of this argument must not exceed fs / (2 × max(rpm / 60)).

Типы данных

Float32, Float64

# rpmrefidx — indexes of rotation speed columns

+ vector

Details

Column indexes of the rotation frequency vector, set as a vector of the same size as orderList.

Типы данных

Float32, Float64

Input arguments «name-value»

Specify optional argument pairs as Name,Value, where Name — the name of the argument, and Value — the appropriate value. Type arguments «name-value» they should be placed after the other arguments, but the order of the pairs does not matter. You can specify multiple pairs «name-value».

Use commas to separate the name and value, and Name put it in quotation marks.

# FilterOrder — the order of the Wold—Kalman filter

+ 1 (by default) | 2

Details

The order of the Wold—Kalman filter, given as 1 or 2.

Типы данных

Int32, Int64

# Bandwidth — approximate band widths at the half-power level

+ fs/100 (by default) | scalar | vector

Details

A list of approximate half-power bandwidth values, specified as a scalar or vector with the same number of elements as the argument orderList. Smaller argument values Bandwidth They provide a smooth narrow-band output signal, but it may not accurately reflect rapid changes in the amplitude of the order.

Типы данных

Float32, Float64

# Decouple — reduce mod interaction

+ false (by default) | true

Details

The mode interaction reduction parameter, set as false or true. If this argument is set to true, function orderwaveform Extracts waveforms of orders at the same time, which allows you to separate closely spaced or overlapping orders.

Типы данных

Bool

# SegmentLength — length of overlapping segments

+ an integer

Details

The length of the overlapping segments, set as an integer. If the value of this argument is set, the function orderwaveform divides the input signal into segments, calculates the reconstructed waveforms for each segment, and combines the results. If the segments are too short, the function may not correctly recognize localized events, such as overlapping orders.

Типы данных

Int32, Int64

Output arguments

# xrec — reconstructed waveforms of orders in the time domain

+ the matrix

Details

Reconstructed waveforms of orders in the time domain, returned as a matrix with one waveform in each column.

Типы данных

Float32, Float64

Literature

  1. Feldbauer, Christian, and Robert Höldrich. «Realization of a Vold-Kalman Tracking Filter — A Least Squares Problem.» Proceedings of the COST G-6 Conference on Digital Audio Effects (DAFX-00). Verona, Italy, December 7–9, 2000.

  2. Vold, Håvard, and Jan Leuridan. «High Resolution Order Tracking at Extreme Slew Rates Using Kalman Tracking Filters.» Shock and Vibration. Vol. 2, 1995, pp. 507–515.