Difference between revisions of "NVGate Mask And Alarm"

From OROS Wiki
Jump to navigation Jump to search
 
(40 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
[[category:NVGate]]
==Masks & Alarms==
The Masks (also called ''Mask'') are used to compare a measured result with a template.
===Tutorial===
===Tutorial===
The Masks (also called ''Mask'') are used to compare a measured result with a template. Here is an example of a template plotted over the FFT spectrum for three input. <br>
Here is an example of a template plotted over the [[NVGate FFT|FFT spectrum]] for three inputs. <br>


[[Image:Mask4.png|framed|none]]
[[Image:Mask4.png|700px|none]]


This tutorial will show you how to use a mask and a an alarm to start the recording of 3 inputs when the FFT spectrum of the first input cross the mask. To do that, we will need a to use a mask, an alarm and [[NVGate Macro|a macro]]. The setup must contain three input channels [[NVGate_Software_overview#Step_1:_Inputs_selection|connected]] to [[NVGate_Recorder|the recorder]] and the [[NVGate FFT Analyzer|FFT plugins]]. The average spectrum must be displayed. The starting event of the recorder must be set on "Manual Trigger".<br>
This tutorial will show you how to use a mask and an alarm to start the recording of 3 inputs when the FFT spectrum of the first input crosses the mask. To do that, we will need a to use a mask, an alarm and [[NVGate Macro|a macro]]. The setup must contain three input channels [[NVGate_Software_overview#Step_1:_Inputs_selection|connected]] to [[NVGate_Recorder|the recorder]] and the [[NVGate FFT|FFT plugins]]. The average spectrum must be displayed. The starting event of the recorder must be set on "Manual Trigger".<br>




====Setup a mask====
====Setup a mask====


The Mask manager can be found in the "Tools" tab of the NVGate Ribbon :
The Mask group can be found in the "[[NVGate_Ribbons:_Automation|Automation]]" tab of the [[NVGate Ribbons overview|NVGate Ribbon]].
 
[[Image:Ribbon.png|framed|none]]


To create a new mask, select "New" :  
To create a new mask, select "New" :  


[[Image:New.png|framed|none]]
[[File:Mask_new_2022.JPG|700px|none]]


And set the parameters of your mask :
And set the parameters of your mask :


[[Image:Setup.png|framed|none]]
[[Image:Setup.png|350px|none]]
You can then draw the template by adding points with the mouse and adapt the coordinates in the info-trace :
You can then draw the template by adding points with the mouse and adapt the coordinates in the info-trace :
[[Image:Point2.png|framed|none]]
[[Image:Point2.png|framed|none]]


Once you close the window, the mask is then created under the project in the project manager and can be drop into the result graph, here the FFT spectrum :  
Once you close the window, the mask is then created under the project in the [[NVGate Project manager|project manager]] and can be dropped into the result graph, here the [[NVGate FFT|FFT spectrum]] :  
[[Image:Mask+manager2.png|framed|none]]
[[Image:Mask+manager2.png|600px|none]]
 
====Add an Alarm====
====Add an Alarm====
Once you added the mask on the graph, you can create an alarm. The alarm will then allow you to use as an event in a Macro. <br>
Once you added the mask on the graph, you can create an alarm. The alarm will then allow you to use as an event in a [[NVGate Macro|Macro]]. <br>
To create the alarm, select "Add Alarm" from the NVGate ribbon :  
To create the alarm, select "Add Alarm" from the [[NVGate Ribbons overview|NVGate ribbon]] :  
[[Image:AddAlarm.png|framed|none]]
[[File:Alarm_new_2022.JPG|700px|none]]


Then, in the next window, create the alarm between the mask and the selected curves :  
Then, in the next window, create the alarm between the mask and the selected curves :  
[[Image:AddChanelAlarm.png|framed|none]]
[[Image:AddChanelAlarm.png|550px|none]]


====Setup the Macro====
====Setup the Macro====


We will use the If command of [[NVGate Macro|the Macro]] to start the recording on the crossing of the Mask. After creating a macro containing a while loop "Until measurement stopped", add the "If" command inside the loop and set it up as follow :  
We will use the If command of [[NVGate Macro|the Macro]] to start the recording on the crossing of the Mask. After creating a [[NVGate Macro|the Macro]] containing a while loop "Until measurement stopped", add the "If" command inside the loop and set it up as follow :  
[[Image:MaskCross.png|framed|none]]<br>
[[Image:MaskCross.png|700px|none]]<br>


Then, add the "Manual trigger" (by using the record option of the macro) into the If command.
Then, add the "Manual trigger" (by using the record option of the [[NVGate Macro|the Macro]]) into the If command.
[[Image:ManualTrigger2.png|framed|none]]<br>
[[Image:ManualTrigger2.png|400px|none]]<br>


====Conclusion====
====Conclusion====
You can now run the measurement and start the macro : The recording of the signal will began only if the spectrum of the first input cross the mask template.
You can now run the measurement and start the [[NVGate Macro|the Macro]]: the recording of the signal will began only if the spectrum of the first input crosses the mask template.
 
===Mask Parameters===
====Manage====
[[Image:Reports_Tools_Ribbons_156.png|framed|none]]
 
Opens the Mask manager and displays the list of masks classified by project
 
[[Image:Reports_Tools_Ribbons_28.png|framed|none]]


* New: Creates a new mask in the project selected in the list. The "Masks settings" dialog box is displayed, in order to define masks characteristics.
===Masks Group===
Disabled if a template is already being edited.


* Edit: Edits the mask selected in the list.
[[File:Masks_group_2022.JPG|200px]]
See "Frequency narrow band mask settings" topic p 56.


* Rename: Renames the mask selected in the list.
{|border="0" cellspacing="0" cellpadding="4" width="100%" align="center"
* Delete: Deletes the template selected in the list.
|-
=====Save=====
|[[Image:Reports_Tools_Ribbons_156.png|30px|none]]
[[Image:Reports_Tools_Ribbons_157.png]]: Saves the mask loaded in the editor in the current project.
|'''Manage:''' Opens the Mask manager and displays the list of masks classified by project


=====Save As=====
|-
[[Image:Reports_Tools_Ribbons_158.png]]: Saves the mask with a new name in the current project.
|[[Image:Reports_Tools_Ribbons_157.png|20px|none]]
|'''Save:''' Saves the mask loaded in the editor in the current project.


=====New=====
|-
[[Image:Reports_Tools_Ribbons_163.png|framed|none]]
|[[Image:Reports_Tools_Ribbons_158.png|20px|none]]
|'''Save As:''' Saves the mask with a new name in the current project.


Creates a new mask. The "Masks settings" dialog box is displayed, in order to define masks characteristics.
|-valign = "top"
|[[Image:Reports_Tools_Ribbons_163.png|20px|none]]
|'''New:''' Creates a new mask. The "Masks settings" dialog box is displayed, in order to define masks characteristics.


Disabled if a template is already edited.
Disabled if a template is already edited.
Line 84: Line 77:
* Order narrow band (available if one or more synchronous order analysis plug-in analyzer is available)
* Order narrow band (available if one or more synchronous order analysis plug-in analyzer is available)


=====1/n octave mask settings=====
|-valign="top"
|[[Image:Reports_Tools_Ribbons_159.png|30px|none]]
|'''Manage alarms:''' Open a dialog box displaying the list of available alarms.<br><br>
 
[[Image:Reports_Tools_Ribbons_160.png|framed|none]]
 
Select an alarm and click the remove button [[Image:Reports_Tools_Ribbons_161.jpg]] to remove the alarm.
 
|-valign="top"
|[[Image:Reports_Tools_Ribbons_162.png|30px|none]]
|'''Add Alarm:''' Create a new comparison alarm in the active a graphic window. Disabled if the window does not contain a template result and a result coming from a plug-in.
 
|}<br clear="all">
 
===Mask Manager===
 
[[Image:Reports_Tools_Ribbons_28.png|framed|none]]
 
*'''New:''' Creates a new mask in the project selected in the list. The "Masks settings" dialog box is displayed, in order to define masks characteristics.
Disabled if a template is already being edited.
 
*'''Edit:''' Edits the mask selected in the list.
See "Frequency narrow band mask settings" topic p 56.
 
*'''Rename:''' Renames the mask selected in the list.
*'''Delete:''' Deletes the template selected in the list.
 
===Mask settings===
====1/n octave mask settings====


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


======Central frequencies======
=====Central frequencies=====
* Min: Minimum value on X-axis.
* Min: Minimum value on X-axis.
* Max: Maximum value on X-axis.
* Max: Maximum value on X-axis.
Line 100: Line 121:
* 1/24<sup>th</sup> octave
* 1/24<sup>th</sup> octave


======Y axis======
=====Y axis=====
* Min: Minimum value on Y-axis.
* Min: Minimum value on Y-axis.
* Max: Maximum value on Y-axis.
* Max: Maximum value on Y-axis.
* Physical quantity: Physical quantity represented on Y-axis.
* Physical quantity: Physical quantity represented on Y-axis.


=====1/n octave mask editor=====
====1/n octave mask editor====


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


* Select a bar  
* Select a bar [[Image:Reports_Tools_Ribbons_166.png]]: Switches to "Select" mode. Bar is selected by clicking on it. The selected bar can be resized by dragging and dropping.
[[Image:Reports_Tools_Ribbons_166.png|framed|none]]
* Select all bars [[Image:Reports_Tools_Ribbons_167.jpg]]: Selects all bars of mask. All bars can be resized by resizing one of them. The same offset is applied to all bars.
: Switches to "Select" mode. Bar is selected by clicking on it. The selected bar can be resized by dragging and dropping.
* Select all bars  
[[Image:Reports_Tools_Ribbons_167.jpg|framed|none]]
: Selects all bars of mask. All bars can be resized by resizing one of them. The same offset is applied to all bars.


======Graph contextual menu======
======Graph contextual menu======
Line 150: Line 167:
=====Profile mask editor=====
=====Profile mask editor=====


[[Image:Reports_Tools_Ribbons_169.png|framed|none]]
[[Image:Reports_Tools_Ribbons_169.png|700px|none]]


* Add a point [[Image:Reports_Tools_Ribbons_170.jpg]] : Switches to "Add point" mode.  In this mode, a new point is created by clicking in one of the two graph areas. A point with the same X-coordinate is added to the curve of the other graphic area. The Y-coordinate of this point is calculated by linear interpolation between previous and next point.
* Add a point [[Image:Reports_Tools_Ribbons_170.jpg]]: Switches to "Add point" mode.  In this mode, a new point is created by clicking in one of the two graph areas. A point with the same X-coordinate is added to the curve of the other graphic area. The Y-coordinate of this point is calculated by linear interpolation between previous and next point.
* Select a point [[Image:Reports_Tools_Ribbons_171.png]]: Switches to "Select" mode. A point is selected by clicking on it. The selected point can be moved by dragging and dropping. The drop area is bound by the X-coordinates of the next and previous points, and the Y-axis minimum and maximum values.
* Select a point [[Image:Reports_Tools_Ribbons_171.png]]: Switches to "Select" mode. A point is selected by clicking on it. The selected point can be moved by dragging and dropping. The drop area is bound by the X-coordinates of the next and previous points, and the Y-axis minimum and maximum values.
When a point is selected in one of the two curves, the point with same X-coordinate is selected in the other curve. When a point is moved, the point with the same X-coordinate in the other curve is moved also, in order to keep the same X-coordinate.
When a point is selected in one of the two curves, the point with same X-coordinate is selected in the other curve. When a point is moved, the point with the same X-coordinate in the other curve is moved also, in order to keep the same X-coordinate.
Line 158: Line 175:
The two end points can be translated on the Y-axis only. Their X-coordinates are the X-axis minimum and maximum values, respectively.
The two end points can be translated on the Y-axis only. Their X-coordinates are the X-axis minimum and maximum values, respectively.


* Select all points [[Image:Reports_Tools_Ribbons_172.jpg]] : Selects all points on both curves. A curve can be translated on the Y-axis by moving one of its points.
* Select all points [[Image:Reports_Tools_Ribbons_172.jpg]]: Selects all points on both curves. A curve can be translated on the Y-axis by moving one of its points.
* Remove selected point [[Image:Reports_Tools_Ribbons_173.jpg]] : Removes the selected point from both curves. The previous point becomes the new selected point. Not available if all points or one of the end points are selected.
* Remove selected point [[Image:Reports_Tools_Ribbons_173.jpg]]: Removes the selected point from both curves. The previous point becomes the new selected point. Not available if all points or one of the end points are selected.


======Graph contextual menu======
======Graph contextual menu======
Line 185: Line 202:
=====Frequency narrow band mask settings=====
=====Frequency narrow band mask settings=====


[[Image:Reports_Tools_Ribbons_174.png|framed|none]]
[[Image:Reports_Tools_Ribbons_174.png|400px|none]]


======Frequencies======
======Frequencies======
Line 206: Line 223:
[[Image:Reports_Tools_Ribbons_175.png|framed|none]]
[[Image:Reports_Tools_Ribbons_175.png|framed|none]]


* Add a point  
* Add a point [[Image:Reports_Tools_Ribbons_176.jpg]]: Switches to "Add point" mode. In this mode, a new point is created by clicking in the graph area.
[[Image:Reports_Tools_Ribbons_176.jpg|framed|none]]
* Select a point [[Image:Reports_Tools_Ribbons_177.png]]: Switches to "Select" mode. The point is selected by clicking on it. It can be moved by dragging and dropping it. The drop area is limited by the next and previous point X-coordinates, and Y minimum and maximum values. The two end points can be translated on the Y-axis only. Their X-coordinates are the X minimum and maximum values, respectively.
: Switches to "Add point" mode. In this mode, a new point is created by clicking in the graph area.
* Select all points [[Image:Reports_Tools_Ribbons_178.jpg]]: Selects all points of mask. The entire curve can be translated according to the Y-axis by moving one of its points.
* Select a point  
* Remove selected point [[Image:Reports_Tools_Ribbons_179.jpg]]: Removes the selected point. The previous point becomes the new selected point.
[[Image:Reports_Tools_Ribbons_177.png|framed|none]]
: Switches to "Select" mode. The point is selected by clicking on it. It can be moved by dragging and dropping it. The drop area is limited by the next and previous point X-coordinates, and Y minimum and maximum values. The two end points can be translated on the Y-axis only. Their X-coordinates are the X minimum and maximum values, respectively.
* Select all points  
[[Image:Reports_Tools_Ribbons_178.jpg|framed|none]]
: Selects all points of mask. The entire curve can be translated according to the Y-axis by moving one of its points.
* Remove selected point  
[[Image:Reports_Tools_Ribbons_179.jpg|framed|none]]
: Removes the selected point. The previous point becomes the new selected point.
Not available if all points or one of the end points are selected.
Not available if all points or one of the end points are selected.


* Generate min-max mask  
* Generate min-max mask [[Image:Reports_Tools_Ribbons_180.jpg]]: Displays a dialog box used to generate a min-max mask from the mask edited, applying an offset ratio. The min-max mask is made up of two curves: from each point on the mask edited, two points with same X-coordinate are generated, applying the offset ratio negatively and positively on theY-coordinate.
[[Image:Reports_Tools_Ribbons_180.jpg|framed|none]]
: Displays a dialog box used to generate a min-max mask from the mask edited, applying an offset ratio. The min-max mask is made up of two curves: from each point on the mask edited, two points with same X-coordinate are generated, applying the offset ratio negatively and positively on theY-coordinate.


[[Image:Reports_Tools_Ribbons_181.png|framed|none]]
[[Image:Reports_Tools_Ribbons_181.png|framed|none]]
Line 256: Line 263:
[[Image:Reports_Tools_Ribbons_182.png|framed|none]]
[[Image:Reports_Tools_Ribbons_182.png|framed|none]]


* Add a point to top curve  
* Add a point to top curve [[Image:Reports_Tools_Ribbons_183.jpg]]: Switches to "Add point" mode.  In this mode, a point is added to the top curve by clicking in the graph area.
[[Image:Reports_Tools_Ribbons_183.jpg|framed|none]]
* Add a point to bottom curve [[Image:Reports_Tools_Ribbons_184.png]]: Switches to "Add point" mode.  In this mode, a point is added to the bottom curve by clicking in the graph area.
: Switches to "Add point" mode.  In this mode, a point is added to the top curve by clicking in the graph area.
* Select a point [[Image:Reports_Tools_Ribbons_185.png]]: Switches to "Select" mode. A point is selected by clicking on it. The selected point can be moved by dragging and dropping. The drop area is bound by the X-coordinates of the next and previous points, and the Y axis minimum and maximum values. The two end points can be translated on Y axis only. Their X-coordinates are the X-axis minimum and maximum values, respectively.
* Add a point to bottom curve  
* Select all points of top curve [[Image:Reports_Tools_Ribbons_186.jpg]]: Selects all points of the top curve. The entire curve can be translated on the Y axis by moving one of its points.
[[Image:Reports_Tools_Ribbons_184.png|framed|none]]
* Select all points of bottom curve [[Image:Reports_Tools_Ribbons_187.jpg]]: Selects all points of the bottom curve. The entire curve can be translated on the Y-axis by moving one of its points.
: Switches to "Add point" mode.  In this mode, a point is added to the bottom curve by clicking in the graph area.
* Select all points of both curves [[Image:Reports_Tools_Ribbons_188.jpg]]: Selects all points of both curves. Both curves can be translated on the Y-axis by moving one of their points.
* Select a point  
* Remove selected point of top curve [[Image:Reports_Tools_Ribbons_189.jpg]]Removes the selected point of top curve. The previous point becomes the new selected point.
[[Image:Reports_Tools_Ribbons_185.png|framed|none]]
: Switches to "Select" mode. A point is selected by clicking on it. The selected point can be moved by dragging and dropping. The drop area is bound by the X-coordinates of the next and previous points, and the Y axis minimum and maximum values. The two end points can be translated on Y axis only. Their X-coordinates are the X-axis minimum and maximum values, respectively.
* Select all points of top curve  
[[Image:Reports_Tools_Ribbons_186.jpg|framed|none]]
: Selects all points of the top curve. The entire curve can be translated on the Y axis by moving one of its points.
* Select all points of bottom curve  
[[Image:Reports_Tools_Ribbons_187.jpg|framed|none]]
: Selects all points of the bottom curve. The entire curve can be translated on the Y-axis by moving one of its points.
* Select all points of both curves  
[[Image:Reports_Tools_Ribbons_188.jpg|framed|none]]
: Selects all points of both curves. Both curves can be translated on the Y-axis by moving one of their points.
* Remove selected point of top curve  
[[Image:Reports_Tools_Ribbons_189.jpg|framed|none]]
 
Removes the selected point of top curve. The previous point becomes the new selected point.


Not available if all points or one of the end points are selected.
Not available if all points or one of the end points are selected.


* Remove selected point of bottom curve  
* Remove selected point of bottom curve [[Image:Reports_Tools_Ribbons_190.jpg]]: Removes the selected point of bottom curve. The previous point becomes the new selected point.
[[Image:Reports_Tools_Ribbons_190.jpg|framed|none]]
: Removes the selected point of bottom curve. The previous point becomes the new selected point.
Not available if all points or one of the end points are selected.
Not available if all points or one of the end points are selected.


Line 320: Line 310:
=====Order narrow band mask editor=====
=====Order narrow band mask editor=====


[[Image:Reports_Tools_Ribbons_191.png|framed|none]]
[[Image:Reports_Tools_Ribbons_191.png|600px|none]]


* Add a point  
* Add a point [[Image:Reports_Tools_Ribbons_192.jpg]]: Switches to "Add point" mode. In this mode, a new point is created by clicking in the graph area.
[[Image:Reports_Tools_Ribbons_192.jpg|framed|none]]
* Select a point [[Image:Reports_Tools_Ribbons_193.png]]: Switches to "Select" mode. The point is selected by clicking on it. It can be moved by dragging and dropping it. The drop area is limited by the next and previous point X-coordinates, and Y minimum and maximum values. The two end points can be translated on the Y-axis only. Their X-coordinates are the X minimum and maximum values, respectively.
: Switches to "Add point" mode. In this mode, a new point is created by clicking in the graph area.
* Select all points [[Image:Reports_Tools_Ribbons_194.jpg]]: Selects all points of mask. The entire curve can be translated according to the Y-axis by moving one of its points.
* Select a point  
* Remove selected point [[Image:Reports_Tools_Ribbons_195.jpg]]: Removes the selected point. The previous point becomes the new selected point.
[[Image:Reports_Tools_Ribbons_193.png|framed|none]]
: Switches to "Select" mode. The point is selected by clicking on it. It can be moved by dragging and dropping it. The drop area is limited by the next and previous point X-coordinates, and Y minimum and maximum values. The two end points can be translated on the Y-axis only. Their X-coordinates are the X minimum and maximum values, respectively.
* Select all points  
[[Image:Reports_Tools_Ribbons_194.jpg|framed|none]]
: Selects all points of mask. The entire curve can be translated according to the Y-axis by moving one of its points.
* Remove selected point  
[[Image:Reports_Tools_Ribbons_195.jpg|framed|none]]
: Removes the selected point. The previous point becomes the new selected point.
Not available if all points or one of the end points are selected.
Not available if all points or one of the end points are selected.


* Generate min-max mask  
* Generate min-max mask [[Image:Reports_Tools_Ribbons_196.jpg]]: Displays a dialog box used to generate a min-max mask from the mask edited, applying an offset ratio. The min-max mask is made up of two curves: from each point on the mask edited, two points with same X-coordinate are generated, applying the offset ratio negatively and positively on theY-coordinate.
[[Image:Reports_Tools_Ribbons_196.jpg|framed|none]]
: Displays a dialog box used to generate a min-max mask from the mask edited, applying an offset ratio. The min-max mask is made up of two curves: from each point on the mask edited, two points with same X-coordinate are generated, applying the offset ratio negatively and positively on theY-coordinate.


[[Image:Reports_Tools_Ribbons_197.png|framed|none]]
[[Image:Reports_Tools_Ribbons_197.png|framed|none]]
Line 369: Line 349:


The values used in the Excel® sheet must be specified in the current units.
The values used in the Excel® sheet must be specified in the current units.
===Alarm parameters===
=====Manage alarms=====
[[Image:Reports_Tools_Ribbons_159.png|framed|none]]
Opens a dialog box displaying the list of available alarms
[[Image:Reports_Tools_Ribbons_160.png|framed|none]]
Select an alarm and click the remove button
[[Image:Reports_Tools_Ribbons_161.jpg|framed|none]]
to remove the alarm.
=====Add Alarm=====
[[Image:Reports_Tools_Ribbons_162.png|framed|none]]
Create a new comparison alarm in the active a graphic window. Disabled if the window does not contain a template result and a result coming from a plug-in.
Create a new comparison alarm in the active a graphic window. Disabled if the window does not contain a template result and a result coming from a plug-in.

Latest revision as of 08:35, 4 April 2022

The Masks (also called Mask) are used to compare a measured result with a template.

Tutorial

Here is an example of a template plotted over the FFT spectrum for three inputs.

Mask4.png

This tutorial will show you how to use a mask and an alarm to start the recording of 3 inputs when the FFT spectrum of the first input crosses the mask. To do that, we will need a to use a mask, an alarm and a macro. The setup must contain three input channels connected to the recorder and the FFT plugins. The average spectrum must be displayed. The starting event of the recorder must be set on "Manual Trigger".


Setup a mask

The Mask group can be found in the "Automation" tab of the NVGate Ribbon.

To create a new mask, select "New" :

Mask new 2022.JPG

And set the parameters of your mask :

Setup.png

You can then draw the template by adding points with the mouse and adapt the coordinates in the info-trace :

Point2.png

Once you close the window, the mask is then created under the project in the project manager and can be dropped into the result graph, here the FFT spectrum :

Mask+manager2.png

Add an Alarm

Once you added the mask on the graph, you can create an alarm. The alarm will then allow you to use as an event in a Macro.
To create the alarm, select "Add Alarm" from the NVGate ribbon :

Alarm new 2022.JPG

Then, in the next window, create the alarm between the mask and the selected curves :

AddChanelAlarm.png

Setup the Macro

We will use the If command of the Macro to start the recording on the crossing of the Mask. After creating a the Macro containing a while loop "Until measurement stopped", add the "If" command inside the loop and set it up as follow :

MaskCross.png


Then, add the "Manual trigger" (by using the record option of the the Macro) into the If command.

ManualTrigger2.png


Conclusion

You can now run the measurement and start the the Macro: the recording of the signal will began only if the spectrum of the first input crosses the mask template.

Masks Group

Masks group 2022.JPG

Reports Tools Ribbons 156.png
 Manage: Opens the Mask manager and displays the list of masks classified by project
Reports Tools Ribbons 157.png
 Save: Saves the mask loaded in the editor in the current project.
Reports Tools Ribbons 158.png
 Save As: Saves the mask with a new name in the current project.
Reports Tools Ribbons 163.png
 New: Creates a new mask. The "Masks settings" dialog box is displayed, in order to define masks characteristics.

Disabled if a template is already edited.

Template types

Displays the type of the new mask. The different types are

  • 1/n octave (available if 1/n octave plug-in analyzer is available)
  • Profile
  • Frequency narrow band (available if one or more FFT plug-in analyzer is available)
  • Order narrow band (available if one or more synchronous order analysis plug-in analyzer is available)
Reports Tools Ribbons 159.png
 Manage alarms: Open a dialog box displaying the list of available alarms.

Reports Tools Ribbons 160.png

Select an alarm and click the remove button Reports Tools Ribbons 161.jpg to remove the alarm.

Reports Tools Ribbons 162.png
 Add Alarm: Create a new comparison alarm in the active a graphic window. Disabled if the window does not contain a template result and a result coming from a plug-in.


Mask Manager

Reports Tools Ribbons 28.png
  • New: Creates a new mask in the project selected in the list. The "Masks settings" dialog box is displayed, in order to define masks characteristics.

Disabled if a template is already being edited.

  • Edit: Edits the mask selected in the list.

See "Frequency narrow band mask settings" topic p 56.

  • Rename: Renames the mask selected in the list.
  • Delete: Deletes the template selected in the list.

Mask settings

1/n octave mask settings

Reports Tools Ribbons 164.png
Central frequencies
  • Min: Minimum value on X-axis.
  • Max: Maximum value on X-axis.
  • Mode: Defines the number of frequency bands. Available with 1/n octave template result only.

The possible values are

  • Octave
  • 1/3rd octave
  • 1/12th octave
  • 1/24th octave
Y axis
  • Min: Minimum value on Y-axis.
  • Max: Maximum value on Y-axis.
  • Physical quantity: Physical quantity represented on Y-axis.

1/n octave mask editor

Reports Tools Ribbons 165.png
  • Select a bar Reports Tools Ribbons 166.png: Switches to "Select" mode. Bar is selected by clicking on it. The selected bar can be resized by dragging and dropping.
  • Select all bars Reports Tools Ribbons 167.jpg: Selects all bars of mask. All bars can be resized by resizing one of them. The same offset is applied to all bars.
Graph contextual menu
  • Y scale: Switches between linear and dB scale on the Y-axis.
Edit grid
  • Select point: A click on a grid line selects the corresponding point in the graph area.
  • Edit point: You may double-click on a cell to edit the X-coordinate or Y-coordinate of a point.

The Y-coordinate value is bound by the Y minimum and maximum values.

The X-coordinate value is bound by the previous and next point’s X-coordinate.

Clicking on another cell or pressing enter key validates a value.

  • Paste special: The edit grid or a part of the edit grid may be filled by editing the grid content in Excel®, and then copying and pasting from the clipboard.

Only selected cells are updated, if the grid content is valid.

The X-coordinates of the first and last point cannot be edited. The corresponding cells are disabled.

The values used in the Excel® sheet must be specified in the current units.

Profile mask settings
Reports Tools Ribbons 168.png
X axis
  • Min: Minimum value on X-axis.
  • Max: Maximum value on X-axis.
  • Physical quantity: Physical quantity of the reference (represented on X axis).
Y axis
  • Min: Minimum value on Y-axis.
  • Max: Maximum value on Y-axis.
  • Physical quantity: Physical quantity represented on Y-axis.
Profile mask editor
Reports Tools Ribbons 169.png
  • Add a point Reports Tools Ribbons 170.jpg: Switches to "Add point" mode. In this mode, a new point is created by clicking in one of the two graph areas. A point with the same X-coordinate is added to the curve of the other graphic area. The Y-coordinate of this point is calculated by linear interpolation between previous and next point.
  • Select a point Reports Tools Ribbons 171.png: Switches to "Select" mode. A point is selected by clicking on it. The selected point can be moved by dragging and dropping. The drop area is bound by the X-coordinates of the next and previous points, and the Y-axis minimum and maximum values.

When a point is selected in one of the two curves, the point with same X-coordinate is selected in the other curve. When a point is moved, the point with the same X-coordinate in the other curve is moved also, in order to keep the same X-coordinate.

The two end points can be translated on the Y-axis only. Their X-coordinates are the X-axis minimum and maximum values, respectively.

  • Select all points Reports Tools Ribbons 172.jpg: Selects all points on both curves. A curve can be translated on the Y-axis by moving one of its points.
  • Remove selected point Reports Tools Ribbons 173.jpg: Removes the selected point from both curves. The previous point becomes the new selected point. Not available if all points or one of the end points are selected.
Graph contextual menu
  • Add point: Used to add a point by right-clicking on the desired position. A point with the same X-coordinate is added in the other curve. The Y-coordinate of this point is calculated by linear interpolation between previous and next point.
  • Remove point: Used to remove the designated point by right-clicking on it. The point with same X-coordinate is removed from the other curve.

Only available when the user has right-clicked a given point (except end points).

  • Move point: Used to move the designated point by right-clicking on it. A left click in the graph area determines the new position of the point. The point with the same X-coordinate in the other curve is moved also, in order to keep the same X-coordinate
  • Y scale: Switches between linear and dB scale on the Y-axis.
Edit grid
  • Select point: By clicking on a grid line, you may select the corresponding point in the graph area.
  • Edit point: Double-click on a cell to edit the X-coordinate module or phase. A cell can be also edited by selecting it and pressing the enter key.

The module value is bound by the module minimum and maximum values. The phase belongs to the range [-Pi,Pi]. The X-coordinate value is bound by the X-coordinate of the previous and next points.

A value is validated by clicking on another cell or pressing the enter key.

  • Paste special: The edit grid or a part of the edit grid may be filled by editing the grid content in Excel®, and then copying and pasting from the clipboard.

Only selected cells are updated, if the grid content is valid.

The X-coordinates of the first and last point cannot be edited. The corresponding cells are disabled.

The values used in the Excel® sheet must be specified in the current units.

Frequency narrow band mask settings
Reports Tools Ribbons 174.png
Frequencies
  • Min: Minimum value on X-axis.
  • Max: Maximum value on X-axis.
Y axis
  • Min: Minimum value on Y-axis.
  • Max: Maximum value on Y-axis.
  • Physical quantity: Physical quantity represented on Y-axis.
Settings
  • Number of lines: Defines the number of lines.

This setting is particularly usefull to exploit Power Spectrum Density or Energy Spectrum Density

  • Weighting window: defines the used weighting window. This setting is used to use mask in PSD units
Frequency narrow band mask editor
Reports Tools Ribbons 175.png
  • Add a point Reports Tools Ribbons 176.jpg: Switches to "Add point" mode. In this mode, a new point is created by clicking in the graph area.
  • Select a point Reports Tools Ribbons 177.png: Switches to "Select" mode. The point is selected by clicking on it. It can be moved by dragging and dropping it. The drop area is limited by the next and previous point X-coordinates, and Y minimum and maximum values. The two end points can be translated on the Y-axis only. Their X-coordinates are the X minimum and maximum values, respectively.
  • Select all points Reports Tools Ribbons 178.jpg: Selects all points of mask. The entire curve can be translated according to the Y-axis by moving one of its points.
  • Remove selected point Reports Tools Ribbons 179.jpg: Removes the selected point. The previous point becomes the new selected point.

Not available if all points or one of the end points are selected.

  • Generate min-max mask Reports Tools Ribbons 180.jpg: Displays a dialog box used to generate a min-max mask from the mask edited, applying an offset ratio. The min-max mask is made up of two curves: from each point on the mask edited, two points with same X-coordinate are generated, applying the offset ratio negatively and positively on theY-coordinate.
Reports Tools Ribbons 181.png

A click on the OK button changes the mask edited to a min-max mask, which is displayed in the editor (see Min-Max mask editor).

Graph contextual menu
  • Add point: Used to add a point by right-clicking on the desired position.
  • Remove point: Used to remove the designated point by right clicking on it.

Only available when the user has right-clicked a given point (except end points).

  • Move point: Used to move the designated point by right-clicking on it. A left-click in the graph area determines the new position of the point.
  • Y scale: Switches between linear and dB scale on the Y-axis.
Edit grid
  • Select point: Clicking on a grid line selects the corresponding point in the graph area.
  • Edit point: A double-click on a cell is used to edit the X-coordinate or Y-coordinate of a point. A cell can be also edited by selecting it and pressing the enter key.

The Y-coordinate value is limited by the Y minimum and maximum values.

The X-coordinate value is limited by the X-coordinate of the previous and next point.

A value is validated by clicking on another cell or pressing the enter key.

  • Paste special: The edit grid or a part of the edit grid may be filled by editing the grid content in Excel®, and then copying and pasting from the clipboard.

Only selected cells are updated, if the grid content is valid.

The X-coordinates of the first and last point cannot be edited. The corresponding cells are disabled.

The values used in the Excel® sheet must be specified in the current units.

Min-Max mask editor
Reports Tools Ribbons 182.png
  • Add a point to top curve Reports Tools Ribbons 183.jpg: Switches to "Add point" mode. In this mode, a point is added to the top curve by clicking in the graph area.
  • Add a point to bottom curve Reports Tools Ribbons 184.png: Switches to "Add point" mode. In this mode, a point is added to the bottom curve by clicking in the graph area.
  • Select a point Reports Tools Ribbons 185.png: Switches to "Select" mode. A point is selected by clicking on it. The selected point can be moved by dragging and dropping. The drop area is bound by the X-coordinates of the next and previous points, and the Y axis minimum and maximum values. The two end points can be translated on Y axis only. Their X-coordinates are the X-axis minimum and maximum values, respectively.
  • Select all points of top curve Reports Tools Ribbons 186.jpg: Selects all points of the top curve. The entire curve can be translated on the Y axis by moving one of its points.
  • Select all points of bottom curve Reports Tools Ribbons 187.jpg: Selects all points of the bottom curve. The entire curve can be translated on the Y-axis by moving one of its points.
  • Select all points of both curves Reports Tools Ribbons 188.jpg: Selects all points of both curves. Both curves can be translated on the Y-axis by moving one of their points.
  • Remove selected point of top curve Reports Tools Ribbons 189.jpgRemoves the selected point of top curve. The previous point becomes the new selected point.

Not available if all points or one of the end points are selected.

  • Remove selected point of bottom curve Reports Tools Ribbons 190.jpg: Removes the selected point of bottom curve. The previous point becomes the new selected point.

Not available if all points or one of the end points are selected.

Edit grid

The editor contains two edit grids, one for each curve. The top and bottom grid are intended to edit the top and bottom curves, respectively.

  • Select point: By clicking on a grid lines, you may select the corresponding point in the associated curve. A cell can be also edited by selecting it and pressing the enter key.
  • Edit point: You may double-click on a cell to edit the X-coordinate or Y-coordinate of a point.

The Y-coordinate value is bound by the Y minimum and maximum values.

The X-coordinate value is bound by the previous and next point’s X-coordinate.

A value is validated by clicking on another cell or pressing enter key.

  • Paste special: The edit grid or a part of the edit grid may be filled by editing the grid content in Excel®, and then copying and pasting from the clipboard.

Only selected cells are updated, if the grid content is valid.

The X-coordinates of the first and last point cannot be edited. The corresponding cells are disabled.

The values used in the Excel® sheet must be specified in the current units.

Order narrow band mask settings
Reports Tools Ribbons 22.png


Orders
  • Min: Minimum value on X-axis.
  • Max: Maximum value on X-axis.
Y axis
  • Min: Minimum value on Y-axis.
  • Max: Maximum value on Y-axis.
  • Physical quantity: Physical quantity represented on Y-axis.
Order narrow band mask editor
Reports Tools Ribbons 191.png
  • Add a point Reports Tools Ribbons 192.jpg: Switches to "Add point" mode. In this mode, a new point is created by clicking in the graph area.
  • Select a point Reports Tools Ribbons 193.png: Switches to "Select" mode. The point is selected by clicking on it. It can be moved by dragging and dropping it. The drop area is limited by the next and previous point X-coordinates, and Y minimum and maximum values. The two end points can be translated on the Y-axis only. Their X-coordinates are the X minimum and maximum values, respectively.
  • Select all points Reports Tools Ribbons 194.jpg: Selects all points of mask. The entire curve can be translated according to the Y-axis by moving one of its points.
  • Remove selected point Reports Tools Ribbons 195.jpg: Removes the selected point. The previous point becomes the new selected point.

Not available if all points or one of the end points are selected.

  • Generate min-max mask Reports Tools Ribbons 196.jpg: Displays a dialog box used to generate a min-max mask from the mask edited, applying an offset ratio. The min-max mask is made up of two curves: from each point on the mask edited, two points with same X-coordinate are generated, applying the offset ratio negatively and positively on theY-coordinate.
Reports Tools Ribbons 197.png

A click on the OK button changes the mask edited to a min-max mask, which is displayed in the editor (see Min-Max mask editor).

Reports Tools Ribbons 198.png
Graph contextual menu
  • Add point: Used to add a point by right-clicking on the desired position.
  • Remove point: Used to remove the designated point by right clicking on it.

Only available when the user has right-clicked a given point (except end points).

  • Move point: Used to move the designated point by right-clicking on it. A left-click in the graph area determines the new position of the point.
  • Y scale: Switches between linear and dB scale on the Y-axis.
Edit grid
  • Select point: Clicking on a grid line selects the corresponding point in the graph area.
  • Edit point: A double-click on a cell is used to edit the X-coordinate or Y-coordinate of a point. A cell can be also edited by selecting it and pressing the enter key.

The Y-coordinate value is limited by the Y minimum and maximum values.

The X-coordinate value is limited by the X-coordinate of the previous and next point.

A value is validated by clicking on another cell or pressing the enter key.

  • Paste special: The edit grid or a part of the edit grid may be filled by editing the grid content in Excel®, and then copying and pasting from the clipboard.

Only selected cells are updated, if the grid content is valid.

The X-coordinates of the first and last point cannot be edited. The corresponding cells are disabled.

The values used in the Excel® sheet must be specified in the current units. Create a new comparison alarm in the active a graphic window. Disabled if the window does not contain a template result and a result coming from a plug-in.

Retrieved from "https://wiki.oros.com/index.php?title=NVGate_Mask_And_Alarm&oldid=11237"