Difference between revisions of "NVGate Filter Builder"

From OROS Wiki
Jump to navigation Jump to search
Line 107: Line 107:
: Note that even if plug-ins run in the same bandwidth, it’s not possible to share filters between different plug-ins.
: Note that even if plug-ins run in the same bandwidth, it’s not possible to share filters between different plug-ins.


* '''Low cut-off frequency''' and '''High cut-off frequency''': The low cut-off frequency of the filter ''f''<sub>low</sub> and the high cut-off frequency of the filter ''f''<sub>high</sub>, as shown below. Their values need to meet the following conditions in the Office mode:
* '''Low cut-off frequency''' and '''High cut-off frequency''': The low cut-off frequency of the filter ''f''<sub>low</sub> and the high cut-off frequency of the filter ''f''<sub>high</sub>, as shown in the following figure. Their values need to meet the following conditions in the Office mode:


: ''f''<sub>low</sub> ≥ 0.0001 * '''FR'''  
: ''f''<sub>low</sub> ≥ 0.0001 * '''FR'''  

Revision as of 16:00, 4 December 2020

Filter

Define several IIR filters and select the modules to which the filters are applied. The filters operate on the time domain series, and they can be applied to various signal processing stages (Inputs, Plug-in channels, Outputs, Player tracks).

Filter builder 02.png

Connect filter

In the acquisition tab, The left button (Apply to) allows users to choose where to apply the filters. The right button (Filter builder) allows users to setup the properties of the filters.

Image 2020-12-04 131308.png



Reports_Tools_Ribbons_370.png Apply to: This button opens the following dialog. To choose where to apply the filters, drag the selected filter on the left and drop it on the selected module on the right.

Filter connect.png

Then the filters connection properties will be displayed, and the properties of the selected filters and channels can be modified in this window.

Image 2020-12-04 133712.png

Note: Due to the bandwidth compatibility, once a filter is applied to a module (ex: a plug-in channel), it can only be used to the same plug-in channels. The front-end is considered as a plug-in.

Filter builder

High-Low pass

Reports Tools Ribbons 373.png: Used to design a high-pass filter or a low-pass filter (Butterworth, Chebyshev Type I, and Chebyshev Type II).

Image 2020-12-04 140721.png
  • Label: The name of the filter (by default High-Low pass n, with 1 ≤ n ≤ 4).
  • Type: The type of the filter - Low pass or High pass.
  • Design Type: The analog prototype filter - Butterworth, Chebyshev band-pass ripple (Type I), or Chebyshev stop-band ripple (Type II).
The Butterworth filter has flat response in both the pass band and stop band, but its transition band is wide.
The Chebyshev type I (band-pass ripple filter) has the steepest roll-off among the three filters, and its response in the stop band is flat. However, it has ripples in the pass band.
The Chebyshev type II (stop-band ripple) filter has flat response in the pass band, but it has ripples in the stop band. Its transition band is narrower than the Butterworth filter, but wider than the Chebyshev type I.
Below is an example showing these three filters with the same filter order.

Filters 3.png


  • Filter order: The filter order can be selected from 1 to 40 in Office mode, and from 1 to 10 in Connected mode. The higher the order is, the steeper the cut-off slope is.

Butterworth freq response.png


  • Applied to: Shows which plug-in the filter is applied to. The construction of the filter requires applying it to a signal with the same bandwidth. The determination of the associated plug-in/bandwidth is automatic. Deactivate the filter to reset.
The other modules (front-end, monitor, resources) operate at the front end input sampling frequency (in connected mode on-line) or at the max player bandwidth (in post analysis mode).
Apply to Description
Front-end (20 kHz) To be used on any resources and monitor
FFTx (10 kHz) To be used on the FFT x analyzer only


Note that even if plug-ins run in the same bandwidth, it’s not possible to share filters between different plug-ins.
  • Cut-off frequency: The cut-off frequency of the filter. The maximum value is the input frequency range FR. The minimum value is FR / 50000 in the Office mode, and FR / 40000 in the Connected mode.
Warning: For measurements including the signal phase (i.e: balancing or Bode plot), the cut-off frequency must be chosen far from (at least 10 times) the frequency of interest. If not, the phase of the low pass filter will affect the phase of the result.
  • By-pass: On / Off. The filter is not applied if By-pass is On.
Filter builder 03.png

By-passing a filter does not request stabilization time.

Pass-Stop band

Reports_Tools_Ribbons_374.png: Used to design a band-pass filter or a band-stop filter.

Image 2020-12-04 141352.png
  • Label: The name of the filter (by default Pass-Stop band n, with 1 ≤ n ≤ 4).
  • Type: The type of the filter - Band pass or Band stop.
  • Design type: The analog prototype filter - Butterworth, Chebyshev band-pass ripple (Type I), or Chebyshev stop-band ripple (Type II).
  • Filter order: The filter order is 2*N, and N can be selected between 1 to 30 in the Office mode, and between 1 to 10 in the Connected mode. The higher the order is, the steeper the cut-off slope is.
  • Applied to: Shows which plug-in the filter is applied to. The construction of the filter requires applying it to a signal with the same bandwidth. The determination of the associated plug-in/bandwidth is automatic. Deactivate the filter to reset.
