Difference between revisions of "NVGate Filter Builder"

From OROS Wiki
Jump to navigation Jump to search
m (English edits)
Line 1: Line 1:


====Filter builder====
====Filter builder====
Manage the filters definition and position. These filters operate on the time domain series. They can be applied in various locations into the signal process (Inputs, Plug-in channels, Outputs, Player tracks).
Manage the filters definition and position. These filters operate on the time domain series. They can be applied in various locations in the signal process (Inputs, Plug-in channels, Outputs, Player tracks).


[[Image:Filter_builder_02.png|framed|none]]
[[Image:Filter_builder_02.png|framed|none]]
Line 7: Line 7:
====Connect filter====
====Connect filter====
[[Image:filter.png|framed|Right]]
[[Image:filter.png|framed|Right]]
On [[NVGate_Ribbons:_Acquisition_Tab|acquisition tab,]] The left button (''Apply to''), on filter group, allows dispatching the filters to the different possible location in the signal process.
On [[NVGate_Ribbons:_Acquisition_Tab|acquisition tab,]] The left button (''Apply to''), on filter group, allows dispatching the filters to the different possible locations in the signal process.
The second button allows selecting a filter type and opens the corresponding setup.<br>
The second button allows selecting a filter type and opens the corresponding setup.<br>


Line 14: Line 14:
[[Image:Filter_connect.png|framed|none]]
[[Image:Filter_connect.png|framed|none]]


All filters are available, and by adding any filters to any channel, the properties of filters and channel selected are displayed and filters are applied in the current measurement:
All filters are available, and by adding any filters to any channel, the properties of filters and channels selected are displayed and filters are applied in the current measurement:


[[Image:Reports_Tools_Ribbons_372.png|framed|none]]
[[Image:Reports_Tools_Ribbons_372.png|framed|none]]


Warning: Due to bandwidth compatibility, the filters use is exclusive of the plug-in. I.e: Once a filter is associated to a location (ex: a plug-in channel) it can be used on the same plug-in channels only. The front-end is considered as a plug-in.
Warning: Due to bandwidth compatibility, the filters use is exclusive of the plug-in. I.e: Once a filter is associated to a location (ex: a plug-in channel) it can be used on only the same plug-in channels. The front-end is considered a plug-in.


====Filters====
====Filters====
Line 27: Line 27:
* '''Type''': the type (Low pass or High pass) of the filter.
* '''Type''': the type (Low pass or High pass) of the filter.
* '''Filter order''': filter order from 1 to 6. The higher is the order, the steepest is the cut-off slope.
* '''Filter order''': filter order from 1 to 6. The higher is the order, the steepest is the cut-off slope.
* '''Applied to''': Indicates on witch 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. De-activated the filter to reset ot.
* '''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) operates at the front end input sampling (in connected mode on-line) or to the max player bandwidth (in post analysis mode).
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).


{|border="2" cellspacing="0" cellpadding="4" width="59%" align="center"
{|border="2" cellspacing="0" cellpadding="4" width="59%" align="center"
Line 44: Line 44:
|}<br clear="all">
|}<br clear="all">


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


* '''Cut'''-'''off frequency''': the filter cut-off frequency. Its maximum value is the input frequency range. Its minimum value is: FR / 40 (for a Low pass filter) and FR / 400 (for a High pass filter), where FR is the input frequency range.
* '''Cut'''-'''off frequency''': the filter cut-off frequency. Its maximum value is the input frequency range. Its minimum value is: FR / 40 (for a Low pass filter) and FR / 400 (for a High pass filter), 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 chose far (10 times) from the frequency of interest. If not the phase of the low pas filter will affect the phase of the result.
'''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 pass filter will affect the phase of the result.


* '''By'''-'''pass''': On / Off. The filter is not applied if By-pass is On.
* '''By'''-'''pass''': On / Off. The filter is not applied if By-pass is On.
Line 53: Line 53:
[[Image:Filter_builder_03.png|framed|none]]
[[Image:Filter_builder_03.png|framed|none]]


By passing a filter does not request stabilization time.
By-passing a filter does not request stabilization time.


=====Pass-Stop band=====
=====Pass-Stop band=====
Line 61: Line 61:
* '''Type''': the type (Band pass or Band stop) of filter.
* '''Type''': the type (Band pass or Band stop) of filter.
* '''Filter order''': 2, 4, 6, 8 or 10. The higher is the order, the steepest is the cut-off.
* '''Filter order''': 2, 4, 6, 8 or 10. The higher is the order, the steepest is the cut-off.
* '''Applied to''': Indicates on witch 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. De-activated the filter to reset ot.
* '''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) operates at the front end input sampling (in connected mode on-line) or to the max player bandwidth (in post analysis mode).
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).


{|border="2" cellspacing="0" cellpadding="4" width="59%" align="center"
{|border="2" cellspacing="0" cellpadding="4" width="59%" align="center"
Line 78: Line 78:
|}<br clear="all">
|}<br clear="all">


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


* '''Low cut-off frequency''': the low filter cut-off frequency. Its minimum value is 0.055 * FR, where FR is the input frequency range. However, the following conditions must also be fulfilled:
* '''Low cut-off frequency''': the low filter cut-off frequency. Its minimum value is 0.055 * FR, where FR is the input frequency range. However, the following conditions must also be fulfilled:
Line 84: Line 84:
'''0.0075 * FR <nowiki><</nowiki>= B <nowiki><</nowiki>= 0.5 FR'''
'''0.0075 * FR <nowiki><</nowiki>= B <nowiki><</nowiki>= 0.5 FR'''


where B is the bandwidth between Low and high cut-off frequency
where B is the bandwidth between Low and high cut-off frequency and FR is the input frequency range.
 
and FR is the input frequency range.


* '''High cut-off frequency''': the filter high cut-off frequency. Its maximum value is the input frequency range. However, the following conditions must also be fulfilled: see Low cut-off frequency.
* '''High cut-off frequency''': the filter high cut-off frequency. Its maximum value is the input frequency range. However, the following conditions must also be fulfilled: see Low cut-off frequency.
Line 98: Line 96:
* '''Label''': the name of the filter (by default Integrator n, with 1 <nowiki><</nowiki>= n <nowiki><</nowiki>= ).
* '''Label''': the name of the filter (by default Integrator n, with 1 <nowiki><</nowiki>= n <nowiki><</nowiki>= ).
* '''Type''': the type (High Pass <nowiki>+</nowiki> single integ. / High Pass <nowiki>+</nowiki> double integ.) of the filter.
* '''Type''': the type (High Pass <nowiki>+</nowiki> single integ. / High Pass <nowiki>+</nowiki> double integ.) of the filter.
* '''Applied to''': Indicates on witch 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. De-activated the filter to reset ot.
* '''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) operates at the front end input sampling (in connected mode on-line) or to the max player bandwidth (in post analysis mode).
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).


{|border="2" cellspacing="0" cellpadding="4" width="59%" align="center"
{|border="2" cellspacing="0" cellpadding="4" width="59%" align="center"
Line 115: Line 113:
|}<br clear="all">
|}<br clear="all">


Note even if plug-ins run in the same bandwidth, it no possible to share filters between different plug-in.
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.
* '''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 chose far (10 times) from the frequency of interest. If not the phase of the low pas filter will affect the phase of the result.
'''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.
'''Integration ''''''time''': the time constant of the integrator filter is equal to 1s. This is fixed value, not a setting.
Line 135: Line 133:


* '''Label''': the name of the filter (by default Differentiator n, with 1 <nowiki><</nowiki>= n <nowiki><</nowiki>= 3).
* '''Label''': the name of the filter (by default Differentiator n, with 1 <nowiki><</nowiki>= n <nowiki><</nowiki>= 3).
* '''Applied to''': Indicates on witch 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. De-activated the filter to reset ot.
* '''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) operates at the front end input sampling (in connected mode on-line) or to the max player bandwidth (in post analysis mode).
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).


{|border="2" cellspacing="0" cellpadding="4" width="59%" align="center"
{|border="2" cellspacing="0" cellpadding="4" width="59%" align="center"

Revision as of 20:23, 28 May 2020

Filter builder

Manage the filters definition and position. These filters operate on the time domain series. They can be applied in various locations in the signal process (Inputs, Plug-in channels, Outputs, Player tracks).

Filter builder 02.png

Connect filter

On acquisition tab, The left button (Apply to), on filter group, allows dispatching the filters to the different possible locations in the signal process. The second button allows selecting a filter type and opens the corresponding setup.

Reports_Tools_Ribbons_370.png Apply to: This button opens the filter dispatching dialog:

Filter connect.png

All filters are available, and by adding any filters to any channel, the properties of filters and channels selected are displayed and filters are applied in the current measurement:

Warning: Due to bandwidth compatibility, the filters use is exclusive of the plug-in. I.e: Once a filter is associated to a location (ex: a plug-in channel) it can be used on only the same plug-in channels. The front-end is considered a plug-in.

Filters

High-Low pass

Reports Tools Ribbons 373.png: Used to design a high-pass filter or a low-pass filter (Butterworth, elliptic…).

  • Label: the name of the filter (by default High-Low pass n, with 1 <= n <= 4).
  • Type: the type (Low pass or High pass) of the filter.
  • Filter order: filter order from 1 to 6. The higher is the order, the steepest is the cut-off slope.
  • 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, its not possible to share filters between different plug-in.

  • Cut-off frequency: the filter cut-off frequency. Its maximum value is the input frequency range. Its minimum value is: FR / 40 (for a Low pass filter) and FR / 400 (for a High pass filter), 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 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.

  • Label: the name of the filter (by default Pass-Stop band n, with 1 <= n <= 4).
  • Type: the type (Band pass or Band stop) of filter.
  • Filter order: 2, 4, 6, 8 or 10. The higher is the order, the steepest is the cut-off.
  • 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.

  • Low cut-off frequency: the low filter cut-off frequency. Its minimum value is 0.055 * FR, where FR is the input frequency range. However, the following conditions must also be fulfilled:

0.0075 * FR <= B <= 0.5 FR

where B is the bandwidth between Low and high cut-off frequency and FR is the input frequency range.

  • High cut-off frequency: the filter high cut-off frequency. Its maximum value is the input frequency range. However, the following conditions must also be fulfilled: see Low cut-off frequency.
  • 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
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