The other modules (front-end, monitor, resources) operate at the front end input sampling frequency (in connected mode on-line) or at the max player bandwidth (in post analysis mode).
Apply to Description
Front-end (20 kHz) To be used on any resources and monitor
FFTx (10 kHz) To be used on the FFT x analyzer only


Note that even if plug-ins run in the same bandwidth, it’s not possible to share filters between different plug-ins.
  • Low cut-off frequency and High cut-off frequency: The low cut-off frequency of the filter flow and the high cut-off frequency of the filter fhigh, as shown in the following figure. Their values need to meet the following conditions in the Office mode:
flow ≥ 0.0001 * FR
fhighFR
0.0004 FRfhigh - flow ≤ 0.9998 * FR
And in the Connected mode, the conditions become as below:
flow ≥ 0.0005 * FR
fhighFR
0.000675 * FRfhigh - flow ≤ 0.99 * FR
Here FR is the input frequency range, the passband attenuation is 3 dB (0.1 dB if the design type is Chebyshev pass-band ripple filter), and the transition width is FR / 400.

Image 2020-11-27 095451.png



  • By-pass: On / Off. The filter is not applied if By-pass is On.


Filter builder 04.png
Integrator

Reports Tools Ribbons 375.png: Used to design a time integrator filter associated with a high pass filter (to limit gain near DC components).

  • Label: the name of the filter (by default Integrator n, with 1 <= n <= ).
  • Type: the type (High Pass + single integ. / High Pass + double integ.) of the filter.
  • Applied to: Indicates on which plug-in the filter can be used. Indeed the construction of the filter requires applying it on signal with the same bandwidth. The determination of the associated plug-in/bandwidth is automatic. Deactivate the filter to reset it.

The other modules (front-end, monitor, resources) operate at the front end input sampling (in connected mode on-line) or to the max player bandwidth (in post analysis mode).

Apply to Description
Front-end (20 kHz) To be used on any resources and monitor
FFTx (10 kHz) To be used on the FFT x analyzer only


    • Note : Even if plug-ins run in the same bandwidth, it not possible to share filters between different plug-in.
  • HP cut-off frequency: the cut-off frequency of the High pass filter contained in this integrator filter. Its maximum value is FR / 2000, and its minimum value is FR / 10000, where FR is the input frequency range.

Warning for measurements including signal phase (i.e: balancing or Bode plot) the cut-off frequency must be chosen far (10 times) from the frequency of interest. If not the phase of the low pas filter will affect the phase of the result.

'Integration 'time: the time constant of the integrator filter is equal to 1s. This is fixed value, not a setting.

The frequency response of a first order integrator filter is equal to:

Integrator.png


  • By-pass: On / Off. The filter is not applied if By-pass is On.
Filter builder 06.png
  • Note : In post analyse, you will have a stabilisation time of 2 seconds before having any results or signal :
    • The integrator filter has an integration time of 1s.
    • This integrator filter also include a high pass filter. This filter needs also a stabilization time of 1s.

Therefore, the total stabilisation time of the filter is 2 seconds. Meanning the 2 first seconds of the signal will not be analysed.

Differentiator

Reports Tools Ribbons 376.pngUsed to setup a time differentiator filter associated with an exponential average to avoid that small fluctuations of the input signal become important distortions in the output signal.

  • Label: the name of the filter (by default Differentiator n, with 1 <= n <= 3).
  • Applied to: Indicates on which plug-in the filter can be used. Indeed the construction of the filter requires applying it on signal with the same bandwidth. The determination of the associated plug-in/bandwidth is automatic. Deactivate the filter to reset it.

The other modules (front-end, monitor, resources) operate at the front end input sampling (in connected mode on-line) or to the max player bandwidth (in post analysis mode).

Apply to Description
Front-end (20 kHz) To be used on any resources and monitor
FFTx (10 kHz) To be used on the FFT x analyzer only


Note even if plug-ins run in the same bandwidth, it no possible to share filters between different plug-in.

  • Avg. duration:Filter average duration. By default, the average duration is equal to 0s. This value can be modified by the user. This setting is used to specify the exponential average duration of the differentiator filter

Xmean(n) = λX(n) + (1 – λ)Xmean(n-1) with Xmean(n) the averaged input signal at instant n, X(n) the input signal at instant n and λ the averaging factor.

The following formula is applied to the averaged signal:

Y(n) = (Xmean(n) -Xmean(n-1)) / fs. with, Y(n) the differentiated signal at instant n, Xmean(n) the averaged input signal at instant n and fs the sampling frequency.

  • By-pass: On / Off. The filter is not applied if By-pass is On.
Filter builder 07.png