Difference between revisions of "NVGate Report"

From OROS Wiki
Jump to navigation Jump to search
 
(26 intermediate revisions by the same user not shown)
Line 1: Line 1:
<FONT SIZE = "6">'''REPORTS'''</FONT>
[[category:NVGate]]
 
Powered by the Vision interface and still based on the use of templates, the NVGate reporting toolset focuses on intuitive transfer of analyzer<nowiki>’</nowiki>s data, leaving to MSOffice the page setup and extra content.
 
===Reporting===
This release of NVGate introduces an entirely new reporting mode. Powered by the Vision interface and still based on the use of templates, the NVGate reporting toolset focuses on intuitive transfer of analyzer<nowiki>’</nowiki>s data, leaving to MSOffice the page setup and extra content.


====Overview====
====Overview====
Line 14: Line 11:
* '''Creation''': Format, references and graphics preferences
* '''Creation''': Format, references and graphics preferences


[[Image:Reports_Tools_Ribbons_29.png|framed|none]]
[[Image:Reports_Tools_Ribbons_29.png|700px|none]]
 
==Tutorial==
====Introduction====
=====Objectives:=====
In this tutorial, we will show the basic operations to do a report.
 
Through the different steps of a typical procedure, the useful functions will be described. The report functions are based on the drag and drop of items.
 
=====Equipment=====
* OR3X Analyzer
* PC with NVGate
* Ethernet link
* Microsoft Word/Excel
* 1 signal
You can create a report in On-line mode or in Office mode.
 
====Procedure====
=====Active file=====
First you need to open a new or existing Word/Excel document.
 
In NVGate, go in the Report tab, in the Active File group.
 
[[Image:Usersmanual_179.png|framed|none]]
<br>
Move the mouse over the combo-box. Automatically, the software will check the opened file on the computer and fill up the list. It is then possible to select the working template.<br>
 
[[Image:Usersmanual_180.png|framed|none]]
 
In order to work in the best conditions, position the both windows (NVGate window and Word document) side by side.
 
NVGate items are identified by a tag in the template. The tags are editable in Excel cells, hidden text in Word (apply the [[Image:Usersmanual_181.png]] mode to see the tags).
 
It<nowiki>’</nowiki>s better to work in [[Image:Usersmanual_182.png]] mode while doing the report to avoid any drag and drop inside a tag.
 
=====Deposit NVGate items=====
The reporting operations are based on the use of Drag & Drop; Select an item from NVGate and drop it into the template. The software will add a TAG in the target file and then update it with the corresponding NVGate data.
 
To add a graphical result(s) into a Word document, click on the corresponding window area (grey area), then drag & drop it at the chosen location in the template:
 
[[Image:Usersmanual_183.png|framed|none]]
 
While selecting an OROS Item for reporting, an icon is displayed on the cursor to confirm:
 
* this item is droppable in the report,
* the used format (drop style) in the report
 
[[Image:Usersmanual_184.png|framed|none]]
 
[[Image:Usersmanual_185.png|framed|none]]
 
Obviously, any text, image, table, link can be used in the template to enrich the report with results interpretation, corporate data, and others.
 
We can, for example, create a table in the Word document in order to insert the sensors identification.
 
<u>With tags:</u>
 
[[Image:Usersmanual_186.png|framed|none]]
 
<u>Without tags:</u>
 
[[Image:Usersmanual_187.png|framed|none]]
 
[[Image:Usersmanual_41.png|framed|none]]
 
In addition to the actual measurement setup and result data, a measurement must be identified and detailed by meta-data (project name, measurement name, date, comments and properties.). The References group provides such information to be inserted in the report.
 
Drag and drop these items directly from the group.
 
Select More to see the whole set of properties
 
=====Example of template:=====
In the first lines, the Project name and date were inserted. Then a table with all sensors specifications was added.
 
A drag and drop of the time signal was done. After post-analyzing the time signal, a FFT spectrum was displayed in NVGate and finally dragged and dropped in the template with some FFT settings (frequency range, resolution and number of lines).
 
[[Image:Usersmanual_188.png|700px|none]]
 
[[Image:Usersmanual_189.png|700px|none]]
 
You can also put markers on graphs and display the Marker table by drag and drop from the infotrace.
 
[[Image:Usersmanual_190.png|700px|none]]
 
 
[[Image:Usersmanual_191.png|700px|none]]
 
=====Data format=====
In the Drop Style group, you can define the format of the data in the report file. Indeed, analysis results can be exported as data or graph as well as a setting format includes its name or units.
 
[[Image:Usersmanual_192.png|framed|none]]
 
[[Image:Usersmanual_193.png|framed|none]]
 
'''Note''': advise not to use the '''Active Trace''' or '''All Traces''' for narrow band spectra within Word documents. It leads to a long process into Word.
 
=====Refresh=====
The refresh function is used to update the file.
 
You can resize the graph in the report. Even if the graph seems to be distorted, this is easily solved with the Refresh function.
 


====Printing a report====
====Printing a report====
Line 29: Line 126:
The report templates are built up with the ''Reports'' tab, and then the report generation is available from the ''Measurement ''and ''Reports'' tabs.
The report templates are built up with the ''Reports'' tab, and then the report generation is available from the ''Measurement ''and ''Reports'' tabs.


==Settings==
====Automatic report tools====
====Automatic report tools====
The ''Automatic report ''group is located the left side of the R''eport'' ribbon.
The ''Automatic report ''group is located the left side of the R''eport'' ribbon.
Line 49: Line 147:
[[Image:Reports_Tools_Ribbons_33.png|framed|none]]
[[Image:Reports_Tools_Ribbons_33.png|framed|none]]


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


'''Then''' for each existing ''Layout'',
'''Then''' for each existing ''Layout'',
Line 55: Line 153:
:for each opened ''Window''s, the following page is appended:
:for each opened ''Window''s, the following page is appended:


[[Image:Reports_Tools_Ribbons_35.png|framed|none]]
[[Image:Reports_Tools_Ribbons_35.png|700px|none]]
Print all results (single)
Print all results (single)


Line 142: Line 240:
'''Third, select the measurements to be printed'''. Click on the ''Report/Automatic reports/Measurement batch ''button. The batch report selection dialog is showed (NB: it may take a few second to display if your project manager contains lot of projects/measurements).
'''Third, select the measurements to be printed'''. Click on the ''Report/Automatic reports/Measurement batch ''button. The batch report selection dialog is showed (NB: it may take a few second to display if your project manager contains lot of projects/measurements).


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


This Dialog is divided in 3 areas, one for each input parameters and one for the output files
This Dialog is divided in 3 areas, one for each input parameters and one for the output files
Line 165: Line 263:
It is then possible to make mixed selection from various criteria. The properties are activated/deactivated (i.e. included in the search process) by selecting it with the button at the right of the search text.
It is then possible to make mixed selection from various criteria. The properties are activated/deactivated (i.e. included in the search process) by selecting it with the button at the right of the search text.


[[Image:Reports_Tools_Ribbons_24.jpg|framed|none]]
[[Image:Reports_Tools_Ribbons_24.jpg]]It is also possible to mask/show the properties columns by right clicking on the header. The column order can be changed by drag and dropping one column to its new location.
 
It is also possible to mask/show the properties columns by right clicking on the header. The column order can be changed by drag and dropping one column to its new location.


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


The measurements are sorted by column content (alphanumerical sort) by left clicking on the column header.
The measurements are sorted by column content (alphanumerical sort) by left clicking on the column header.
Line 180: Line 276:
To select the file, move the mouse over the File selection combo-box, the software will check the opened file on the computer a fill up the list. It is then possible to select the working template.
To select the file, move the mouse over the File selection combo-box, the software will check the opened file on the computer a fill up the list. It is then possible to select the working template.


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


Building up a template
Building up a template
Line 231: Line 327:
Most of the information that can be added to a template comes from the NVGate windows and analyzer setting trees (ASB and ASV). Drag & drop the selected Item to the target file in order to add the corresponding tag (and refreshable data) to the template.
Most of the information that can be added to a template comes from the NVGate windows and analyzer setting trees (ASB and ASV). Drag & drop the selected Item to the target file in order to add the corresponding tag (and refreshable data) to the template.


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


====="Drop style" group=====
====="Drop style" group=====
Line 309: Line 405:
[[Image:Reports_Tools_Ribbons_46.png|framed|none]]
[[Image:Reports_Tools_Ribbons_46.png|framed|none]]


======
======Including properties in the reports======
[[Image:Reports_Tools_Ribbons_23.png|framed|none]]
[[Image:Reports_Tools_Ribbons_23.png|framed|none]]


Including properties in the reports======
 
The report toolset of NVGate allows inserting the properties values in the reports.
The report toolset of NVGate allows inserting the properties values in the reports.


Line 343: Line 439:
The basic idea is to increment the position of the results to the next empty row at each report refresh. For such purpose the standard report capabilities now offers an auto-increment row option.  When this setting is activated the drag & drop tag in the report will include the auto-increment.
The basic idea is to increment the position of the results to the next empty row at each report refresh. For such purpose the standard report capabilities now offers an auto-increment row option.  When this setting is activated the drag & drop tag in the report will include the auto-increment.


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


This function works with any item dropped to the Excel report (markers, data, graphs, settings, etc…).
This function works with any item dropped to the Excel report (markers, data, graphs, settings, etc…).
Line 351: Line 447:
The following example fills the test report of an end-winding bump test. The remote control user field settings have been used for measurement identification (blade # & side). A sequence is activated to update these settings for each bump.  A peak marker has been used to collect the frequency and amplitude of each bump test.
The following example fills the test report of an end-winding bump test. The remote control user field settings have been used for measurement identification (blade # & side). A sequence is activated to update these settings for each bump.  A peak marker has been used to collect the frequency and amplitude of each bump test.


[[Image:Reports_Tools_Ribbons_50.png|framed|none]]
[[Image:Reports_Tools_Ribbons_50.png|700px|none]]
 
After masking the report tags, the final report may looks like this:
 
[[Image:Reports_Tools_Ribbons_01.png|framed|none]]


====Refresh report on end of analysis====
====Refresh report on end of analysis====
Line 365: Line 457:
Adding marker or inputs tables in an Excel report is a popular function of the NVGate report mode. It is now possible to define how the NVGate table will be arranged in the Excel sheet.
Adding marker or inputs tables in an Excel report is a popular function of the NVGate report mode. It is now possible to define how the NVGate table will be arranged in the Excel sheet.


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


In the following examples we have 3 FRFs (1 hammer, 1 tri-axis accelerometer) per measurement point.  We measure the highest peak amplitude, frequency and damping ratio on all FRFs at each measurement point.
In the following examples we have 3 FRFs (1 hammer, 1 tri-axis accelerometer) per measurement point.  We measure the highest peak amplitude, frequency and damping ratio on all FRFs at each measurement point.
Line 405: Line 497:


----
----
<font size = "5">'''Tools'''</font>
===Tools===
The NVGate tools are gathered in the Tools tab.
[[Image:Reports_Tools_Ribbons_57.png|framed|none]]
====Macros====
The macro Tab is used to create/manage macros that perform automatically recurrent operations...
[[Image:Reports_Tools_Ribbons_58.png|framed|none]]
=====
[[Image:Reports_Tools_Ribbons_59.png|framed|none]]
Manage=====
Open the macro manager. Display the macro list and the associated hot-keys. A hot-key is a shortcut to run the macro.
[[Image:Reports_Tools_Ribbons_60.png|framed|none]]
Note that the three first hot keys are automatically assigned in the "Macro" menu from the OR38/OR36 Front Panel, labeled as "0", "1" and "2".
* '''Edit: '''Edits the macro selected. Available if no macro is being edited, recorded, or executed.
* '''New: '''Creates a new macro. The new macro is opened in the editor. Available if no macro is being edited, recorded, or executed.
* '''Delete: '''Deletes the macro selected.
* '''Run: '''Runs the macro selected. Available if no macro is being executed.
* '''Properties: '''Edits macro properties (name, read-only flag, and assigned hot-key). Available if no macro is being edited, recorded, or executed.
[[Image:Reports_Tools_Ribbons_61.png|framed|none]]
* '''Name:''' Changes the name of the macro.
* '''Read-only:''' If the macro is read-only, the macro can be loaded to the macro editor but can<nowiki>’</nowiki>t be modified.
* '''Hot key:''' Defines a hot-key to run the macro.
* '''Assigned macro:''' Macro associated with the hot-key selected in "Hot-key" combo-box. If hot-key selected is already assigned, a message is generated when the window is closed, requesting confirmation of the new assignment.
=====
[[Image:Reports_Tools_Ribbons_62.png|framed|none]]
New=====
Creates a new macro and loads it in the macro editor. This menu is disabled if another macro is being edited.
* '''Properties
[[Image:Reports_Tools_Ribbons_63.jpg|framed|none]]
: '''Opens a dialog box intended to edit macro properties. Macro properties consist of a set of parameters of different types, which can be used to define macro command properties.
This command is enabled if the macro item is selected in the macro tree.
[[Image:Reports_Tools_Ribbons_64.png|framed|none]]
* '''Add: '''Defines a new parameter.
[[Image:Reports_Tools_Ribbons_65.png|framed|none]]
* '''Name''': name of the parameter
* '''Type''': type of the parameter. The different types available are
{|border="2" cellspacing="0" cellpadding="4" width="100%"
|'''Type'''
|'''Description'''
|-
|Boolean
|Parameter that can take only 2 values: True or False. This type of parameter is necessary for the MessageBox command to store the answer of the user. The parameter can then be tested in a "If...Then" command.
|-
|File name
|Not used
|-
|Float
|Parameter that can contain a decimal value (1.2, 1.12e6, -0.025, 5,-12387...). It is useful to store constant value that will be used in the macro for test condition ( If...then, While) or for other command (Wait, SetParamerValue ).
|-
|Integer
|Parameter that contains an integer value (5, -1024, 6401). Behavior similar to the float parameter, it can be also used in loop commands ( For loop, periodic loop)
|-
|String
|Parameter that contains a string of character. This type of parameter is useful to store constant string and to create string used by NVGate (Measurement name, Report template) or by commands (MessageBox, Trace). Several commands are dedicated to this string parameters ( MakeString, GetCurrentTime...)
|}
* '''Value''': default value of parameter
* '''Edit: '''Opens the "Parameter properties" dialog box, which is used to edit the parameter selected in parameters list. It is possible to change the name, the type, or the default value of the parameter. If the parameter is used by one or more macro commands, the type can<nowiki>’</nowiki>t be edited (the "Type" combo-box is disabled).
* '''Remove: '''Removes the selected parameter. If the parameter is used by one or more macro commands, the parameter is not removed and an error message is generated.
* '''Delete
[[Image:Reports_Tools_Ribbons_66.jpg|framed|none]]
: '''Deletes the selected command in the macro tree. If the macro selected contains a set of commands (for example a loop command), a dialog box appears in order to confirm command removal. If removal is confirmed, the command and all commands it contains are deleted.
This command is enabled if the macro is not running and it is not read-only.
* '''Run
[[Image:Reports_Tools_Ribbons_67.jpg|framed|none]]
: '''Runs the macro from the current command (indicated by execution pointer) to the next breakpoint. If no breakpoint follows, the execution goes to the end of the macro.
Enable if the macro is not running.
* '''Pause
[[Image:Reports_Tools_Ribbons_68.jpg|framed|none]]
: '''Stops macro execution. The command running is completed, and then execution stops.
This command is enabled when the macro is running only.
* '''Step next
[[Image:Reports_Tools_Ribbons_69.jpg|framed|none]]
: '''Runs current command (indicated by execution pointer).
This command is enabled when the macro is not running.
* '''Reset
[[Image:Reports_Tools_Ribbons_70.jpg|framed|none]]
: '''If the macro is running, stops the execution, and then sets the execution pointer to the first command of the macro.
* '''Record on-line
[[Image:Reports_Tools_Ribbons_71.jpg|framed|none]]
: '''Records commands in the macro. The record on-line mode applies the user actions. The commands corresponding to actions are recorded and inserted in the macro before the selected command.
This command is enabled if the macro is not running and it is not read-only.
* '''Record off-line
[[Image:Reports_Tools_Ribbons_72.jpg|framed|none]]
: '''Records commands in the macro. The record off line mode applies the user actions only when the macro will start. The commands corresponding to actions are recorded and inserted in the macro before the selected command.
This command is enabled if the macro is not running and it is not read-only.
* '''Insert an algorithmic command
[[Image:Reports_Tools_Ribbons_73.jpg|framed|none]]
: '''Inserts an algorithmic command before the selected command.
This command is enabled if the macro is not running and it is not read-only.
* '''Save
[[Image:Reports_Tools_Ribbons_74.jpg|framed|none]]
: '''Saves the macro.
=====
[[Image:Reports_Tools_Ribbons_75.png|framed|none]]
Save=====
Saves the macro currently edited. Only available if a macro is being edited.
=====
[[Image:Reports_Tools_Ribbons_76.png|framed|none]]
Save As=====
Saves the macro currently edited with a new name. Only available if a macro is being edited.
=====
[[Image:Reports_Tools_Ribbons_77.png|framed|none]]
Record=====
Start recording the user action on the software. Each recorded action is appended to the Macro and will be visible ine line in the macro editor.
Prior to start the macro recording user must enter the macro name and the recording mode:
* '''Macro name: '''Name of the macro.
* '''Recording mode:'''
{|border="2" cellspacing="0" cellpadding="4" width="70%"
|'''Mode'''
|'''Description'''
|-
|On-line
|Commands corresponding to user actions are recorded in the macro.
|-
|Off-line
|User actions have no effect. Commands corresponding to user actions are recorded in the macro.
|}
Note: Click on the records button to stop recording the macro. The macro is saved with the name specified in the "Record" dialog.
=====
[[Image:Reports_Tools_Ribbons_78.png|framed|none]]
Pause record=====
Pause the ongoing macro record. User actions are not yet recorded. Available if macro is being recorded.
Useful to prepare the system for an action to be recorded without fulfilling the editor with unwanted lines.
=====
[[Image:Reports_Tools_Ribbons_79.png|framed|none]]
Stop run=====
Stops the execution of the running macro. Available if macro is running
=====Algorithmic commands=====
======Affectation======
[[Image:Reports_Tools_Ribbons_80.png|framed|none]]
Sets a value to a parameter. The new value can be defined by a parameter.
======Break======
[[Image:Reports_Tools_Ribbons_81.png|framed|none]]
Used to exit a loop. It can be used inside a "for" loop to stop before the end of the iteration, inside a "while" loop to exit the loop without fulfilling the condition. It is the only way to exit a "Periodic loop".
======Call Macro======
Calls another macro.
[[Image:Reports_Tools_Ribbons_82.png|framed|none]]
The only parameter is the name of the macro that is called. The body of the command is divided into three steps in order to exchange parameters between the calling macro and the called macro.
======Comment======
The purpose of this command is to facilitate understanding of the macro. It used to add a comment line to the body of the macro.
[[Image:Reports_Tools_Ribbons_83.png|framed|none]]
The only parameter is the comment
======"For" loop======
[[Image:Reports_Tools_Ribbons_84.png|framed|none]]
Runs a set of commands several times. The number of iterations can be defined by an integer value or by an integer parameter.
======Get Current Time======
This command retrieves the time and stores it in a string parameter. This string may be use to send a trace, to create a measurement name...
[[Image:Reports_Tools_Ribbons_85.png|framed|none]]
The "Time format" specifies the way in which the time should be written. "Date", "Time" and "Date and Time" use the regional settings of the host computer while the three other formats are fixed formats.
======Get Macro Parameter======
Gets the value of a parameter of a called macro. This command must be inserted between the "Exit macro" and the "Execute macro" commands, inside the body of the "Call Macro" command.
[[Image:Reports_Tools_Ribbons_86.png|framed|none]]
"Macro parameter" is the parameter of the calling macro that will receive the value of the parameter of the called macro.
"Parameter name" is the name of the parameter in the called macro.
[[Image:Reports_Tools_Ribbons_87.png|framed|none]]
In this example, the command gets the value of the parameter nNumberOfLoop of the macro CheckInput and sets this value to the parameter nCount of the calling macro.
======Group======
The purpose of this command is to facilitate understanding of the macro. It creates a branch that contains a set of instructions. It has no effect during execution, but it helps to organize the macro and facilitates copying and pasting, since all commands are copied at once.
[[Image:Reports_Tools_Ribbons_88.png|framed|none]]
[[Image:Reports_Tools_Ribbons_89.png|framed|none]]
======If…Then…======
[[Image:Reports_Tools_Ribbons_90.png|framed|none]]
Runs a set of commands according to a condition. The condition can depend on an event, status value or parameter. The event condition can be "event x occurred" or "event x not occurred".
There are five types of conditions:
* '''Event: '''The event can be "'''Measurement stopped'''", meaning that the analyzer went from "Running" to "Stopped" or "'''Measurement started'''", meaning the analyzer went from "Stopped" to "Running". This condition is used to wait for the end of a measurement, for instance.
[[Image:Reports_Tools_Ribbons_91.png|framed|none]]
* '''Status: '''All analyzer statuses can be used for this condition. Depending on the type of status, it is possible to compare its value to a list of possible values or perform a logical test ( <nowiki>’</nowiki>=<nowiki>’</nowiki>, <nowiki>’</nowiki>!=<nowiki>’</nowiki>,<nowiki>’<</nowiki>=<nowiki>’</nowiki>,<nowiki>’></nowiki>=<nowiki>’</nowiki>) with a constant or a parameter.
[[Image:Reports_Tools_Ribbons_92.png|framed|none]]
[[Image:Reports_Tools_Ribbons_93.png|framed|none]]
* '''Parameter: '''The macro parameter of can be compared to a constant or to another parameter.
[[Image:Reports_Tools_Ribbons_94.png|framed|none]]
* '''Simple alarm: '''This condition is available only when at least one alarm on a simple template result has been declared.
[[Image:Reports_Tools_Ribbons_95.png|framed|none]]
*
*
*
*
*
* '''Alarm results'''
[[Image:Reports_Tools_Ribbons_96.png|framed|none]]
* '''Advanced alarm: '''This condition is available only when at least one alarm on a double template result has been declared.
[[Image:Reports_Tools_Ribbons_97.png|framed|none]]
* '''Advanced Alarm results'''
[[Image:Reports_Tools_Ribbons_98.png|framed|none]]
{|border="2" cellspacing="0" cellpadding="4" width="100%" align="center"
|'''Operator'''
|'''Test'''
|'''Condition value for 1'''
|'''Condition value for 2'''
|'''Condition value for 3'''
|-
|=
|Above max
|False
|False
|False
|-
|!=
|Above max
|True
|True
|True
|-
|=
|Cross max
|False
|False
|True
|-
|!=
|Cross max
|True
|True
|False
|-
|=
|Between min & max
|False
|False
|False
|-
|!=
|Between min & max
|True
|True
|True
|-
|=
|Cross min
|True
|False
|False
|-
|!=
|Cross min
|False
|True
|True
|-
|=
|Below min
|False
|False
|False
|-
|!=
|Below min
|True
|True
|True
|-
|=
|Cross min & max
|False
|True
|False
|-
|!=
|Cross min & max
|True
|False
|True
|}<br clear="all">
[[Image:Reports_Tools_Ribbons_99.png|framed|none]]
{|border="2" cellspacing="0" cellpadding="4" width="100%" align="center"
|'''Operator'''
|'''Test'''
|'''Condition value for 1'''
|'''Condition value for 2'''
|'''Condition value for 3'''
|-
|=
|Above max
|False
|False
|True
|-
|!=
|Above max
|True
|True
|False
|-
|=
|Cross max
|False
|False
|False
|-
|!=
|Cross max
|True
|True
|True
|-
|=
|Between min & max
|False
|True
|False
|-
|!=
|Between min & max
|True
|False
|True
|-
|=
|Cross min
|False
|False
|False
|-
|!=
|Cross min
|True
|True
|True
|-
|=
|Below min
|True
|False
|False
|-
|!=
|Below min
|False
|True
|True
|-
|=
|Cross min & max
|False
|False
|False
|-
|!=
|Cross min & max
|True
|True
|True
|}<br clear="all">
======Incrementation======
[[Image:Reports_Tools_Ribbons_100.png|framed|none]]
The increment command is used to increment the value of a macro parameter with a given offset.
The "Value" group-box allows defining the offset. The offset can be defined by a value or by a parameter of the same type as the parameter incremented.
Available if one or more integer or float parameter is defined.
======Make String======
Command used to create a string.
[[Image:Reports_Tools_Ribbons_101.png|framed|none]]
"Macro parameter" is the string that is modified. It can only be a String parameter.
"String to add" is the string that is added to the first parameter. It can be a constant or a parameter
"Add to existing string" is a Boolean parameter that indicates if the second parameter replaces or is added to first one. If the value is false, the command behaves like the Affectation command
======Message box======
[[Image:Reports_Tools_Ribbons_102.png|framed|none]]
Displays a dialog box, which is used to change the value of a Boolean parameter. The box is made up of a message and two buttons ("true" and "false"). It is possible to define the box caption, the message content and the button captions. A click on the "true" button sets the Boolean parameter to "true". A click on the "false" button sets the value to "false".
When the command is executed, the box is displayed. A click on one of the buttons closes the message box and sets the Boolean parameter value.
======Periodic loop======
[[Image:Reports_Tools_Ribbons_103.png|framed|none]]
Runs a set of commands at each interval of time specified in the "Time lap" parameter. The time lap is specified in seconds, the "Break" command must be used to exit the loop.
======Set Macro parameter======
Sets the parameter value of a called macro. This command must be inserted between the "Open macro" and the "Execute macro" commands, inside the body of the "Call Macro" command.
[[Image:Reports_Tools_Ribbons_104.png|framed|none]]
"Parameter name" is the name of the parameter in the called macro.
"Parameter value" is the value the parameter must take.
[[Image:Reports_Tools_Ribbons_105.png|framed|none]]
In this example, the command sets the value of the parameter InputNumber of the macro CheckInput to 4.
[[Image:Reports_Tools_Ribbons_106.png|framed|none]]
When the macro is running, a dialog box is displayed, which is used to change the value of a parameter.
[[Image:Reports_Tools_Ribbons_107.png|framed|none]]
The message generated in the top of the dialog box can be defined in the "command properties". A control is used to edit the parameter value. A click on the OK button changes the parameter value, and closes the dialog box. A click on the Cancel button closes the dialog box without changing parameter value.
======Set Parameter Value======
[[Image:Reports_Tools_Ribbons_108.png|framed|none]]
======Trace======
Command used to send a message in the log window.
[[Image:Reports_Tools_Ribbons_109.png|framed|none]]
"Message" is the text that is displayed in the log window.
"Play sound" is used to play a sound when the message is sent. The host computer must have speakers connected.
======Wait======
[[Image:Reports_Tools_Ribbons_110.png|framed|none]]
Waits for a given time. The wait time is specified in seconds.
======"While" loop======
[[Image:Reports_Tools_Ribbons_111.png|framed|none]]
Runs a set of commands several times until the condition is false. The condition can depend on an event, status value or parameter. The event condition can be "event x occurred" or "event x not occurred".
There are five types of conditions:
* '''Event: '''The event can be "'''Measurement stopped'''", meaning that the analyzer went from "Running" to "Stopped" or "'''Measurement started'''", meaning the analyzer went from "Stopped" to "Running". This condition is used to wait for the end of a measurement, for instance.
[[Image:Reports_Tools_Ribbons_112.png|framed|none]]
* '''Status: '''All analyzer statuses can be used for this condition. Depending on the type of status, it is possible to compare its value to a list of possible values or perform a logical test ( <nowiki>’</nowiki>=<nowiki>’</nowiki>, <nowiki>’</nowiki>!=<nowiki>’</nowiki>,<nowiki>’<</nowiki>=<nowiki>’</nowiki>,<nowiki>’></nowiki>=<nowiki>’</nowiki>) with a constant or a parameter.
[[Image:Reports_Tools_Ribbons_113.png|framed|none]]
[[Image:Reports_Tools_Ribbons_114.png|framed|none]]
* '''Parameter: '''The macro parameter of can be compared to a constant or to another parameter.
[[Image:Reports_Tools_Ribbons_115.png|framed|none]]
* '''Simple alarm: '''This condition is available only when at least one alarm on a simple template result has been declared.
[[Image:Reports_Tools_Ribbons_116.png|framed|none]]
[[Image:Reports_Tools_Ribbons_117.png|framed|none]]
* '''Advanced alarm: '''This condition is available only when at least one alarm on a double template result has been declared.
[[Image:Reports_Tools_Ribbons_118.png|framed|none]]
{|border="2" cellspacing="0" cellpadding="4" width="100%" align="center"
|
[[Image:Reports_Tools_Ribbons_119.png|framed|none]]
|
{|border="2" cellspacing="0" cellpadding="4" width="100%"
|'''Operator'''
|'''Test'''
|'''Condition value for 1'''
|'''Condition value for 2'''
|'''Condition value for 3'''
|-
|=
|Above max
|False
|False
|False
|-
|!=
|Above max
|True
|True
|True
|-
|=
|Cross max
|False
|False
|True
|-
|!=
|Cross max
|True
|True
|False
|-
|=
|Between min & max
|False
|False
|False
|-
|!=
|Between min & max
|True
|True
|True
|-
|=
|Cross min
|True
|False
|False
|-
|!=
|Cross min
|False
|True
|True
|-
|=
|Below min
|False
|False
|False
|-
|!=
|Below min
|True
|True
|True
|-
|=
|Cross min & max
|False
|True
|False
|-
|!=
|Cross min & max
|True
|False
|True
|}
|-
|&nbsp;
|&nbsp;
|-
|
[[Image:Reports_Tools_Ribbons_120.png|framed|none]]
|
{|border="2" cellspacing="0" cellpadding="4" width="100%"
|'''Operator'''
|'''Test'''
|'''Condition value for 1'''
|'''Condition value for 2'''
|'''Condition value for 3'''
|-
|=
|Above max
|False
|False
|True
|-
|!=
|Above max
|True
|True
|False
|-
|=
|Cross max
|False
|False
|False
|-
|!=
|Cross max
|True
|True
|True
|-
|=
|Between min & max
|False
|True
|False
|-
|!=
|Between min & max
|True
|False
|True
|-
|=
|Cross min
|False
|False
|False
|-
|!=
|Cross min
|True
|True
|True
|-
|=
|Below min
|True
|False
|False
|-
|!=
|Below min
|False
|True
|True
|-
|=
|Cross min & max
|False
|False
|False
|-
|!=
|Cross min & max
|True
|True
|True
|}
|}<br clear="all">
=====Editor contextual menu=====
======Setting properties======
* '''Cut: '''Removes the command selected and copies it to the clipboard.
* '''Copy: '''Copies the command selected in the clipboard.
* '''Paste: '''Inserts the command stored in the clipboard into the macro. The command will be inserted before the command selected.
If the item selected in the macro tree is an "end of loop" item, the command will be inserted at the end of the loop body.
If the item selected in the macro tree is the "end of macro" item, the command will be inserted at the end of the macro.
* '''Delete: '''Deletes the command selected. Available if the item selected in the macro tree is a command item (not "end of loop" or "end of macro item).
* '''Toggle break point
[[Image:Reports_Tools_Ribbons_121.png|framed|none]]
: '''If a breakpoint is put on the command selected, this command removes it. Otherwise, it sets a breakpoint for this command. Only available if the item selected is a command item.
Breakpoint has been set. This command is not executed.
During macro execution (see Run button), the execution stops on the first command where a toggle break point is placed.
* '''Run to: '''Runs the macro from the current command (indicated by execution pointer) to the selected command, ignoring breakpoints. The selected command is not executed. If the current command is after the selected command, execution goes to the end of the macro, ignoring breakpoints.
* '''Jump to: '''Sets execution pointer to the selected command.
* '''Properties'''
[[Image:Reports_Tools_Ribbons_122.png|framed|none]]
Edits command properties.
====Sequences====
The sequencer is used to import/export/load/view an Excel® file that contains a series of steps. These steps are executed one by one. The sequencer is generally used to operate the Roving hammer impact for modal acquisition, for example.
[[Image:Reports_Tools_Ribbons_123.png|framed|none]]
=====
[[Image:Reports_Tools_Ribbons_124.png|framed|none]]
Manage=====
Opens the Sequence manager and displays the sequences list.
[[Image:Reports_Tools_Ribbons_125.png|framed|none]]
* Import: Imports a sequence from an Excel® file, to create a sequence in NVGate<sup></sup> format. Sequences in NVGate<sup></sup> format are stored in the "Sequence" directory.
Names of sequences in NVGate<sup></sup> format are displayed by the sequence manager.<br>See Source format for more information about sequences in Excel®.
* Export: Exports selected sequence (in NVGate<sup></sup> format) to Excel®.
* Load: Loads selected sequence. Only the loaded sequence can be executed or opened in the sequence viewer to perform a modal analysis.
* View: Opens the selected sequence in the Sequence viewer. Only the loaded sequence can be opened in the viewer.
A Sequence is a set of acquisitions. Each acquisition is a set of setting modifications, and it is associated to a measurement. When a measurement is performed, the acquisition associated with it, is called the current acquisition and is designated by the execution pointer (yellow arrow to the left of the sequence tree). At the end of each measurement, next acquisition becomes current and is executed to prepare the next measurement. When an acquisition is executed, all settings assigned to it are applied.
* Run/Pause
[[Image:Reports_Tools_Ribbons_126.jpg|framed|none]]
: When the sequence is not running, it is launched from the current acquisition. The current acquisition is executed to prepare the measurement.
Note: The Pause button operates at the inverse of the enable button in the sequence group ribbon.
* Reset
[[Image:Reports_Tools_Ribbons_127.jpg|framed|none]]
: Sets the execution pointer (which designates the current acquisition) to the first acquisition of the sequence.
Note: the reset button operates like the reset button in the sequence group ribbon
*
* Back to previous
[[Image:Reports_Tools_Ribbons_128.jpg|framed|none]]
: The acquisition preceding the current acquisition becomes current and is executed.
Disabled if sequence is running.
* Run next
[[Image:Reports_Tools_Ribbons_129.jpg|framed|none]]
: The acquisition following the current acquisition becomes current and is executed.
Disabled if the sequence is running.
Note: Next and previous button operates like the sequence browser arrows in the sequence group ribbon
* Jump to: Accessible by right-clicking on the acquisition. This acquisition becomes current.
* Delete: Deletes the selected acquisition.
* Properties: Edits sequence properties.
[[Image:Reports_Tools_Ribbons_130.png|framed|none]]
When "Run after setup" is checked, a new measurement is launched automatically after the current acquisition is executed.
======Source format======
"Roving hammer test" sequence in Excel®.
[[Image:Reports_Tools_Ribbons_131.png|framed|none]]
"Roving hammer test" sequence in NVGate<sup></sup>
[[Image:Reports_Tools_Ribbons_132.gif|framed|none]]
The first Excel® cell is dedicated to sequence name.
The first column contains the name of acquisitions.
The second column contains, for each acquisition, the key words which identify the NVGate<sup></sup> configuration sub-modules.
[[Image:Reports_Tools_Ribbons_02.png|framed|none]]
Second line is composed of the keywords, which identify the NVGate<sup></sup> configuration<nowiki>’</nowiki>s settings.
They can be found in the ASB.
[[Image:Reports_Tools_Ribbons_133.png|framed|none]]
The column called <nowiki>’</nowiki>Remote Node Label<nowiki>’</nowiki> is the field displayed by the remote controller.
''Menu <nowiki>’</nowiki>Impact<nowiki>’</nowiki> of the remote controller''
These key words in the excel file, should be also defined in the Sequence.ini file which contains alias definitions. An IDNumber is associated to each setting. It can be retrieved from the ASB in NVGate by using shift <nowiki>+</nowiki> right click on the corresponding setting. Settings aliases could be modified by users.
''Part of Sequence.ini file''
Each couple (sub-module key word, setting keyword) designates a specific setting in the NVGate<sup></sup> configuration. The value to assign to this setting is defined in the corresponding cell.
The semicolon character marks the rest of a line as a comment.
=====
[[Image:Reports_Tools_Ribbons_134.png|framed|none]]
Enable=====
Enable/disable the sequence execution. When the loaded sequence is enabled, the steps are executed each time the analyzer finish an acquisition/analysis (i.e: the general status switch to STOP)
=====
[[Image:Reports_Tools_Ribbons_135.png|framed|none]]
Reset=====
Reset the sequence to the initial step, execute it and disable the sequence
=====
[[Image:Reports_Tools_Ribbons_136.png|framed|none]]
Browse=====
Move to the next or previous step in the sequence. Disabled when the sequence is enabled.
=====
[[Image:Reports_Tools_Ribbons_137.png|framed|none]]
Active sequence name=====
Shows the loaded sequence name.
=====
[[Image:Reports_Tools_Ribbons_138.png|framed|none]]
Current step=====
Displays the name of the current step. The current step is the one which has been executed at the last stop.
====Control Panel====
The configurable Workspace area provides quick access to settings and/or ASB status. It looks similar to the "Favorites" in Internet Explorer. The settings can be classified into customizable tabs. Overview
[[Image:Reports_Tools_Ribbons_139.png|framed|none]]
To configure the control panel, right click on the control panel and select Customize Control Panel or use the menu Tools \ Customize Control Panel.
=====Tabs=====
[[Image:Reports_Tools_Ribbons_140.png|framed|none]]
[[Image:Reports_Tools_Ribbons_141.png|framed|none]]
======Setting======
It is possible to create as many setting tabs as wanted. These tabs can contain settings or statuses (max 20).
======Status======
The status area is just above the buttons and is visible whatever a setting tab is selected. It can contain only statuses. Each time a plug-in is connected, the corresponding status bar is automatically added to the control panel.
======Macro======
This tab is dedicated to the "Macro" button.
=====
[[Image:Reports_Tools_Ribbons_142.png|framed|none]]
Customize=====
The left part of the window contains the items that can be added to the control panel. The right part contains the tabs used to receive and organize these items.
[[Image:Reports_Tools_Ribbons_143.png|framed|none]]
* Settings tab: Displays all available settings in tree format similar to the Analyzer Setting Browser. Setting can be added only to the Settings tab.
* Status tab: Displays all available settings in tree format similar to the Analyzer Setting Browser. Status can be added to the Status area or to the Settings tab.
* Macro tab: Displays the list of available macros. Macros can only be added to the Macro tab.
* Add to Control panel
[[Image:Reports_Tools_Ribbons_144.jpg|framed|none]]
: This button adds the item selected (status, setting or macro) from the previous tabs to the control panel
* Remove
[[Image:Reports_Tools_Ribbons_145.jpg|framed|none]]
: Removes the selected item from the control panel.
* Create a new tab
[[Image:Reports_Tools_Ribbons_146.jpg|framed|none]]
: Creates a new tab used to contain settings or status.
* Remove a tab
[[Image:Reports_Tools_Ribbons_147.jpg|framed|none]]
: Removes the selected setting tab.
* Rename a tab
[[Image:Reports_Tools_Ribbons_148.jpg|framed|none]]
: Changes the name of the selected tab.
* Status Area: Displays all statuses that have been selected. The tab can only be used for statuses.
* Macro Tab: Displays all macros that have been selected. The tab can only be used for macros.
* Settings Tab: Displays all settings and statuses that have been selected.
* Push up/down the setting/status
[[Image:Reports_Tools_Ribbons_149.jpg|framed|none]]
[[Image:Reports_Tools_Ribbons_150.jpg|framed|none]]
: Used to change the order of the items in the current tab
Note:
* It is possible to change the name of the settings and status by right-clicking on the item and select Rename in the popup menu
[[Image:Reports_Tools_Ribbons_151.png|framed|none]]
*  It is possible to use drag and drop to add items
=====
[[Image:Reports_Tools_Ribbons_152.png|framed|none]]
Add setting=====
Opens the customize control panel dialog on the Setting tabs.
=====
[[Image:Reports_Tools_Ribbons_153.png|framed|none]]
Add Status=====
Opens the customize control panel dialog on the Status tabs.
=====
[[Image:Reports_Tools_Ribbons_154.png|framed|none]]
Add Macro=====
Opens the customize control panel dialog on the Macro tabs.
====Masks & Alarms====
The Masks (also called ''Mask'') are used to design a template for comparison with a measured result.
[[Image:Reports_Tools_Ribbons_03.png|framed|none]]
[[Image:Reports_Tools_Ribbons_155.png|framed|none]]
=====
[[Image:Reports_Tools_Ribbons_156.png|framed|none]]
Manage=====
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.
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.
=====
[[Image:Reports_Tools_Ribbons_157.png|framed|none]]
Save=====
Saves the mask loaded in the editor in the current project.
=====
[[Image:Reports_Tools_Ribbons_158.png|framed|none]]
Save As=====
Saves the mask with a new name in the current project.
=====
[[Image:Reports_Tools_Ribbons_159.png|framed|none]]
Manage alarms=====
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.
=====
[[Image:Reports_Tools_Ribbons_162.png|framed|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.
=====
[[Image:Reports_Tools_Ribbons_163.png|framed|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.
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)
=====/n octave mask settings=====
[[Image:Reports_Tools_Ribbons_164.png|framed|none]]
======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/3<sup>rd</sup> octave
* 1/12<sup>th</sup> octave
* 1/24<sup>th</sup> octave
======Y axis======
* Min: Minimum value on Y-axis.
* Max: Maximum value on Y-axis.
* Physical quantity: Physical quantity represented on Y-axis.
=====/n octave mask editor=====
[[Image:Reports_Tools_Ribbons_165.png|framed|none]]
* Select a bar
[[Image:Reports_Tools_Ribbons_166.png|framed|none]]
: 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======
* 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<nowiki>’</nowiki>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<sup>®</sup>, 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=====
[[Image:Reports_Tools_Ribbons_168.png|framed|none]]
======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=====
[[Image:Reports_Tools_Ribbons_169.png|framed|none]]
* Add a point
[[Image:Reports_Tools_Ribbons_170.jpg|framed|none]]
: 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|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.
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
[[Image:Reports_Tools_Ribbons_172.jpg|framed|none]]
: 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|framed|none]]
: 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 <nowiki>[</nowiki>-Pi,Pi<nowiki>]</nowiki>. 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<sup>®</sup>, 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=====
[[Image:Reports_Tools_Ribbons_174.png|framed|none]]
======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=====
[[Image:Reports_Tools_Ribbons_175.png|framed|none]]
* Add a point
[[Image:Reports_Tools_Ribbons_176.jpg|framed|none]]
: Switches to "Add point" mode. In this mode, a new point is created by clicking in the graph area.
* Select a 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.
* Generate min-max mask
[[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]]
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<sup>®</sup>, 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======
[[Image:Reports_Tools_Ribbons_182.png|framed|none]]
* Add a point to top curve
[[Image:Reports_Tools_Ribbons_183.jpg|framed|none]]
: 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
[[Image:Reports_Tools_Ribbons_184.png|framed|none]]
: 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
[[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.
* Remove selected point of bottom curve
[[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.
======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<nowiki>’</nowiki>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<sup>®</sup>, 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.
=====
[[Image:Reports_Tools_Ribbons_22.png|framed|none]]
Order narrow band mask settings=====
======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=====
[[Image:Reports_Tools_Ribbons_191.png|framed|none]]
* Add a point
[[Image:Reports_Tools_Ribbons_192.jpg|framed|none]]
: Switches to "Add point" mode. In this mode, a new point is created by clicking in the graph area.
* Select a 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.
* Generate min-max mask
[[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]]
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).
[[Image:Reports_Tools_Ribbons_198.png|framed|none]]
======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<sup>®</sup>, 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.
====Virtual inputs====
This group gives access to the real-time computation between channels.
''See'' ''Chapter 2 ASB - § Sources Virtual inputs for details''
====Link====
This part of the Tools tab provides a link to external software. One a target is selected, each mousse click on the ''Execute'' button launches the target software. As a reminder, the target software can be any executable file from windows (.bat, .exe, shortcuts, etc...). Simply add one target in the c:/OROS/NVGated Data/Links directory and you will be able to use directly for the NVGate interface
.
[[Image:Reports_Tools_Ribbons_199.png|framed|none]]
=====
[[Image:Reports_Tools_Ribbons_200.png|framed|none]]
Select application:=====
Displays the application selected within the list of applications available. All applications must be located in the directory Links.
=====
[[Image:Reports_Tools_Ribbons_201.png|framed|none]]
Execute=====
Runs the selected application.
----
<font size = "5">Ribbons</font>
===Ribbons Overview===
The Vision interface gathers the analyzers functionalities in simple, clear and easy to identify tabs organized according to the main operations (First steps, measuring, results edition, configuration build-up, automation, general setup etc…).
====Graphic user interface====
=====Tabs & Groups=====
The Vision interface layer features 7 standard tabs. Each tab contains a set of groups which gathers settings, info and buttons about one topic (e.g. disk, FFT or transducers).
<font color="#243F60">
[[Image:Reports_Tools_Ribbons_202.png|framed|none]]
</font>=====Actions:=====
The groups contain buttons, setting and check boxes of different types.
* Buttons:  Left click on it lead to an action or open a dialog box.
* Examples:
[[Image:Reports_Tools_Ribbons_203.png|framed|none]]
for auto scale or
[[Image:Reports_Tools_Ribbons_204.png|framed|none]]
for inputs connection
* Status buttons:  These buttons work like the standard ones but they can be activated or de-activated. They are used for changing a state. An activated button is slightly darkened.
* Examples:
[[Image:Reports_Tools_Ribbons_205.png|framed|none]]
that switches between on-line and post-analysis modes,<br> or
[[Image:Reports_Tools_Ribbons_206.png|framed|none]]
for enabling the marker manipulations.
* Settings: Provide a direct access to one of the ASB setting. Allow to continuously check the setup.
* Examples:
[[Image:Reports_Tools_Ribbons_207.png|framed|none]]
* Multi-actions:  These buttons works as the standard ones but it is possible to
select their action from a list.  When an action item is selected from the list, it became the default action of the button, the icon is changed.
[[Image:Reports_Tools_Ribbons_208.png|framed|none]]
Examples are: Marker, or User selection.
*
[[Image:Reports_Tools_Ribbons_04.png|framed|none]]
Status buttons:  These buttons change and show the status of the active element (windows, trace, etc..). Selecting one of the item in their list will apply this status to the active element. The status buttons change depending on the applied changes to the element (or change of element). It is useful to monitor and see immediately in what state is a 3D or the active user for ex.
Note: The buttons are highlighted when the mouse pointer pass over an active button.
=====On line help on Vision ribbons=====
The content of the Vision™ ribbons are connected to the on-line help.
[[Image:Reports_Tools_Ribbons_209.png|framed|none]]
In order to get help from one of the Vision element, activate the help mode by clicking on the upper right question mark. The cursor switches to a pointer <nowiki>+</nowiki> pointer marks. Then click on the desired item. The corresponding page of the reference manual will be opened.
Note that the latest pdf reader software are supported with NVGate V9.00: Acrobat reader 32 or 64 bits and Acrobat and any other pdf reader. The ability to open the manual at the corresponding pages is supported by Adobe™ products only. OROS recommend using acrobat reader using the on-line help functionality.
=====Minimize ribbon and full screen=====
In order to gain space on the NVGate screen during acquisition and analysis the NVGate ribbon can be minimized. It operates like in the MS Office suite:
[[Image:Reports_Tools_Ribbons_210.png|framed|none]]
Use the upper right arrow to minimize or reset the ribbon size. When the ribbon is minimized the tab header remains visible. Their content is accessible by clicking on the corresponding tab header.
The full screen function has been improved. It hides the application top bar as well as the windows bottom bar.
For gaining space, <u>OROS recommend to undock the workspace and to hide it</u> during standard operations. About 99% of the NVGate functions are accessible from the ''Vision™'' ribbons.
[[Image:Reports_Tools_Ribbons_211.png|framed|none]]
=====File Menu=====
A unique "File" menu is available on upper left for input/output file operation. It allows loading/saving setups and provides access to the on-line help
=====Status bar=====
At the bottom of the screen a fixed status bar maintain a continuous monitoring of the inputs and analysis:
[[Image:Reports_Tools_Ribbons_212.png|framed|none]]
===Tabs===
====Operation with Vision====
With Vision the software entries are organized in a logical operations way. There is 7 different tabs corresponding to 3 main operations type:
1. <font size = "4">Measure – Setup – Custom</font>
2. <font size = "4">Measurements</font>
The principal goal the instrument is to measure noise and vibrations. The tabs corresponding to such operations are gathered at the top left of the interface: Home & Measurements.
3. <font size = "4">Setup and fine tuning</font>
This section of the Vision tab offers a clear way to build or modify a measurement or post-analysis configuration. That covers the main steps of a measurement setup. These steps are respectively managed by the Acquisition, Analyses and Display/Graphs tabs.
====The "home" tab====
This first tab features 2 mains services, which are proposed when entering the software (first time and regularly)
* Entering directly in the different modes of the software (start group)
* Set up the general options of the instrument (other groups).
<font color="#243F60">
[[Image:Reports_Tools_Ribbons_213.png|framed|none]]
</font>
=====Start Group=====
This group gathers the entry points for setup selection or building tools as well as the access to the different software modes (measurements editor, post analyze, model load).
[[Image:Reports_Tools_Ribbons_214.png|framed|none]]
*
[[Image:Reports_Tools_Ribbons_215.png|framed|none]]
New… Open the NVGate Start dialog which is dedicated to make the first steps in the software. The start dialog is also displayed at each NVGate Start until the user deactivated the option in the bottom left of the dialog.
It propose 3 tabs, the last selected tab will be active recalling this dialog.
Quick Tab
The quick tab load predefined setups of the instrument for either post-processing or on-line analysis.
The first column (1) is for the channel count selection. Selecting more channels than the actual configuration will not activate non-existing channels.
The second column (2) allows choosing a typical application. Activating the Waterfall check box will enable the gather results in the waterfall.
The third one select on-line acquisition (that run also in the office mode, simulating the inputs signals) or post-processing (a sample signal is provided)
Click on the Go button to load the predefine setup. This setup contains customized items:
* Layouts
* ASB setup
* Control panel
* Macros (called from the control panel)
The mapped directory is the quick directory in the workbook library which is defined in the NVGate Environment paths. Default is: ''C:\OROS\NVGate data\Workbook Library\Quick\.''
Setups name should match one of the user selection combinations:
''AAA_M_W_N''
* AAA is the analysis mode (FFT, REC, ORD, etc..)
* M is the mode: O=On-line, P=Post-analysis
* W is present for the waterfall check box
* N is the number of channels
If the setup corresponding to the user selection does not exist, the "Go" button is disabled
Advanced Tab
This tab works like the quick one except that it shows user defined models. Actually the list maps a directory on the current computer which contains models.
[[Image:Reports_Tools_Ribbons_05.png|framed|none]]
The mapped directory is the advanced directory in the workbook library which is defined in the NVGate Environment paths. Default is: ''C:\OROS\NVGate data\Workbook Library\advanced\.''
After saving a model the model directory can be copied at this location it will be proposed in the advanced tab. A text box is displayed while the mouse passes over the model. The content of this text box (flyover) are entered as the workbook comments prior to save it as a model.
Projects Tab
This tab allows recalling project from the project manager database with a selection of recent projects by selecting "load" and choosing one project in the list
In addition it allows starting the creation of a new setup for either post-analysis or on-line acquisition/analysis.
[[Image:Reports_Tools_Ribbons_20.png|framed|none]]
Select the Create new radio and choose on-line or post-analysis, the press "Go" to start the setup sequence.
*
[[Image:Reports_Tools_Ribbons_216.png|framed|none]]
Connect inputs: allows connecting the front-end signals to the different plug-ins. This is dedicated to on-lien acquisition and analysis.
The inputs signals are connected (i.e: to be processed by.) to the plug-in according to the following table:
{|border="2" cellspacing="0" cellpadding="4" width="90%"
|align = "center"|<br>Type
|align = "center"|Tab
|align = "center"|Compatible analysis plug-ins
|-
|''Dynamic ''
|Inputs, universal inputs (from Inputs tab), torsional, Virtual inputs
|Recorder, Monitor, Virtual inputs, FFTx, SOAx, TDA, OCT, OVA,
|-
|''Parametric''
|DC, CAN, universal inputs (from DC tab), Virtual DC
|Recorder, Waterfall (Reference), Virtual DC
|-
|''High resolution pulses''
|Ext sync
|Recorder
|}
*
[[Image:Reports_Tools_Ribbons_217.png|framed|none]]
Connect Track: allows connecting the player tracks to the different plug-ins. This button replaces the ''Connect inputs'' one in the post analysis mode.
[[Image:Reports_Tools_Ribbons_218.png|framed|none]]
See ''Post-analyze'' command for operation
*
[[Image:Reports_Tools_Ribbons_219.png|framed|none]]
Post-analyze: allows connecting the recorded (or imported) signals as tracks to the different plug-ins for post-processing.
The post analysis button indicates the software mode status:
[[Image:Reports_Tools_Ribbons_220.png|framed|none]]
(Enabled)  indicate NVGate is in the post-processing mode
Clicking on the post-analysis button when it is enabled will switch to the on-line mode. Warning all existing tracks connection will be disabled without possible cancelation. It is recommended to save the current workbook prior to switch to post analysis.
[[Image:Reports_Tools_Ribbons_221.png|framed|none]]
(Disabled) indicates NVGate is in the on-line mode
Clicking on the post-analysis button when it is disabled will switch to the post-processing mode. Warning all existing front-end connection will be disabled without possible cancelation. It is recommended to save the current workbook prior to switch to post analysis.
Click on next to see the signal file selection dialog.
[[Image:Reports_Tools_Ribbons_222.png|framed|none]]
This dialog box shows all available signal files from the project manager data base. Once a signal file is selected, 4 different actions are possible:
*
[[Image:Reports_Tools_Ribbons_06.png|framed|none]]
Preview: Display the signal envelope (overview) in a new windows in the current layout. No analyses neither zoom are possible. Multiple files can be previewed at a time.
* Load in player: This will set the ''Player/Selected record/signal file'' with the current signal file. If the Player ''file'' or ''zoomed signal'' windows are already displayed with another signal file, the content of these windows is updated
* Load & Preview: Operate the Load in Player and display the signal in the Player ''file'' window. If a Player ''file'' or ''Zoomed file ''window is already present in the current layout, the content is updated.
* Post-analyze…: Applies the Load & Preview actions and shows the Track connection Dialog
Track connection dialog
In the post processing mode, the track signals are connected (i.e: to processed by..) to the plug-in according to the following table:
{|border="2" cellspacing="0" cellpadding="4" width="90%"
|align = "center"|Type
|align = "center"|Tab
|align = "center"|Compatible analysis plug-ins
|-
|''Dynamic ''
|Inputs
|Recorder, Monitor, Virtual inputs, FFTx, SOAx, TDA, OCT, OVA,
|-
|''Parametric''
|DC, CAN
|Recorder, Waterfall (Reference), Virtual DC
|-
|''High resolution edges''
|Ext sync
|Recorder, signal Op.
|}
*
[[Image:Reports_Tools_Ribbons_223.png|framed|none]]
Edit Measurement: Load/Unload an existing measurement (i.e. a set of acquired/analyzed data with the measurement setup). The loaded measurement can be modified and saved.
Editing a measurement allow modifying the results presentation (layouts, markers, masks, operators) and saving it in the measurement itself. The modified measurement can then be used for further reporting or for consultation.
The Edit Measurement button indicates the software active layer:
[[Image:Reports_Tools_Ribbons_224.png|framed|none]]
(Enabled)  indicate a measurement is being edited: the layout and windows show the measured data and the ASV (Analyzer Setting Viewer) shows actual setting values at measurement time.
[[Image:Reports_Tools_Ribbons_225.png|framed|none]]
(Disabled)  indicates that no measurement is edited. The current layout and windows show acquisition and/or analysis data.
[[Image:Reports_Tools_Ribbons_226.png|framed|none]]
Load Setup: Load an existing analyzer setup (a workbook or a model)
The available setups may come from the Models or even from existing project workbook. The models are not subject to unexpected modifications (as saving a project with modified settings).
The use of Models is recommended rather than the project ones.
*
[[Image:Reports_Tools_Ribbons_227.png|framed|none]]
Reset Workbook:  Reset entirely the acquisition and analysis setting to their default value.
=====View group=====
Controls for the general interface windows arrangement.
[[Image:Reports_Tools_Ribbons_228.png|framed|none]]
[[Image:Reports_Tools_Ribbons_229.png|framed|none]]
Full screen: Put the active windows in full screen mode. The NVGate frame windows will take the whole screen space. The full screen is inactivated by clicking on it or in reducing the window with the upper right button
[[Image:Reports_Tools_Ribbons_230.jpg|framed|none]]
* Environment windows: These check boxes control the visibility of windows that provide control/command area:
[[Image:Reports_Tools_Ribbons_231.png|framed|none]]
Workspace: show/Hide the workspace windows that contains the Analyzer Setting Browser (ASB), the Project Manager (PM) and the Control Panel (CP).
[[Image:Reports_Tools_Ribbons_232.png|framed|none]]
Only one panel is displayed at a time. The user may switch between panels by clicking on the title bar of the desired sheet.
[[Image:Reports_Tools_Ribbons_233.png|framed|none]]
Log window: This windows track all changes in the analyzer. Logs are arranged in 3 separate tabs:
* ''Analyzer settings:'' Display all users<nowiki>’</nowiki> and dependencies related changes in the ASB.
* ''Warning:'' Displays dynamic warnings related to the current setup (ex A & C acoustic filters are no more available when the sampling frequency is lower than 25.6 kHz). Raising a warning will automatically show the log window during 3 sec.
* ''Macro trace'': log window for macro execution and debugging.
[[Image:Reports_Tools_Ribbons_234.png|framed|none]]
Recommended location: ''Bottom, Docked''
[[Image:Reports_Tools_Ribbons_235.png|framed|none]]
Status: Displays the current status of the plug-ins (''see chapter 1 ASB for details''). General statuses are displayed in the bottom status bar, the Status window is made to show advanced status for accurate control of the acquisition/analyses. To add the statuses in this window, right click in the selected plug-in and select ''View states''
[[Image:Reports_Tools_Ribbons_236.png|framed|none]]
Recommended location: ''Bottom, Docked''
Example for the FFT plug in you may display:
* ''Block Overload:'' corresponds to the instantaneous overload indication within 1 FFT trigger block, for instance during a few milliseconds overload occurred, the current trigger block indicates overload, the following trigger block may not have any overload so indication "no overload" will be seen
* ''Analysis Overload:'' corresponds to overload indication over the measurement period. It means that during the whole measurement period there was (or not) an overload.
For instance: during a measurement, a short overload occurs, Block Overload will indicate "Overload on Channel x", Analysis Overload will indicate "Overload on Channel x", after overload occurred, Block Overload will indicate "No Overload", Analysis Overload will indicate "Overload on Channel x".
When pressing run again, Block Overload and Analysis Overload status will be reset.
When using Automatic overload rejection in FFT, Analysis Overload status take into account any occurring overload despite FFT block rejecting them for FFT calculation, the user will anyhow keep a trace of occurred overload.
These windows can be docked or floating. Environment windows are to be displayed temporarily for advanced setup. It is recommended to hide these windows for standard measurement/analyses.
=====Preferences group=====
These buttons provide direct access to the user<nowiki>’</nowiki>s preferences.
[[Image:Reports_Tools_Ribbons_237.png|framed|none]]
The user<nowiki>’</nowiki>s preferences are gathered in one unique dialog with multiple tabs. It is possible to navigate in these tabs from any of the entry point (the described buttons). See Chapter 7 ''User<nowiki>’</nowiki>s Preferences for details''
*
[[Image:Reports_Tools_Ribbons_238.png|framed|none]]
General: Enter the preferences setting at the 1<sup>st</sup> tab. It allows customizing the scales font size, the refreshing speed as well as default specialized modes
*
[[Image:Reports_Tools_Ribbons_239.png|framed|none]]
Units & Quantities: Open the physical quantity tabs of the user<nowiki>’</nowiki>s preferences. It allows creating, modifying and removing the units and physical quantities used by the NVGate interface.
Reminder: NVGate process SI units. The selected Units with are used for display only, the data are not modified by the units changes.
*
[[Image:Reports_Tools_Ribbons_240.png|framed|none]]
Data Management: Open the measurement properties setup. This tool allows managing the default and user defined properties. These property values are saved with the measurement and used to qualify it. Later, they may be incorporated into reports and for search functions.
=====Disk group=====
PC and Mobi-Disc management tools
[[Image:Reports_Tools_Ribbons_241.png|framed|none]]
*
[[Image:Reports_Tools_Ribbons_242.png|framed|none]]
Active Disk: Select the active disk. The active disk is the one which is mapped by the project manager. The disk where a signal file is located must be the active one in order to load it on the player (play back, post process, exploration).
The active disk can be:
*
[[Image:Reports_Tools_Ribbons_243.png|framed|none]]
The PC one. Available in office mode only.
*
[[Image:Reports_Tools_Ribbons_244.jpg|framed|none]]
One of the Mobi-disk connected through a USB cable. Available in office mode only.
*
[[Image:Reports_Tools_Ribbons_245.jpg|framed|none]]
The Analyzer disk (Mobi-Disk or fixed). Available in connected mode only.
*
[[Image:Reports_Tools_Ribbons_246.png|framed|none]]
Manage: Open the disk manager in order to manage the signal files saved on it. See "Disk management" topic from Chapter 3: "Hardware Management" for details.
*
[[Image:Reports_Tools_Ribbons_247.png|framed|none]]
Format: Format the active disc. Attention all saved data on the formatted disk will be definitely deleted. Not available when PC disk is selected. See "Disk management" topic from Chapter 3: "Hardware Management" for details.
*
[[Image:Reports_Tools_Ribbons_248.png|framed|none]]
Download: Select available signal file on the active disk that match the project present on the project manager. To recover signal files from a record session made with another PC use the manage button. See "Disk management" topic from Chapter 3: "Hardware Management" for details.
=====User group=====
NVGate operates with users<nowiki>’</nowiki> preferences and authorizations. Personalized profiles can be memorized and recalled while starting the software.
A user profile contains:
* Default display preferences (colors, scale type, mode, units, etc..)
* Saving modes (default name, incrementing, confirmation mode, data protection and visibility)
* Waterfall (view, default reference, colors, extractions, filling and type)
* Marker (colors, limits, interpolation)
* Report colors palette
* Units for each physical quantity
* Export modes
* Floating/docked windows location and visibility
The User group allows managing NVGate users<nowiki>’</nowiki> profiles.
*
[[Image:Reports_Tools_Ribbons_249.png|framed|none]]
User button Part 1:  It allows selecting the current user. Attention changing from one user to another one will reset the current NVGate analysis configuration to the default one defined by the new user.
*
[[Image:Reports_Tools_Ribbons_250.png|framed|none]]
User button Part2: It allows creating and deleting users from the active .usr profile files.
* New: Used to create a new user
[[Image:Reports_Tools_Ribbons_251.png|framed|none]]
''First name'': First name of the user may be left empty. The first name is automatically formatted so that the first character is in upper case and the others are in lower case letters.
''Last name'': Last name of the user must be filled in. The last name is automatically formatted in letters.
''Password'': If selected, the user will have to enter his password to launch NVGate<sup></sup>
''Access level''
''-Full'': The user is not limited within NVGate<sup></sup>
''-Restricted:'' The user is not authorized to access to all the functions of NVGate<sup></sup>. The main characteristics of this type of user are:
{|border="2" cellspacing="0" cellpadding="4" width="100%" align="center"
|Authorized actions
|Unauthorized actions
|-
|
* Create measurements
* Modify settings from the Control Panel
* Execute macros from the control panel
* Load projects from a predefined list
* Print reports; Move markers
|
* Save a project
* Close or modify the windows
* Modify the settings in the ASB
* Use the toolbars that have not been authorized by the administrator
|}<br clear="all">
*
[[Image:Reports_Tools_Ribbons_252.png|framed|none]]
Administrator:  Allows Switching to a non-restricted user profile for administration of the current restricted user rights. In this case the current analyzer setup is not modified.
*
[[Image:Reports_Tools_Ribbons_253.png|framed|none]]
Password:  Used to change the password. If necessary, the user must enter his current password and then enter the new password twice
[[Image:Reports_Tools_Ribbons_254.png|framed|none]]
Warning: Due to the GUI modifications, the restricted user profile limitations do not apply on NVGate version 7.00 and further until new notification. It is possible to run NVGate7 with the Legacy V6.00 interface to benefit from the restricted user capabilities. For such purpose runs NVGate7 with the following parameter: ''-legacy''
By default the user is named <nowiki>’</nowiki>Default user". User
The user profiles are saved in a file called ''NVGate.usr'' located in the ''NVGate.exe'' directory. This file is automatically created at NVGate start when it is absent. Attention: deleting the NVGate.usr file delete all users<nowiki>’</nowiki> preferences including the default setting proposed by OROS.
[[Image:Reports_Tools_Ribbons_15.png|framed|none]]
It is possible to temporary change .usr file for special applications. To start NVGate with .usr different from the default one (NVGAte.usr) add the following to the command line: -usr=myfile.
=====Transducer group=====
This group manages the transducers database which is used by NVGate to automatically setup the inputs and trace front-end status at measurement time.
*
[[Image:Reports_Tools_Ribbons_255.png|framed|none]]
Database:  Opens the transducer database dialog
The left side displays all the transducers in the database in a tree form. They are grouped by type. For each type of transducer, there is a default transducer. The right side displays the information about the selected transducer.
[[Image:Reports_Tools_Ribbons_256.png|framed|none]]
*  ''New'': This button is available when a transducer or a transducer type is selected. It is called the "new transducer" dialog box. If a transducer is selected, all information related to the transducer is applied to the new transducer.
* ''New from TEDS file'': This button allows opening a file .ted and so creating a new transducer with its characteristics in the transducers database.
* ''Delete'': This button is not available when a default transducer is selected. It removes the selected transducer from the database.
* ''Modify'': This button is not available when a default transducer is selected. It is used to modify the characteristics of the transducer. Clicking on the modify or new button opens the transducer definition dialog box:
[[Image:Reports_Tools_Ribbons_257.png|framed|none]]
* Transducer type: Can be a pre-defined type (microphone, accelerometer...) or a user-defined type.
- General:
Magnitude, unit: Magnitude and unit associated with the transducer type
Identifier: Name that will be used to identify the transducer. This identifier must be unique. This is the only field that must be filled in. The others contain optional information.
Manufacturer: Name of the company that manufactures the transducer.
Model: Identifies the transducer.
Serial number: Unique identification, this must appear on the transducer itself.
Coupling: When the transducer is connected to an input, this coupling will automatically be set.
- TEDS:
By clicking on Get TEDS, a file .ted can be selected to set automatically the characteristic values of the transducer.
- Factory values: Sensitivity, offset, last calibration.
These values can usually be found on the calibration chart of the transducer. For maintenance calibration, use the update button to set the new values
- Current values: Sensitivity, offset, last calibration.
Displays the current sensitivity and offset. The update button may be used to set new values, in the event the transducer is not calibrated with NVGate<sup></sup>.
The history button is used to retrieve all calibrations that have been performed on the transducer.
- Applied sensitivity:
Factory: applies sensitivity of the calibration chart of the transducer.
Current: applies sensitivity read on the TEDS file of the transducer.
* Comment, transducer description: Free text area
* Conditioner: Has to be change if you use and X-Pod conditioner. The XPod is a device that can be fixed on the OR36<sub>2</sub>/OR38<sub>2</sub> side.
[[Image:Reports_Tools_Ribbons_258.png|framed|none]]
* Type: bridge signal conditioning for strain gauges, dynamic pressure, force and acceleration measurements.
* Gauge type: Full, Half or Quarter bridge mount. The completion resistors are included in the Xpod,
* Resistance: Bridge completion resistor: 120 or 350 Ohms for quarter bridge mount.
* Gain: Bridge gain: 10 or 100 depending on the required precision and range.
* Max current: the provided current can be limited to 30 mA up to 4 V and 12 mA up to 10 V.
* Excitation voltage: Each Xpod provides an excitation voltage from 0 to 10 V.
* Offset Comp.: Bridge offset comp: Can be used for manual balance of the bridge,
* New Transducer Type: This button is available when a transducer type is selected. A new transducer type is necessary when the pre-defined type does not fit the needs. It is used to gather transducers with the same magnitude.
[[Image:Reports_Tools_Ribbons_259.png|framed|none]]
* Magnitude: Magnitude that will be associated with the transducer type and all transducers of this type.
* Name: This name will be used to identify the type. It must be unique.
* Unit: Current unit of the magnitude.
* Default coupling: default coupling value that will be used when a new transducer is created. This value can be changed individually.
* Comment: Free text area
*
[[Image:Reports_Tools_Ribbons_260.png|framed|none]]
History:
This tool is used to see how transducer sensitivity and offset change over time. Information about every calibration is displayed, making it easy for the user to see if the transducer behavior is constant.
* Current sensitivity: This is the sensitivity level obtained during the last calibration. If the transducer has never been calibrated, the factory sensitivity is selected. This sensitivity is used when the transducer is selected on an input
* Current offset: This is the offset obtained during the last calibration. If the transducer has never been calibrated, the offset sensitivity is selected. This offset is used when the transducer is selected on an input
* Graph: Displays the calibration values. A pop-up menu is available by right clicking on the graph.
[[Image:Reports_Tools_Ribbons_261.png|framed|none]]
It is used to select the sensitivity graph, the offset graph or both. It is also possible to hide/display the factory values. There is also a marker to highlight the calibration.
*
[[Image:Reports_Tools_Ribbons_262.png|framed|none]]
Merge  multiple transducer databases into one. The merged TDB is the one currently used by NVGate (file: ''transducers.tdb'' located in the ''NVGate.exe'' directory)
Clicking on ''Merge'' open the database to merge browser. Both native (.cdb) and comma separated values (.txt) formats are available. For the csv, the format is the same as the export one, with one line per transducer.
In case of conflict (the same transducer does not features the same setup in the 2 databases) a specific dialog box is proposed.
[[Image:Reports_Tools_Ribbons_263.png|framed|none]]
Only conflict lines are displayed.
* On the left side the current NVGate<sup>®</sup> database called ''Mine''
* On the right side the imported one called ''Theirs''
The non-matching settings are written in red, and the current choice (the one which will be saved) is shown on a green background. The default choice is to save the current NVGate<sup>®</sup> settings (''Mine).''
The operator may apply 3 types of operations, selected by a right click on the line of interest:
* ''Use mine: ''The current NVGate<sup>®</sup> setting is kept. The calibration histories from the imported and current database'' ''are merged.
* ''Use theirs:'' The imported setting will be applied and saved. The calibration histories from the imported and current database'' ''are merged.
* ''Do nothing: '' The corresponding transducer is ignored and nothing is changed
At the end of the merge operation a summary of the modification is presented
[[Image:Reports_Tools_Ribbons_264.png|framed|none]]
*
[[Image:Reports_Tools_Ribbons_265.png|framed|none]]
Export:  Allows exporting the current database (file: ''transducers.tdb'' located in the ''NVGate.exe'' directory) in csv format.
The exported file contains one line per transducer with the following field.
[[Image:Reports_Tools_Ribbons_266.png|framed|none]]
Only the latest site calibration information are exported in the txt file.
=====
[[Image:Reports_Tools_Ribbons_07.png|framed|none]]
D-Rec group=====
This group manages D-rec (Direct recording) setups. D-rec allows recording signals with the analyzer without any PC or connection.
*
[[Image:Reports_Tools_Ribbons_267.png|framed|none]]
New'':''  Create a new recording configuration and save it in the analyzer memory.
From this button, NVGate will propose a set of dialog boxes that guide the user through the necessary settings to build a D-rec setup. The displayed dialogs are the following:
1. Channels connection
2. Event connections
3. Recorder properties
4. Records setup management
Item #1 and #3 are exactly the same as the standard ASB dialogs for the channels connection and the recorder setup.
Item #2 is also the same but only a subset of the events is handled by D-rec: Recorder trigger on Edge on Ext. synch, Level and delta level on DC inputs and periodic event only.
Item #4 allows managing the setups saved in the analyzer. (See ''Setup'' below for details)
*
[[Image:Reports_Tools_Ribbons_268.png|framed|none]]
Setup:  Manages the D-rec Setups through the following dialog box. The D-rec setups can be written, removed, imported and exported from this dialog box.
To write an NVGate configuration in the hardware, press the "Add current setup" button. The current front-end and recorder settings will be saved in the analyzer. Note that all active channels (IN, DC, EXT and CAN) will automatically be connected to the recorder tracks.
The Delete button removes definitely the selected setup(s) from the analyzer memory".
One of the D-rec setups saved in the analyzer can be set as the default setup when starting the D-rec. Check it in the "Default" column. The default setup is loaded when the operator
Each setup can be exported in text file to be used as a reference of the D-rec settings when using it on-site to match the transducers and cables. To create a description file, use the "Export as txt" button.
It is possible to recover, control or modify an existing D-rec setup which is already saved in the analyzer. The "Import in ASB" function will overwrite the current ASB with the configuration saved in the analyzer.
====The "Measurement" tab====
This tab is dedicated to be used during measurement time, featuring useful tools used during this step. This tab occurs naturally after the ''Home'' one and its ''Start'' group.
[[Image:Reports_Tools_Ribbons_269.png|framed|none]]
The measurement tab offers powerful controls and commands for:
* Monitoring Traces, Windows and Layouts scanner to keep an eye on any signal and analysis results
* Recording with arming and target selection (off, on analyzer, on PC)
* Front-end control, with an easy access to Check ICP, Check TEDS, Calibration, Bridge balance and the sampling frequency control
* Saving data with trace memorization, saved result selection and print report buttons.
=====Control group=====
These settings control the general analyzer status and the recorder activity
[[Image:Reports_Tools_Ribbons_270.gif|framed|none]]
*
[[Image:Reports_Tools_Ribbons_271.png|framed|none]]
Run:  (CTRL<nowiki>+</nowiki>R) This button control the general analysis and recording start. The plug-in with connected channels/tracks will start their process one the run is activated.
Note: The monitor and the Time Domain Analysis (in free run mode) process is continuous; it do not depends on the run status.
Note: the trigger/start status of the plug-ins may block their process, waiting for an event.
[[Image:Reports_Tools_Ribbons_08.png|framed|none]]
Warning: Pressing the run button during an analysis lead to reset all current analyses, restarting all averages from 0. The analyzed data will be lost.
*
[[Image:Reports_Tools_Ribbons_272.png|framed|none]]
Pause:  (Pause): Suspend or un-suspend the current analysis.
Note: If the recorder is running, its starts / finishes a record.
*
[[Image:Reports_Tools_Ribbons_273.png|framed|none]]
Stop:  (CTRL<nowiki>+</nowiki>S) Stops all the current analyses and recording.
After requesting a stop, the plug-ins finished their current block. When all the plug-ins has switched to'' Stopped'' the analyzer switch to the Stopped status
Note: The analyzed results and recorded signal are saved when the analyzer switch to stop. This is the default behavior. It may be changed from the user preferences (see user preferences chapter)
Note that another Run/Pause/Stop button is always available in the status bar (bottom left)
*
[[Image:Reports_Tools_Ribbons_274.png|framed|none]]
Arm:  (CTRL<nowiki>+</nowiki>SHIFT<nowiki>+</nowiki>R) Arm the recorder. Prepare the recorder to start immediately on the run. Arming process can lap a few seconds.
Note: modifying a setting of the analyzer will disable the arming. It is then necessary to re-arm it.
If the recorder is not armed, it will take a few second to achieve the arming prior to effectively start recording the data.
* Note: the recoer can be armed from the ASB: (Recorder /Trigger/ Recorder) ''See Chapter 1 ASB - § Recorder/Trigger settings for details.''
*
[[Image:Reports_Tools_Ribbons_275.png|framed|none]]
Manual trigger:  (CTRL<nowiki>+</nowiki>T) generate a manual trigger event. This event is available for the event list and can be associated to the plug-in triggers (start/stop or trigger). See acquisition tab description.
Warning: While the manual trigger is not associated to a plug-in, it has no effect.
*
[[Image:Reports_Tools_Ribbons_276.png|framed|none]]
Record status: Controls the recorder location and activity.
* If the setting is set to Off, the icon is grayed
[[Image:Reports_Tools_Ribbons_277.png|framed|none]]
* If the setting is set to PC, the data are recorded on the PC HDD
* If the setting is set to Analyzer
*
[[Image:Reports_Tools_Ribbons_278.gif|framed|none]]
Record mark: Allow adding a mark with comments while recording. These marks are available when the signal file is edited.
=====Front-end group=====
Control/command of the general acquisition setup.
*
[[Image:Reports_Tools_Ribbons_279.png|framed|none]]
Auto-range (CTRL<nowiki>+</nowiki>SHIFT<nowiki>+</nowiki>A). Controls and start the auto-ranging procedure. ''See Chapter 1 ASB § Front-end/Auto-range for details''
*
[[Image:Reports_Tools_Ribbons_280.png|framed|none]]
Check ICP: Checks if an ICP transducer is correctly connected to each input for which the coupling is set to ICP. It measure the DC polarization voltage through time averaging and opens a window with the results:
* Short circuit: DC voltage <nowiki><</nowiki> 4V (the sensor may be faulty)
* ICP detected: DC voltage between 4V and 20V (an ICP sensor is detected)
* No connection: DC voltage <nowiki>></nowiki> 20V (no ICP sensor is detected), open circuit
* Un-stabilized input: DC voltage was not stabilized after 40 s.
''See Chapter 1 ASB - § front-end/inputs settings for details.''
*
[[Image:Reports_Tools_Ribbons_281.png|framed|none]]
Bridge auto-zero: Balance the inputs connected through the Wheatstone bridge Xpod. ''See Chapter 1 ASB - § front-end/inputs settings for details.''
*
[[Image:Reports_Tools_Ribbons_282.png|framed|none]]
Control/command the Front-end sampling frequency.
Note: The plug-in analyzer and the recorder can reduce respective their bandwidths independently. This setting fixes the acquisition time accuracy and fixes the max signal bandwidth. ''See Chapter 1 ASB - § front-end/inputs settings for details.''
=====Save group=====
Manages the results and signal saving and allows direct report generation.
[[Image:Reports_Tools_Ribbons_283.png|framed|none]]
*
[[Image:Reports_Tools_Ribbons_284.png|framed|none]]
Print Report. This button refreshes the content of the active report document (Word or Excel) and prints it to the default printer.  ''See Chapter 5 Report & tools § Reporting for details.''
*
[[Image:Reports_Tools_Ribbons_285.png|framed|none]]
Save setup: Defines the way the result and signal are saved. It opens the ''Save setup'' dialog which contains 2 tabs.
<u>''Save setup tab:''</u>
[[Image:Reports_Tools_Ribbons_09.png|framed|none]]
* ''B''
* ''Base name'': The name the new measurement will have. A suffix is automatically added to the name if the specified name is already in use.
* ''Names from sequence'': Select this option to link the measurement name to the corresponding sequence fields of the sequence currently in use.
See also "Sequence" topic from Chapter 5: Reports & Tools.
* ''Native format'': Determines whether the measurement should be saved in OR3x format. If not selected, the new measurement will not appear in the project manager.
* ''Export format'': Used to export the new measurement in an external format. A folder must be specified to receive the converted result.
See more details about the export formats in the "Export" topic from the "Chapter 7: User preferences".
* ''Auto-increment:'' Used to insure the new measurement has a unique name.
{|border="2" cellspacing="0" cellpadding="4" width="100%"
|''Number''
|Adds a number to the Base name. The first available increment is used
|-
|''Date''
|Adds date information to the Base name. The date format is ''dd-mm-yyyy'' ''hh<nowiki>’</nowiki>mm''<nowiki>’</nowiki>''ss''" or mm-dd-yy ''hh<nowiki>’</nowiki>mm''<nowiki>’</nowiki>''ss '' according to the regional settings of the PC
|}
* ''Save option'': This option determines the way in which the measurement will be created when the analyzer stops
{|border="2" cellspacing="0" cellpadding="4" width="100%"
|''Do not save''
|No measurement will be created. The only way to save the results selected is to perform the Save Result command manually
|-
|''In default measurement''
|The measurement is created with the name "Default measurement". If a measurement with this name already exists, it is overwritten.
|-
|''With name confirmation''
|A dialog box will be displayed when the analyzer stops. It will suggest a name using a Base name and an auto increment choice.
|-
|''Without name confirmation''
|The measurement is created with a name automatically generated from the Base name and the auto increment choice.
|}
* ''Default keyword'': Used to choose the keyword that will be associated with the new measurement. Refer to the preference section for more information.
* ''Saved Results''
* Current Analysis result: Results obtained from an acquisition.
* End of acquisition: open automatically a dialog box to save the results when the analyzer stops.
* Manually: allow to save the results manually.
* Working results: Results obtained after an operation based on already saved analysis results, for example a result calculated with an operator.
These results can be only saved manually.
<u>''Save selection tab:''</u>
[[Image:Reports_Tools_Ribbons_286.png|framed|none]]
''Results provided by the plug-ins''
* ''Result selection'': List of results provided by the plug-in analyzer selected. Multiple plug-ins may be selected if all results selected are compatible (which means that they can be displayed in the same result window).
* ''Channel selection'': List of plug-in analyzer channels connected, available for the result selected.
* ''Operation'': in the top combo-box, list of weighting that can be applied to results selected. In the middle combo-box, list of derivation/integration operations which can be applied. In the bottom combo-box, list of display units.
* ''Reference / X'': List of plug-in analyzer channels connected. This can be the reference. Available for results that require a reference only (cross-spectrum, for example).
* ''Tracked order'':  List of tracked orders on channel selected. Available if result selected is an order result.
* ''Traces''
[[Image:Reports_Tools_Ribbons_287.png|framed|none]]
List of traces available in the project coming from current analysis results and working results.
*
[[Image:Reports_Tools_Ribbons_288.png|framed|none]]
Save measurement: : Save the result and signal.
The result/signal can be saved when:
* There is at least one result selected in the save selection,
* The analyzer is stopped
* The results exists
By default the save measurement displays the following confirmation window.
The ''Save Measurement ''dialog will show the visible properties with their suggected values:
[[Image:Reports_Tools_Ribbons_289.gif|framed|none]]
This dialog box allows entering:
* the measurement name to identify your data
* An associated keyword that allows filtering the project manager
* User<nowiki>’</nowiki>s comments (Use the CTRL<nowiki>+</nowiki>Enter to add lines)
In Addition, the measurement can be informed with properties which are used to help retrieving the files and their meaning.
The properties are attached to the measurement and filled while saving the data or by editing the properties from the project manager. The properties belong to 3 different categories:
* The OROS properties are automatically filled by NVGate: Date, Author, Protection, Project name, Signal location and Number and type of saved results.
* The OROS user properties are already created by NVGate. Their values, but must be filled by the operator: Comments, Site, Installation, Intervention, UUT, Serial number, Measurement type and Default type
* The Users parameters are created and filled by the operator while saving or by editing the properties. Ex: ''TestCampaign'', ''R&DProject'' or ''Customer name''. Users parameters can be predefined from the ribbon: ''Measurement/Preferences/Measurement Properties''
Note that ''users<nowiki>’</nowiki> properties will pollinate''. It means the new properties type will be automatically added on the future measurements. The same occurs if you import or copy a measurement which contains unknown users<nowiki>’</nowiki> properties.
The OROS User properties easily cover a wide range of situations. Especially the fourth following items:
* Site is for the location of the measurement. It can be a ship, a test track, a test cell, an aircraft or a factory.
* Installation is for the tested machinery. It can be a diesel engine, a car, a jet engine, a pump, a machine tool, etc…
* Intervention describes the type of acquisition/analysis: qualification, overhaul check, prototyping, diagnostic, routine data collection, first run, etc…
* Unit Under Test (UUT) indicates precisely which part is tested: a tire, a bearing, a transmission, etc…
* Measurement type:  Describes the type of measuring; Acoustic, diagnostic, rotating, etc..
* Default (or Defect): The identified defect on the UUT.
Managing properties
To enter the property values, click on the right cell of the corresponding line and add text.
To remove a property from the measurement, use the cross on the right side of the corresponding line.
To add a property fill the bottom left cell with the property name and use the tab or click on the right cell to enter its value.
By right clicking on the property line you can hide it or change the suggestion mode. In order to save your entered values from one measurement to the next one, select ''Same as previous. '' ''Same as today'' will reset the suggestion as soon as the date of the latest saved measurement is different from current day.
Note: Measurement<nowiki>’</nowiki>s properties can be edited from the ''Project Manager'' by right clicking on the desired measurement.
*
[[Image:Reports_Tools_Ribbons_290.png|framed|none]]
Memorize trace  (Ins): Creates an instant copy of the active trace in the active window.'' ''The memorized trace add incrementally traces called ''Memx'' in the current window
[[Image:Reports_Tools_Ribbons_291.png|framed|none]]
<br>These memorized traces can be added to the save selection using the "add to result selection" entry of the window contextual menu.
''See chapter 2 Display - § Window menu for details''
=====
[[Image:Reports_Tools_Ribbons_16.png|framed|none]]
Graphs group=====
The graph group purpose is to navigate (i.e. scan) all existing displays and to provide basic scaling tools.
* ''
[[Image:Reports_Tools_Ribbons_292.png|framed|none]]
Type ''
[[Image:Reports_Tools_Ribbons_293.png|framed|none]]
Browsers : Allows browsing in the Traces, Windows or Layouts. Depending on the pressed arrow (left or right) the item will be scanned in different side.
* ''Traces''  (up/down key), the positive scan is the creation order (from the oldest to the latest added traces in a window).
* ''Windows''  (CTRL<nowiki>+</nowiki>TAB) the positive scan is the inverse of the focus (from the latest to the oldest clicked/activated).
* ''Layouts''  (CTRL<nowiki>+</nowiki>SHIFT<nowiki>+</nowiki>SPACE ), the positive scan is the creation one (from the oldest to the latest created Layouts ).
*
[[Image:Reports_Tools_Ribbons_294.png|framed|none]]
Auto-scale (CTRL<nowiki>+</nowiki>A) :  Adjust the Y scale of all the windows in the current layout. The scales are adjusted to the largest trace amplitude (min and max) in each graph. '' ''A 10% margin is added to these values to facilitate visibility.
Note: The minimum Y scale width cannot be lower than the active signal precision.
*
[[Image:Reports_Tools_Ribbons_295.png|framed|none]]
Cursor selection : Select the mouse mode (i.e. the cursor type).
[[Image:Reports_Tools_Ribbons_296.png|framed|none]]
''Scale mode'' (CTRL<nowiki>+</nowiki>F5)  This mode is used to modify scales using in the mouse graph, by moving the cursor on the scale. The cursor shape changes depending on the position of the mouse on the scale. Use the mouse wheel or the Up/Down arrows to change the scale value. If the Ctrl key is pressed, the changes are five times smaller, for more precise adjustment of the value modified.
{|border="2" cellspacing="0" cellpadding="4" width="100%" align="center"
|Mouse cursor
|Position on the scale and action
|-
|
[[Image:Reports_Tools_Ribbons_297.png|framed|none]]
,
[[Image:Reports_Tools_Ribbons_298.png|framed|none]]
|On the lower left part of the scale. Only the minimum value of the scale is modified.
|-
|
[[Image:Reports_Tools_Ribbons_299.png|framed|none]]
,
[[Image:Reports_Tools_Ribbons_300.png|framed|none]]
|On the upper right part of the scale. Only the maximum value of the scale is modified.
|-
|
[[Image:Reports_Tools_Ribbons_301.png|framed|none]]
,
[[Image:Reports_Tools_Ribbons_302.png|framed|none]]
|On the center of the scale. Both minimum and maximum values are modified, in the same direction. This performs  a translation of the scale
|-
|
[[Image:Reports_Tools_Ribbons_303.png|framed|none]]
,
[[Image:Reports_Tools_Ribbons_304.png|framed|none]]
|On the center of the scale, with Shift key pressed. Both minimum and maximum values are modified, in the opposite direction. This zooms in/out.
|}<br clear="all">
[[Image:Reports_Tools_Ribbons_305.png|framed|none]]
''Zoom mode ''(CTRL<nowiki>+</nowiki>F6)'':''  In this mode, left-click drag using the mouse in order to draw a rectangle to zoom into. When the left-button is released, the displayed area corresponds to the area defined by the rectangle.
If the size of the rectangle is smaller than the active signal precision displayed in the window, the zoom is not completed.
[[Image:Reports_Tools_Ribbons_306.png|framed|none]]
''Cursor mode ''(CTRL<nowiki>+</nowiki>F7):  In this mode, left-click on the cursor and drag it using the mouse in order to move it.
[[Image:Reports_Tools_Ribbons_307.png|framed|none]]
''Move mode ''(CTRL<nowiki>+</nowiki>F8):  In this mode, left click on the window and use the mouse to drag.
[[Image:Reports_Tools_Ribbons_308.png|framed|none]]
''Rotate ''(CTRL<nowiki>+</nowiki>F9)'':''  In this mode, left-click on a 3D window and drag using the mouse to, change the orientation of the view. Left-right mouse dragging rotates the view around the Y-axis, top-bottom dragging around the X-axis.
''
[[Image:Reports_Tools_Ribbons_309.png|framed|none]]
Marker mode ''(CTRL<nowiki>+</nowiki>F10):  In this mode, left-double clicking on a window adds the selected type of marker, - if compatible -, to this area at this position. ''See Display/graph tab in this chapter for details''.
* ''
[[Image:Reports_Tools_Ribbons_310.png|framed|none]]
''Layout selection:  Allows selecting a layout from the active Layout list and display it.
*
[[Image:Reports_Tools_Ribbons_311.png|framed|none]]
Reset Scale:  Reset X, Y and Z axis scale of the active window to their default values''.''
Default values are:
* Y scale: Active input range
* X Scale: max bandwidth
* Z scale default profile/waterfall depth
=====
[[Image:Reports_Tools_Ribbons_10.png|framed|none]]
Transducers group=====
Manage the transducers calibration and automatic recognition prior to measurements:
* ''
[[Image:Reports_Tools_Ribbons_312.png|framed|none]]
''Calibration:  Initiates the calibration procedure tool.
<br>All current analyses and recording must be stopped prior switching to calibration.
The following dialog box is used to calibrate the inputs connected to a transducer.
[[Image:Reports_Tools_Ribbons_27.png|framed|none]]
* Channel: This is the channel to be calibrated. It can be selected using the drop-down list or the up and down arrow. It is available for calibration of all dynamic and DC inputs. When a channel is selected, the sensitivity and the offset are immediately updated.
* Reference: This is the transducer selected on the channel. It is necessary to select a transducer in order to calibrate the input. If the transducer used is not in the list, a default transducer can be used. Information about the transducer is displayed.
* History: See "Transducer" chapter p 82. This button is not available when a default transducer is selected, since it does not refer to unique transducer.
* Edit: Similar to the "new transducer dialog".
* Calibration type: This field is automatically updated, depending on the type of transducer selected.
{|border="2" cellspacing="0" cellpadding="4" width="100%" align="center"
|Calibration type
|Description
|-
|Acoustic
|The transducer is a microphone
|-
|Vibration
|The transducer is an accelerometer (possible unit in g or in m/s²)
|-
|Frequency
|The transducer is associated with a dynamic input and is not a microphone or an accelerometer
|-
|a.x <nowiki>+</nowiki> b
|The transducer is associated with a DC input<br>
[[Image:Reports_Tools_Ribbons_313.png|framed|none]]
<br><br>The area presents the current level on the DC input and is used to perform the calibration for two values. Once calibration is completed, the new sensitivity and offset are available.
* Apply: Applies the new sensitivity to the selected channel.
* Save: Applies the new sensitivity to the selected channel and saves the calibration information. This button is not available for a default transducer.
* Reset: Restores the current sensitivity of the transducer.
|}<br clear="all">
* Acoustic, vibration and frequency calibration: The spectrum measured is displayed. The frequency range is linked to the calibrator frequency. It is possible to right click in the plot area to perform an auto-scale on the Y-axis.
* Calibrator level: Indicates the level of the calibrator. This values is used to determine the new sensitivity of the transducer
* Calibrator frequency: Indicates the frequency of the calibrator. It is used to check that the maximum level measured is at the correct frequency. It is also used to select the best frequency range for the calibration. The most common calibrator frequencies are suggested. It is also possible to choose a user-defined frequency.
[[Image:Reports_Tools_Ribbons_12.png|framed|none]]
* New: Used to select a user-defined calibrator frequency
* Calibrate: Starts the calibration. The analyzer detects the maximum level, checks that frequency is near the calibrator frequency, and determines the new sensitivity.
[[Image:Reports_Tools_Ribbons_13.png|framed|none]]
NB: In case of 1-DSP analyzer with 4 inputs @ 51,2kHz connected to the octave plug-in, it is not possible to perform the calibration (DSP power limit reached). In such situation, down the sampling frequency to 25,6kHz or disconnecting the inputs from the octave plug-in for the time of the calibration will allow calibrating the sensors.
*
[[Image:Reports_Tools_Ribbons_314.png|framed|none]]
Detect TEDS: Start the sequence for detecting transducers (or missing one) equipped with an electronic datasheet inside (TEDS: Transducer Electronic Data Sheet) connected to the front end.
As the TEDS sequence occurs automatically when an input coupling is set to ICP<nowiki>+</nowiki>TEDS, the Detect TEDS button is used for re-checking after transducers or cables modifications. The result of check will be visible on the warning window and may lead to add new transducers to the TDB.
Only the inputs with their coupling set to ICP<nowiki>+</nowiki>TEDS will be checked.
[[Image:Reports_Tools_Ribbons_315.png|framed|none]]
Applying the ICP<nowiki>+</nowiki>TEDS coupling to any (set of) input(s) will activate a recognition sequence on the corresponding input(s).  The result can be the following;
* A new transducer (not in the current NVGate® transducers database) is connected to the corresponding input. NVGate® proposes to add the new transducer in the Transducer database. A dialog box lets the user change the transducer properties:
The content of the TEDS is used to fill the transducer properties. The data from the TEDS that have no correspondence in the ''transducer database'' are copied in the comment area. The name is proposed as the concatenation of type and serial number. User may change it.
[[Image:Reports_Tools_Ribbons_316.png|framed|none]]
* A known transducer (existing in the database) is recognized in the corresponding input. NVGate® will notice it in the log window (which is popped up automatically).
[[Image:Reports_Tools_Ribbons_14.png|framed|none]]
* There is no TEDS transducer connected to the corresponding input. A warning is issued in the log window for each input in this situation.
Warning the TEDS Detection will applies a negative voltage (-5 V) to the corresponding inputs, this may affect incompatible transducers.
OROS 3-Series TEDS management fulfills the IEEE 1451.4 - 2004 revision 1 standard for:
{|border="0" cellspacing="2" width="100%"
|
* Accelerometer/Force meter
|''Template # 25''
|-
|
* Microphone built in preamplifier
|''Template # 27''
|-
|
* Microphone and preamplifier
|''Template # 28''
|-
|
* Capacitive Microphones
|''Template # 29''
|}
The transducers which are compatible with IEEE 1451.4 - 2004 revision 1 are automatically recognized by the OROS 3-Series analyzers.  In order to protect transducers that are electrically incompatible with the TEDS reading, there is a special coupling ''ICP <nowiki>+</nowiki> TEDS.''
All other transducers types will generate a warning specifying that they are not supported.
There are two ways to add a TEDS transducer to the transducers data base:
''Connect a TEDS transducer on a channel.''
Select ICP TEDS for the input coupling.
All the characteristics of the transducer are automatically detected.
A warning confirms that a new transducer has been detected.
The window below is displayed.
[[Image:Reports_Tools_Ribbons_11.png|framed|none]]
The new transducer is added to the transducer database.
* ''Used a TEDS File''
To use a TEDS file, click on New from TEDS file in the transducer database window.
By selecting the file, all the characteristics of the transducer are imported in the transducer database where anew transducer is added.
====The "Acquisition" tab====
This tab provides all the necessary entries to setup the front-end and the use of any channels in details. It separates the acquisition channels setup from the outputs, triggering, tachometer, and filters ones. A special group is available to manage the recorder setup.
[[Image:Reports_Tools_Ribbons_317.png|framed|none]]
While switching to post-analysis the inputs group is swapped to player track group which control the player operations, track connections and track setup.
=====Source dispatcher groups=====
The Inputs, Outputs, Tachometers, Events and Filters groups operates in the same way.
[[Image:Reports_Tools_Ribbons_318.png|framed|none]]
[[Image:Reports_Tools_Ribbons_319.png|framed|none]]
The External sync. Inputs benefit of special button due to their importance in rotating applications.
=====Inputs group=====
The inputs group allows dispatching the front-end channels to the plug-in analyzer and setting up the front-end. These settings are available in the on-line mode only.
* ''
[[Image:Reports_Tools_Ribbons_320.png|framed|none]]
''Connect inputs:'' '' This button allows dispatching the front end inputs (all type) to the analysis modules''. See Chapter 1 ASB - § Connection wizard for details''
*
[[Image:Reports_Tools_Ribbons_321.png|framed|none]]
Inputs: Allows modifying the dynamic input properties. Available when at least one inputs is active''. See Chapter 1 ASB - § Inputs for details''
*
[[Image:Reports_Tools_Ribbons_322.png|framed|none]]
Parametric: Allows modifying the parametric input (DC) properties. Available when at least one DC input is active''. See Chapter 1 ASB - § DC inputs for details''
*
[[Image:Reports_Tools_Ribbons_323.png|framed|none]]
External sync: Allows modifying the digital trigger inputs properties. Available when at least one Ext synch input is active''. See Chapter 1 ASB - § External synchs for details''
*
[[Image:Reports_Tools_Ribbons_324.png|framed|none]]
CAN: Allows modifying the CAN parametric input properties. Available when at least one CAN input is active''. See Chapter 1 ASB - § CAN for details''
*
[[Image:Reports_Tools_Ribbons_325.jpg|framed|none]]
XPod:'' ''Allows modifying the XPod conditioner properties (Gauges, temperature). Available when at least one XPod is connected to the analyzer or in off-line to simulate it ''See Chapter 1 ASB - § Xpod for details''
=====Tracks group=====
In the Post-analysis mode, the inputs group switches to the Player management with and is replaced by the Track settings.
The Track group allows dispatching the recorded tracks to the plug-in analyzer and setting up the signal post-process. These settings are available in the post-analysis mode only.
[[Image:Reports_Tools_Ribbons_326.png|framed|none]]
Note: Clicking on the bottom right icon (
[[Image:Reports_Tools_Ribbons_327.png|framed|none]]
) opens the player plug-in properties dialog allowing a full access to all the settings.
* ''
[[Image:Reports_Tools_Ribbons_328.png|framed|none]]
''Connect Tracks:'' '' This button allows dispatching the signal tracks (all type) to the analysis modules''. See Chapter 1 ASB - § Connection wizard for details''
*
[[Image:Reports_Tools_Ribbons_329.png|framed|none]]
Record num: Define the record number (i.e. a section in the file defined during the acquisition) to be post-processed. ''See Chapter 1 ASB - § Player/Selected record for details''
*
[[Image:Reports_Tools_Ribbons_330.png|framed|none]]
Start offset: Define the start position of the signal to post-process or playback on the generators: (0 <nowiki><</nowiki>= Start Offset <nowiki><</nowiki> Stop Offset).  ''See Chapter 1 ASB - § Player for details''
*
[[Image:Reports_Tools_Ribbons_331.png|framed|none]]
Stop offset: Define the end position of the signal to post-process or playback on the generators: (Start Offset <nowiki><</nowiki> Stop Offset <nowiki><</nowiki>= selected record duration). ''See Chapter 1 ASB - § Player for details''
Note: The ''Start'', ''Stop'' and ''Record num'' can be handled directly from the ''Player file'' or ''Player Zoomed signal'' windows with the start and stop cursors and/or the bottom slide
r
[[Image:Reports_Tools_Ribbons_332.png|framed|none]]
*
[[Image:Reports_Tools_Ribbons_333.png|framed|none]]
Playback mode: Allows choosing between a continuous and a step/step post-process. .
* ''Continuous:'' the signal analyses are processed as fast as possible between the start and stop offset.
* ''Time step: ''the signal analyses are processed step by step. The step duration is defined by the ''Step'' setting (see hereafter). Each new step is manually (or automated by a  macro) triggered through the '' Next step'' setting (see hereafter)
''See Chapter 1 ASB - § Player for details''
*
[[Image:Reports_Tools_Ribbons_334.png|framed|none]]
Step: defines the time duration if play back step in the "Time step" analysis mode. The player switches to "pause" every "time step" second.
:''See Chapter 1 ASB - § Player for details''
*
[[Image:Reports_Tools_Ribbons_335.png|framed|none]]
Next step: defines the time duration if play back step in the "Time step" analysis mode. The player switches to "pause" every "time step".
:''See Chapter 1 ASB - § Player for details''
=====Recorder group=====
This group controls the recorder plug-in setup.
[[Image:Reports_Tools_Ribbons_336.png|framed|none]]
Note: Clicking on the bottom right icon (
[[Image:Reports_Tools_Ribbons_337.png|framed|none]]
) opens the recorder plug-in properties dialog allowing a full access to all the settings.
*
[[Image:Reports_Tools_Ribbons_338.png|framed|none]]
Bandwidths: Opens the bandwidths definition dialog.
The recorder support up to 4 different bandwidths:
{|border="2" cellspacing="0" cellpadding="4" width="82%"
|Type
|Range
|Mode
|-
|FS 1
|2.048 S/s to FSF
|User define
|-
|FS 2
|2.048 S/s to FSF
|User define
|-
|Ext. Synch
|Front-end Sampling Freq (FSF)
|Automatic
|-
|Parametric inputs
|15 Hz
|Fixed
|}
:''See Chapter 1 ASB - § Recorder for details''
*
[[Image:Reports_Tools_Ribbons_339.png|framed|none]]
Mode: defines the time frame recording type. It can be:
* ''Start to stop'': Records between a start and a stop event (can be run/stop)
* ''Start to time'': Records for a fixed duration after a start event (can be run)
* ''Time to Stop'': Records a fixed duration until a stop event (can be the manual stop)
:''See Chapter 1 ASB - § Recorder/Mode for details''
*
[[Image:Reports_Tools_Ribbons_340.png|framed|none]]
Records: defines the maximum number of records in the signal file.
''See Chapter 1 ASB - § Recorder/Mode for details''
*
[[Image:Reports_Tools_Ribbons_341.png|framed|none]]
Duration: Set the maximum duration of a record. This value cannot exceed the ''available'' duration (see here after) for ''Start to time'' and ''Time to stop'' mode only
''See Chapter 1 ASB - § Recorder/Mode for details''
*
[[Image:Reports_Tools_Ribbons_342.png|framed|none]]
Format: allows selecting the recorded data length:
* ''Normal'': 32 bit floating point coding for each sample. Keep the full dynamic and precision.
* ''Compressed'': 16 bit floating point coding for each sample. Reduce the size of the file(s) but reduce also the dynamic to 96 dB. Not recommended for low amplitude signal without auto-ranging. Adapted for exportation of signal in 16 bit format (Wav, txt)
''See Chapter 1 ASB - § Recorder/Mode for details''
*
[[Image:Reports_Tools_Ribbons_343.png|framed|none]]
Available: Display the maximum possible recording duration depending the current recorder setup. Read only. The max duration is computed from the free space of the selected hard disk, the number of tracks (and their corresponding sampling frequency) and the number of records
Note in time to stop, the max duration may also be limited by the local available memory (PC/Analyzer) for the description blocks. ''See Chapter 1 ASB - § Recorder/Mode for details''
=====Outputs group=====
Manages the generated signal on the front-end outputs (generators)
[[Image:Reports_Tools_Ribbons_344.png|framed|none]]
The left button (''signals'') allows selecting the signal type from the list and connecting it to the available outputs (1 to 6) .The others buttons open the signal settings and manage the generators activity.
* ''
[[Image:Reports_Tools_Ribbons_345.png|framed|none]]
''Signals:'' ''  Shows the list of available signals and let the users connect it to the outputs.'' See Chapter 1 ASB - § Connection wizard for details''
The available signals are the following:
* ''
[[Image:Reports_Tools_Ribbons_346.png|framed|none]]
''Sine:'' '' Opens the pure sine properties dialog for adjustment. Pure sine = 1 fixed frequency, 1 amplitude. Adapted for single mode excitation. Possibility to generate a fixed voltage with F=0.
*
[[Image:Reports_Tools_Ribbons_347.png|framed|none]]
Multi-sine:  Opens the ''Multi-sine'' properties dialog for adjustment. Multi sine = n fixed frequencies, 1 amplitude Adapted for multi-mode excitation and FFT analysis
*
[[Image:Reports_Tools_Ribbons_348.png|framed|none]]
Swept-sine:  Opens the ''Swept-sine'' properties dialog for adjustment. Swept-sine = 1 sweeping frequency, 1 to 6 proportional amplitudes Adapted for swept sine and MiMo excitation
*
[[Image:Reports_Tools_Ribbons_349.png|framed|none]]
Chirp:  Opens the ''Chirp'' properties dialog for adjustment. Chirp = Continuous short term variable frequency (1 analysis block), 1 amplitude. Adapted for damping measurement and FFT analysis
*
[[Image:Reports_Tools_Ribbons_350.png|framed|none]]
Random Noise:  Opens the ''Random noise'' properties dialog for adjustment. True Random noise = Infinity of frequencies, 1 amplitude, generated randomly. Adapted for non linear responses measurement.
In addition to these predefined signals, the content of a file and the replication of an input is also available to be connected on the generators.'' See Chapter 1 ASB - § Resources/Output signals for details''
*
[[Image:Reports_Tools_Ribbons_351.png|framed|none]]
Outputs settings: Manages the generated signal settling, (Mute, transition time)
''See Chapter 1 ASB - § Front-end/Output settings for details''
=====Tachometers group=====
Manage the tachometer resources. This group allows selecting the tach type (source, setup) and associates it with the plug-in analyzers and waterfall
[[Image:Reports_Tools_Ribbons_352.png|framed|none]]
The left button (''Select'') allows dispatching the different tachometer type to the plug-in analyzers. The others items open the corresponding event detection setup.
* ''
[[Image:Reports_Tools_Ribbons_353.png|framed|none]]
''Select:'' '' Shows the list of available tachometer sources and allows plugging it to the plug-in and waterfall.
''See Chapter 1 ASB - § Connection wizard for details''
* ''
[[Image:Reports_Tools_Ribbons_354.png|framed|none]]
''Inputs:'' '' Opens the properties dialog for the tachometers based on a dynamic input
* ''
[[Image:Reports_Tools_Ribbons_355.png|framed|none]]
''Ext. Synch:'' '' Opens the properties dialog for the tachometers based on a high speed oversampled Ext Synch input.
* ''
[[Image:Reports_Tools_Ribbons_356.png|framed|none]]
''Fractional:'' '' Opens the properties dialog for the tachometers that derives from another one. Fractional tach. computes RPM speed for a non accessible shaft by using gear ratio setting.'' ''Adapted for gear boxes and transmissions.
Note: the fractional tach. cannot be settled from the ''Vision'' interface, use the ASB for it.
* ''
[[Image:Reports_Tools_Ribbons_357.png|framed|none]]
''Combined:'' '' Opens the properties dialog for the tachometers computed from other ones. Adapted for CVT. Note: the combined tach cannot be settled from the ''Vision'' interface, use the ASB for it.
* ''
[[Image:Reports_Tools_Ribbons_358.png|framed|none]]
''Profile:'' ''Set up the tachometer profiles duration. These graphs are available for the Tachometer module in the Add/Remove graph dialog.
The profile displays continuously the tachometer speeds with a memory depth defined by the ''profile ''setting.
* ''
[[Image:Reports_Tools_Ribbons_359.png|framed|none]]
''Resolution:'' ''Set up the tachometer profiles update rate.
''See Chapter 1 ASB - § Resources/Tachometer for details''
=====
[[Image:Reports_Tools_Ribbons_17.png|framed|none]]
Events group=====
Manage the event and corresponding triggers. This group allows selecting the event type (source, setup) and associates it with the plug-in analyzers triggers
The left button (''Associate to'') allows dispatching the different possible event (internal or external) to the plug-in analyzers.
The 2 others items open the corresponding event detection setup.
* ''
[[Image:Reports_Tools_Ribbons_360.png|framed|none]]
''Associate to:'' '' This button opens the corresponding Event properties. The opened dialog shows both the source signal setup and the detection settings (may be spitted in different tabs)
''See Chapter 1 ASB - § Connection wizard for details''
* Events properties:'' ''This button opens the corresponding Events properties dialog for setup.
The available event types are:
*
[[Image:Reports_Tools_Ribbons_361.png|framed|none]]
Edge: Detect when the signal from an input or a recorded track cross a threshold.
*
[[Image:Reports_Tools_Ribbons_362.png|framed|none]]
Level: Detect when a signal (from parametric input or statistical extraction form the TDA or monitor) is below or above a level
*
[[Image:Reports_Tools_Ribbons_363.png|framed|none]]
Delta-Level: Same as the Level but generates an event at each step
*
[[Image:Reports_Tools_Ribbons_364.png|framed|none]]
RPM: Detect when a tachometer is below or above a specified angular speed
*
[[Image:Reports_Tools_Ribbons_365.png|framed|none]]
Delta-RPM: Same as RPM but generates an event at each step
*
[[Image:Reports_Tools_Ribbons_366.png|framed|none]]
Periodic: Generates events periodically at a fixed rate
*
[[Image:Reports_Tools_Ribbons_367.png|framed|none]]
Combined: Generates an event which is the result of a combination of 2 events. Possible combinations are: OR, AND and AFTER.
*
[[Image:Reports_Tools_Ribbons_368.png|framed|none]]
User: Generates an event when the operator presses the corresponding event button in the software/remote controller interface.
* ''
[[Image:Reports_Tools_Ribbons_369.png|framed|none]]
''External synch:'' ''Properties of the Ext synch trigger inputs.
'' See Chapter 1 ASB - § Resources/Events for details''
=====Filters group=====
Manage the filters definition and position. These filters operate on the time domain series. They can be applied in various locations onto the signal process (Inputs, Plug-in channels, Outputs, Player tracks)
The left button (''Apply to'') allows dispatching the filters to the different possible location in the signal process..
The second button allows selecting a filter type and opens the corresponding setup.
* ''
[[Image:Reports_Tools_Ribbons_370.png|framed|none]]
''Apply to:'' '' This button opens the filter dispatching dialog:
[[Image:Reports_Tools_Ribbons_371.png|framed|none]]
Filters are available only for tachometers, outputs, aux. Outputs, edge detection, FFT, and Sync. Order and only after being activated using the <nowiki>’</nowiki>Inputs<nowiki>’</nowiki>, <nowiki>’</nowiki>Outputs signals<nowiki>’</nowiki>, <nowiki>’</nowiki>Tachometers<nowiki>’</nowiki> or <nowiki>’</nowiki>Event<nowiki>’</nowiki> connections previously described.
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:
[[Image:Reports_Tools_Ribbons_372.png|framed|none]]
''See Chapter 1 ASB - § Connection wizard for details''
* Filter properties:'' ''This button opens the corresponding filter properties dialog for setup.
The available filter types are:
*
[[Image:Reports_Tools_Ribbons_373.png|framed|none]]
High/Low pass:  Filter the high or low (depends on setup) frequencies of a signal
*
[[Image:Reports_Tools_Ribbons_374.png|framed|none]]
Pass/stop band:  Filter or reject (depends on setup) the specified bandwidth.
*
[[Image:Reports_Tools_Ribbons_375.png|framed|none]]
Integrator: Integrates or double integrates the signal. The high pass for avoiding divergences is included. Useful for acceleration to velocity/displacement conversion.
*
[[Image:Reports_Tools_Ribbons_376.png|framed|none]]
Differentiator: Derivate the signal. Useful for torsional velocity conversion in angular acceleration
''See Chapter 1 ASB - § Resources/Filter for details''
[[Image:Reports_Tools_Ribbons_18.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.
====The "Analyses" tab====
In this tab, the software gathers the analyses controls. Each group corresponds to a plug-in analyzer. The content of this tab depends on the purchased optional plug-in.
[[Image:Reports_Tools_Ribbons_377.png|framed|none]]
The Monitor<ref>Excepted for the OR34-VibeShot licenses. </ref> and the waterfall plug-in are always available as standard features of the OROS 3-Series analyzers.
=====Monitor group=====
The Monitor plug-in offers simple and powerful ways to monitor the measured signals. This 4 channels plug-in runs independently from the general analyzer status (running/Paused/stopped) with the capability of swapping connected channels at any time.
[[Image:Reports_Tools_Ribbons_378.png|framed|none]]
The second capability of the monitor is to extract statistical component of the signal in a specific bandwidth. Extracted levels can be used for triggering and waterfall references.
The monitor runs its analyses on a specific processor (DSP) allowing a totally independent computation for the regular analyses.
Note: Clicking on the bottom right icon (
[[Image:Reports_Tools_Ribbons_379.png|framed|none]]
) opens the monitor plug-in properties dialog allowing a full access to all the settings.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_380.PNG|FRAMED|NONE]]
Inputs:  Opens the channels sources selection. Allows choosing which input or track is monitored. Up to 4 ch at a time. The channel sources can be swapped at any time without influence on the other signal processing (analysis, record, play-back) of the instrument.
''See Chapter 1 ASB - § Monitor and waterfall/ Monitor for details''
*
[[Image:Reports_Tools_Ribbons_381.png|framed|none]]
Average decay: Setup the exponential spectrum  average decay of the FFT part.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_382.PNG|FRAMED|NONE]]
Overall analysis: Opens the statistical extraction setting. This dialog set up the filter characteristics and the averaging of the extracted values (DC, RMS, Min/Max, Kurtosis)
*
[[Image:Reports_Tools_Ribbons_383.png|framed|none]]
Filter: Allows applying the filter (Tick on) or bypassing it (No Tick). The Bypass is immediate without delay.
''See Chapter 1 ASB - § Monitor and waterfall/ Monitor for details''
=====Time Domain Analysis group (Optional)=====
The TDA plug-in is designed to get the most from the time domain signal completing the frequency/order analyses. This plug-in offers flexible signal overview and statistical extraction in parallel.
[[Image:Reports_Tools_Ribbons_384.gif|framed|none]]
Note: Clicking on the bottom right icon (
[[Image:Reports_Tools_Ribbons_385.png|framed|none]]
) opens the TDA plug-in properties dialog allowing a full access to all the settings.
* Synchronization: Controls the plug-in synchronization with the general analyzer status:
* 
[[Image:Reports_Tools_Ribbons_386.png|framed|none]]
Linked to run: The plug-in is controlled by the general  Run / Pause / Stop controls. It operates synchronously with the Other plug-in (except the Monitor)
*
[[Image:Reports_Tools_Ribbons_387.png|framed|none]]
Free run: The plug-in runs continuously independently from the general Run/Pause/Stop. Note: The start/stop trigger continue to control the plug-in processing
*
[[Image:Reports_Tools_Ribbons_388.png|framed|none]]
Range: Setup the analysis range for the plug-in. This value is maximized by the front-end sampling frequency divided by 2.56.<br>Note: Each plug-in feature an independent bandwidth.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_389.PNG|FRAMED|NONE]]
Average: Setup Average type for the statistic extraction. It can be exponential with a sliding decay or linear. Multiple linear averaging are obtained by setting the ''TDA/Trigger/Repeat to : End of averaging''
*
[[Image:Reports_Tools_Ribbons_390.png|framed|none]]
Average duration: Setup the average duration. In Exponential mode it specifies the non decayed part of the signal. In linear mode, it specifies the complete duration. In Linear repeated mode, it specifies the short duration.
''See Chapter 1 ASB - § Analysis plug-in/ TDA for details''
=====FFTx group (Optional)=====
The FFT plug-in provide frequency distribution of the analyzed signal. It runs an FFT algorithm.
[[Image:Reports_Tools_Ribbons_391.png|framed|none]]
Note: Clicking on the bottom right icon (
[[Image:Reports_Tools_Ribbons_392.png|framed|none]]
) opens the FFTx plug-in properties dialog allowing a full access to all the settings.
Note: Up to 4 FFT plug-in can be present in the software configuration, each of them running independent analyses on the same or different channels.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_393.PNG|FRAMED|NONE]]
Range: Setup the analysis range for the plug-in. This value is maximized by the front-end sampling frequency divided by 2.56.<br>Note: Each plug-in feature an independent bandwidth.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_394.PNG|FRAMED|NONE]]
Lines: Select the analysis resolution in number of frequency lines. The ''resolution = Range / (Lines-1) '' in Hz
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_395.PNG|FRAMED|NONE]]
Average: Select the domain of averaging:
* <u>''Spectral''</u>: the spectra module are averaged together
* <u>''Time''</u>: the trigger block are averaged together -<nowiki>></nowiki> provide absolute / relative phase
* <u>''Frequency domain synchronous (FDSA)'': </u>The complex spectra are averaged together (real/img) after phase synchronization on one spectral line -<nowiki>></nowiki> allows synchronous time averaging (STA) without a trigger.
''See Chapter 1 ASB - § Analysis plug-in/ TDA for details''
=====Synchronous order group (Optional)=====
The SOA plug-in provide order distribution and extraction of the analyzed signal related to a tachometer. It runs re sampling <nowiki>+</nowiki> FFT algorithms
[[Image:Reports_Tools_Ribbons_396.png|framed|none]]
Note: Clicking on the bottom right icon (
[[Image:Reports_Tools_Ribbons_397.png|framed|none]]
) opens the SOAx plug-in properties dialog allowing a full access to all the settings.
Note: Up to 2 SOA plug-in can be present in the software configuration, each of them running independent analyses on the same or different channels.
*
[[Image:Reports_Tools_Ribbons_398.png|framed|none]]
Max order: Setup the order analysis range for the plug-in from 6.25 to 400.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_399.PNG|FRAMED|NONE]]
Associated tach: Select the tachometer to be used for signal re-sampling. The order results provided by the SOAx plug-in are related to this tachometer speed
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_400.PNG|FRAMED|NONE]]
Order resolution: Select the analysis resolution in orders. Ranges from 1/32 (0.03125) to 1 order.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_401.PNG|FRAMED|NONE]]
Average: Select the type of averaging. Linear, exponential peak hold and ref. peak hold
''See Chapter 1 ASB - § Analysis plug-in/ SOA for details''
=====/nth octave group (Optional)=====
The 1/n Octave plug-in provides constant percentage band spectra. It runs filter and detector. This plug-in complies the IEC 60&nbsp;804 and 62&nbsp;260 standards.
[[Image:Reports_Tools_Ribbons_402.png|framed|none]]
Note: Clicking on the bottom right icon (
[[Image:Reports_Tools_Ribbons_403.png|framed|none]]
) opens the 1/n OCT plug-in properties dialog allowing a full access to all the settings.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_404.PNG|FRAMED|NONE]]
Upper band: Setup the center frequency of the highest frequency band
*
[[Image:Reports_Tools_Ribbons_405.png|framed|none]]
Lower band: Setup the center frequency of the lowest frequency band
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_406.PNG|FRAMED|NONE]]
Resolution: Select band resolution: from 1 band per octave to 24 band per octave.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_407.PNG|FRAMED|NONE]]
Type: Select Averaging type. This setting features a mix of different averaging modes such as time weighting, classic, constant band* time and repeated Leq.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_408.PNG|FRAMED|NONE]]
Average duration: Define the total average duration and the linear duration for exponential.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_409.PNG|FRAMED|NONE]]
Short duration: Define the short average duration for the linear repeated and Leq.
''See Chapter 1 ASB - § Analysis plug-in/ 1/n Octave for details''
=====Overall acoustic group (Optional)=====
The overall acoustic plug-in provides sound pressure level measurement. This plug-in complies with the IEC 61672 standard. It runs 3 RMS detectors <nowiki>+</nowiki> 1 peak per channel.
[[Image:Reports_Tools_Ribbons_410.png|framed|none]]
Note: Clicking on the bottom right icon (
[[Image:Reports_Tools_Ribbons_411.png|framed|none]]
) opens the 1/n OCT plug-in properties dialog allowing a full access to all the settings.
*
[[Image:Reports_Tools_Ribbons_412.png|framed|none]]
Detector: opens the  detectors properties. 1 peak and up to 3 RMS detector can be activated. They process all plug-in channels simultaneously.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_413.PNG|FRAMED|NONE]]
Average: Select the averaging type from Linear and 3 short Leq (1s, 1/8s and user defined
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_414.PNG|FRAMED|NONE]]
Average duration: Define the total average duration.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_415.PNG|FRAMED|NONE]]
Short duration: Define the short average duration for the linear and user defined short Leq
''See Chapter 1 ASB - § Analysis plug-in/ Overall acoustics for details''
=====Waterfall group=====
The so called waterfall is a stack for analysis results and reference. It allows storing results from different plug-ins in a synchronized database. These data are viewed with the 3D waterfall or profiles graphs.
[[Image:Reports_Tools_Ribbons_416.png|framed|none]]
Note: Clicking on the bottom right icon (
[[Image:Reports_Tools_Ribbons_417.png|framed|none]]
) opens the 1/n OCT plug-in properties dialog allowing a full access to all the settings.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_418.PNG|FRAMED|NONE]]
Add/remove: Opens the waterfall add/remove result dialog. This dialog allows selecting the list of result to be collected by the waterfall plug-in.
[[Image:Reports_Tools_Ribbons_419.png|framed|none]]
* Plug-in analyzer tab: A tab is displayed for each plug-in analyzer connected. This displays waterfall source results.
* Result: List of results provided by the plug-in analyzer selected. This can be the source of the waterfall plug-in analyzer.
* Channel: List of plug-in analyzer channels connected, available for the result selected.
* Reference / X: List of plug-in analyzer channels connected. This can be the reference. Available for results that require a reference only (cross-spectrum, for example).
* Tracked order: List of tracked orders on the channel selected. Available if result selected is an order result.
* Waterfall: List of 3D Waterfall displays. These waterfalls can be displayed versus any one of the references selected in the "Reference and profiles" list.
* References & Profiles: List of profiles and references provided by the waterfall plug-in. All scalar profiles selected can be used as references, except monitor scalars, sound level meter scalars, and orders.
[[Image:Reports_Tools_Ribbons_420.jpg|framed|none]]
Adds a new Waterfall. If the result selected is a scalar, a new profile is added to the "References and profiles" list. Otherwise, a new Waterfall is added to the "Waterfall" list.<br> If the Waterfall or profile already exists, the clicking on this button has no effect.<br> If a tracked order is selected, all orders tracked on the channel selected are added.
[[Image:Reports_Tools_Ribbons_421.jpg|framed|none]]
Removes the selected result from the corresponding list.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_422.PNG|FRAMED|NONE]]
Mode: Select the data collection  synchronization:
* One shot: The waterfall is fulfilled in one shot from its start trigger to the stop one.
* Continuous: the plug-in is fulfilled as a rolling buffer (FiFo) memorizing the last data only.
*
[[Image:Reports_Tools_Ribbons_423.png|framed|none]]
Depth: Defines the maximum number of slices to be collected. In the ''continuous ''mode it defines the depth of the rolling buffer.
''See Chapter 1 ASB - § Monitor and waterfall/ Waterfall for details''
====The "Display/Graphs" tab====
This tab covers the results display control. It allows creating, fulfilling, arranging and viewing the windows and layouts. It controls the scale, units, weighting and data operations of any graphs, manages the waterfalls and extraction graphs and the markers.
[[Image:Reports_Tools_Ribbons_424.png|framed|none]]
=====Windows group=====
This part of the display/graph tab manages the windows creation, their refreshment and the ''infotrace'' view/hide.
''See Chapter 7 - § Graph for details''
Note: Clicking on the bottom right icon (
[[Image:Reports_Tools_Ribbons_425.png|framed|none]]
) opens active window properties dialog. The content of this dialog varies depending on the windows type.
''See Chapter 7 - § Graph for details''
*
[[Image:Reports_Tools_Ribbons_426.png|framed|none]]
Add/remove:  Opens the add/remove windows dialog. This dialog allows creating and arranging the traces, graphs, windows and layouts.
Layouts/windows/traces
* One tab is displayed for each layout. Each tab is made up of a tree showing the windows and results displayed in each window.
*
[[Image:Reports_Tools_Ribbons_427.jpg|framed|none]]
: Creates a new layout. A dialog box used to name the new layout is displayed by clicking on the button. A new tab is created and selected, corresponding to the new layout.
*
[[Image:Reports_Tools_Ribbons_428.jpg|framed|none]]
: Creates a new window, in the layout of the selected tab. A dialog box used to name the new window is displayed by clicking on the button.
*
[[Image:Reports_Tools_Ribbons_429.jpg|framed|none]]
: Adds the results selected in the window of the layout tab. If the layout does not contain any windows, a new window is created. A dialog box that shows the name of the new window is displayed. If a result is selected in the layout tab, a click on this button has no effect.
*
[[Image:Reports_Tools_Ribbons_430.jpg|framed|none]]
: Renames the window selected in the layout tab. If no window is selected, a click on this button has no effect and an error message is displayed in a message box.
*
[[Image:Reports_Tools_Ribbons_431.jpg|framed|none]]
: Deletes the selected window or trace selected in layout tab.
Plug-in analyzer tab: A tab is displayed for each plug-in analyzer connected.
[[Image:Reports_Tools_Ribbons_432.png|framed|none]]
* Result selection: List of results provided by the plug-in analyzer selected. Multiple plug-ins may be selected if all results selected are compatible (which means that they can be displayed in the same result window).
* Channel selection: List of plug-in analyzer channels connected, available for the result selected.
* Operation: in the top combo-box, list of weighting which can be applied to results selected. In the middle combo-box, list of derivation/integration operations which can be applied. In the bottom combo-box, list of display units.
* Reference / X: List of plug-in analyzer channels connected. This can be the reference. Available for results that require a reference only (cross-spectrum, for example).
* Tracked order:  List of tracked orders on channel selected. Available if result selected is an order result.
Waterfall tab
[[Image:Reports_Tools_Ribbons_433.png|framed|none]]
* Analyzer result: The list of plug-in analyzers connected that provide Waterfall source results is displayed in the combo-box. The list of results provided by the plug-in analyzer selected, which can be a waterfall source is displayed in the list-box below.
* Channel selection: List of plug-in analyzer channel connected, available for the result selected.
* Operation: in the top combo-box, list of weighting which can be applied to the results selected is displayed. In the middle combo-box, a list of derivation/integration operations that can be applied is displayed. In the bottom combo-box, a list of display units is displayed.
* Reference / X: List of plug-in analyzer channels connected. This can be a reference. Available for results that require a reference only (cross-spectrum, for example).
* Tracked order: A list of tracked orders on the channel selected. Available if the result selected is an order result.
External result tab: The "Externals results" tab allows displays results saved in measurements.
[[Image:Reports_Tools_Ribbons_434.png|framed|none]]
* Measurement selection: List of measurements classified by project.
* Result selection: List of results saved in the measurement selected. Multiple selections are not available.
* Operation: in the top combo-box, list of weighting which can be applied to results selected. In the middle combo-box, list of derivation/integration operations which can be applied. In the bottom combo-box, list of display units.
The left button is a multi-action button that can be assigned to differnts functions. To assign a function, select the corresponding item in the drop list. Note, assigning a function will apply it.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_435.PNG|FRAMED|NONE]]
Close all:  Close all the windows in the active Layout
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_436.PNG|FRAMED|NONE]]
Open infotrace:  Opens or close (toggle) the ''infotrace'' of the active windows. The ''infotrace'' contains the trace(s) identification,  the cursor and marker values and the section data for the 3D waterfall windows.
''See chapter 2 –Display - § area for details''
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_437.PNG|FRAMED|NONE]]
Refresh all:  Force the refreshment of displayed data. Applies to all windows and all traces. Used in case of de synchronization between the hardware and the software.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_438.PNG|FRAMED|NONE]]
Freeze trace (F10):  Freeze/unfreeze (toggle) the traces of the active window.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_439.PNG|FRAMED|NONE]]
Freeze all traces  Freeze/unfreeze (toggle) all the displayed traces in the active Layout
=====Zoom group=====
Control the windows graphical zooms and auto-scaling.
[[Image:Reports_Tools_Ribbons_440.png|framed|none]]
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_441.PNG|FRAMED|NONE]]
Y Adjust  (CTRL<nowiki>+</nowiki>A): Adjust the Y scale of all displayed graph in the active Layout.
''See chapter 2 –Display - § Display window/graph menu / Y zoom  for details''
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_442.PNG|FRAMED|NONE]]
X/Z Adjust  (CTRL<nowiki>+</nowiki>Q): Adjust minimum and maximum values of the X or Z-scale so that every point on the axis is visible..
''See chapter 2 –Display - § Display window/graph menu / X zoom  for details''
*
[[Image:Reports_Tools_Ribbons_443.png|framed|none]]
Reset scale  (CTRL<nowiki>+</nowiki>Z): Reset the Y/X/Z scale of the active window. The default value of each scale depends on the inputs range for Y, The analysis bandwidth for X and the number of point for the Z one.
''See chapter 2 –Display - § Display window/graph menu for details''
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_444.PNG|FRAMED|NONE]]
Zoom in Y: Makes the Y-scale two times smaller.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_445.PNG|FRAMED|NONE]]
Zoom out Y:  Makes the Y-scale tow time larger.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_446.PNG|FRAMED|NONE]]
Zoom in X: Makes the X-scale two times smaller and sets the minimum and maximum values so that the cursor is in the middle of the graph.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_447.PNG|FRAMED|NONE]]
Zoom out X:  Makes the X-scale twice as large and sets the minimum and maximum values so that the cursor is in the middle of the graph.
=====View group=====
Browses the displayed windows and toggle the 3D/2D view
[[Image:Reports_Tools_Ribbons_448.png|framed|none]]
*
[[Image:Reports_Tools_Ribbons_449.png|framed|none]]
Cascade view:  Toggle the active trace between 3D and 2D graphs. Applies to spectral (freq, order, 1/n oct) window only. Note the Cascade view is designed for monitoring purpose as it bufferize the data in the display. Buffered data cannot be manipulated or saved, use the waterfall plug for this purpose.
''See chapter 2 –Display - § Display window/window menu / Cascade  view for details''
*
[[Image:Reports_Tools_Ribbons_450.png|framed|none]]
Browse Windows (ALT<nowiki>+</nowiki>TAB): Scan the existing windows in the current layout.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_451.PNG|FRAMED|NONE]]
Browse layouts  (CTRL<nowiki>+</nowiki>SHIFT<nowiki>+</nowiki>SPACE): Scan the existing layouts. Note the 2 latest viewed layouts are kept in the RAM memory.
Note: using the CTRL<nowiki>+</nowiki>SPACE shortcut allow switching between these layouts
=====
[[Image:Reports_Tools_Ribbons_21.png|framed|none]]
Tiles group=====
Allows arranging automatically the windows in the current layout.
*
[[Image:Reports_Tools_Ribbons_452.png|framed|none]]
Automatic: Organizes windows in the best possible arrangement according to the type and contents of the graphs.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_453.PNG|FRAMED|NONE]]
Cascade:  Cascades the windows according to the Windows operating system rules.
*
[[Image:Reports_Tools_Ribbons_454.png|framed|none]]
Vertical:  Tiles windows horizontally according to the Windows operating system rules.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_455.PNG|FRAMED|NONE]]
Horizontal:  Tiles windows horizontally according to the Windows operating system rules.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_456.PNG|FRAMED|NONE]]
Grid:  Tiles windows in order to have all windows with the same size.
=====
[[Image:Reports_Tools_Ribbons_26.png|framed|none]]
Marker group=====
Features a complete set of real-time markers that help identifying typical signature and points of exception in both time and spectral graphs.
The marker group allows selecting and positioning the chosen marker.
.
The first button corresponds to the marker to be added. It is a multi-action button that gathers all marker type in its list.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_457.PNG|FRAMED|NONE]]
Free marker:  Switch the cursor to deposit a free marker in the click location. The free marker can be positioned everywhere to add a legend in a spectra, profile, 1/n octave and waterfall section.
''See chapter 2 –Display - § Marker/free marker for details''
*
[[Image:Reports_Tools_Ribbons_458.png|framed|none]]
Harmonic marker:  Switch the cursor to deposit a set of harmonic in the click location. The harmonic marker can be positioned everywhere in a spectra and waterfall X/Y sections. ''See chapter 2 –Display - § Marker/harmonic marker for details''
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_459.PNG|FRAMED|NONE]]
Peaks marker:  Switch the cursor to add a set of peak detection markers in the clicked graph. The peak marker detects automatically the peaks in the spectra and waterfall X/Y sections. ''See chapter 2 –Display - § Marker/peaks marker for details''
*
[[Image:Reports_Tools_Ribbons_460.png|framed|none]]
Max marker:  Switch the cursor to add a set of maximum detection markers in the clicked graph. The max marker detects automatically the maximum in the spectra and waterfall X/Y sections. ''See chapter 2 –Display - § Marker/Max marker for details''
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_461.PNG|FRAMED|NONE]]
Side band marker:  Switch the cursor to add a side band marker at the clicked location. The Sideband marker can be positioned everywhere in a spectra and waterfall X/Y sections. ''See chapter 2 –Display - § Marker/Sideband marker for details''
*
[[Image:Reports_Tools_Ribbons_462.png|framed|none]]
Power band marker:  Switch the cursor to add a power band marker at the clicked location. The power-band marker can be positioned everywhere in a spectra and waterfall X/Y sections. It extracts the RMS power in the selected band taking in account the equivalent bandwidth of the weighting window. ''See chapter 2 –Display - § Marker/Power band marker for details''
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_463.PNG|FRAMED|NONE]]
1/n Octave data marker:  Switch the cursor to add a 1/n octave data marker at the clicked graphs. The  1/n octave data marker can be positioned in CPB spectra and waterfall X/Y sections of the same type. It extracts the list of the band levels in db or linear units into the infotrace. ''See chapter 2 –Display - § Marker/Octave marker for details''
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_464.PNG|FRAMED|NONE]]
Kinematic marker:  Switch the cursor to deposit a set of harmonic in the click location. The harmonic marker can be positioned everywhere in a spectra and waterfall X/Y sections. ''See chapter 2 –Display - § Marker/Octave marker for details''
*
[[Image:Reports_Tools_Ribbons_465.png|framed|none]]
Period marker:  Switch the cursor to add a periodic marks at the clicked location. The period marker can be positioned trigger blocks. Operates like an harmonic marker but in the time domain.'' See chapter 2 –Display - § Marker/Kinematic marker for details''
*
[[Image:Reports_Tools_Ribbons_466.png|framed|none]]
Record marker (CTRL<nowiki>+</nowiki>M)
Using this shortcut while the analyzer is recording, add record marker to the signal. If there is a recording window, the maker is displayed. During the recording, a comment can be added to the record marker, via the properties dialog box.
The record marker is available from the ''Measurement\Control'' group. ''See Measurement tab§ in this document.''
The rest of the group is dedicated to the marker adjustments:
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_467.PNG|FRAMED|NONE]]
Marker mode:  Switch between the marker mode (the cursor controls the marker) and the last used cursor mode. ''See this chapter (6) - §Tabs/ Measurement tab/graph group for details''
*
[[Image:Reports_Tools_Ribbons_468.png|framed|none]]
Move marker:  Moves the selected marker of the active window by one step of spectra resolution to the left or right
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_469.PNG|FRAMED|NONE]]
Move marker by 1/32<sup>nd</sup> of step:  Moves the selected marker of the active window by a 1/32<sup>nd</sup> of spectra resolution to the left or right. Allowed only if the marker is located in the vicinity (<nowiki>+</nowiki>/- 1 step) of a peak and the X& Y interpolation are enabled
=====D group=====
This group provides general purpose tools about the Waterfall 3D graphs.
[[Image:Reports_Tools_Ribbons_470.png|framed|none]]
The first button corresponds to displayed graphs. Each Waterfall windows may displays up to 4 different graphs. It is a multi-action button.
*
[[Image:Reports_Tools_Ribbons_471.png|framed|none]]
3D only:  Shows the 3D graph only. This graph can be a 3D plot or a color map.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_472.PNG|FRAMED|NONE]]
X/Y only:  Shows the X/Y extraction graph only. This graph contains the spectra at the cursor position and the X/Y sections.
*
[[Image:Reports_Tools_Ribbons_473.png|framed|none]]
Y/Z only:  Shows the Y/Z extraction graph only. This graph contains the time (or ref) profile at the cursor position and the Y/Z sections.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_474.PNG|FRAMED|NONE]]
Extraction only:  Shows the Order/frequency extraction graph only. This graph contains the order/frequency profile at the cursor position and the extraction sections.
*
[[Image:Reports_Tools_Ribbons_475.png|framed|none]]
All graphs:  Shows all the graphs in a matrix.
''See chapter 2 –Display - § Contextual menu/Window menu/Waterfall menu for details''
The second button controls which way the 3D data are plotted. It is a multi-action button.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_476.PNG|FRAMED|NONE]]
3D Isometric:  Plot the spectra (or trigger blocks) along a Z axis with the same scale whatever is the position. The Z axis angle is modified by the rotate button.
*
[[Image:Reports_Tools_Ribbons_477.png|framed|none]]
3D perspective:  Plot the spectra (or trigger blocks) in a true 3D space, taking in account the perspective. The global orientation of the gathered spectra can be changed using the rotate button. This type of view allows looking at the waterfall from any side
*
[[Image:Reports_Tools_Ribbons_478.png|framed|none]]
Time/frequency color map:  Plot the spectra (or trigger blocks) on 2D map with the color representing the point amplitude. This plot show the Time (Y) Vs frequency (X) arrangement
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_479.PNG|FRAMED|NONE]]
Frequency/time color map:  Plot the spectra (or trigger blocks) on 2D map with the color representing the point amplitude. This plot show the Frequency (Y) Vs Time (X) arrangement
The last 3 items control the 3D graph rotation and manage the sections:
*
[[Image:Reports_Tools_Ribbons_480.png|framed|none]]
Rotate:  Toggle the rotating mode. Allows rotating the 3D graphs with the mouse when enabled. Disabling this item return the mouse to the previous mode.
*
[[IMAGE:REPORTS_TOOLS_RIBBONS_481.PNG|FRAMED|NONE]]
Add section:  Add  a copy of the cursor location in each of the 3 extraction graph
*
[[Image:Reports_Tools_Ribbons_482.png|framed|none]]
Section manager: Open the waterfall section manager.
''See chapter 2 –Display - § Contextual menu/Window menu/Waterfall menu for details''
====The "report" tab====
This tab is dedicated to the report generation. It contains the necessary tools to build up or modify a template into MS Word™ or Excel™. The use of the tab is no more requested as soon a template has been build up; the report can be generated from the ''Measurement'' tab.
[[Image:Reports_Tools_Ribbons_483.gif|framed|none]]
''See chapter 5 Reports & tools - § Reporting for details.''
====The "Tools" tab====
The tool tab contains powerful and helpful tools to automate repetitive tasks made with the analyzers
[[Image:Reports_Tools_Ribbons_484.png|framed|none]]
''See chapter 5 Reports & tools - § Tools for details.''
===Status bar===
The software interface features a status bar that shows continuously the different status of the hardware, analysis and ongoing actions.
[[Image:Reports_Tools_Ribbons_485.png|framed|none]]
The status bar is divided in 5 parts
====Controls
[[Image:Reports_Tools_Ribbons_486.png|framed|none]]
====
Allows starting, pausing and stopping the analysis.
''See Measurement tab/control group for details''
====Plug-ins progress bars====
Shows the individual analysis status of the active plug-ins. The Progress bars appear automatically when the plug-in are activated (i.e: Inputs or tracks are connected to their channels).
Ex:
[[Image:Reports_Tools_Ribbons_487.png|framed|none]]
Each progress bar displays:
* A progress bar:
* Indicates the current averaging number or analysis duration. In case of un expectable duration, the progress bar continuously run for one side to the other.
* The color indicates the real time status:
* Green = real-time, all sample are processed
* Red = the analysis has encountered a non real-time situation, sample have not been analyzed
* A text: (''AVT) SSSS: AAA''
* AVT = Average type
* SSSS= Plug-in status (Stop, run, Paused, triggering,)
* The text color indicates the current real-time status: Red = not real-time
====Information area====
In the top left of the status bar, contextual information and progress bar appear depending the on-going action. This concern the disk download, the setup and data saving and any long duration process from NVGate.
====Inputs status LED====
Shows the inputs/signal tracks status. The same status is displayed on the front-end LED.
{|border="2" cellspacing="0" cellpadding="4" width="79%" align="center"
|
[[Image:Reports_Tools_Ribbons_488.png|framed|none]]
|The input is not active
|-
|
[[Image:Reports_Tools_Ribbons_489.png|framed|none]]
|The input is under loaded. The signal amplitude is more than 24 dB below the current input range
|-
|
[[Image:Reports_Tools_Ribbons_490.png|framed|none]]
|Normal, the signal amplitude is between -24 dB and the input range.
|-
|
[[Image:Reports_Tools_Ribbons_491.png|framed|none]]
|An overload has been detected since the last run. The signal on the input is no more overloaded
|-
|
[[Image:Reports_Tools_Ribbons_492.png|framed|none]]
|The input is overloaded.
|}<br clear="all">
[[Image:Reports_Tools_Ribbons_19.png|framed|none]]
A right-click on an active input status LED displays a pop-up menu. It is used to modify the range or any of the input parameters.
=====Front-end LED colors=====
For those who use OR36, Mobi-Pack and OR38 version 2, the front-end LED colors helps knowing what is connected and signal levels.
The LED statuses are:
{|border="2" cellspacing="0" cellpadding="4" width="100%"
|Status
|Color on Front End
|Color on XPod
|-
|Dynamic inputs normal
|bgcolor = "#59FD5D"|Green
|None
|-
|Dynamic inputs underload
|bgcolor = "#69D8FF"|Cyan (clear blue)
|None
|-
|Every input type overload
|bgcolor = "#FF0000"|<font color="#000000">Red</font>
|bgcolor = "#FF0000"|<font color="#000000">Red</font>
|-
|Parametric input normal
|bgcolor = "#FFFF00"|Yellow
|None
|-
|Parametric input underload
|bgcolor = "#CCC0D9"|Clear purple
|None
|-
|Strain gauges normal
|None
|bgcolor = "#0070C0"|<font color="#000000">Blue</font>
|-
|Thermocouple JKTNB
|None
|Yellow, Green, Brown, Pink, purple
|-
|PT 100, PT1000
|None
|Blue, Grey (low white)
|}
====Accept/reject====
This function is used to accept or reject a measurement when the FFT trigger accept mode is set to manual.
=====Accept
[[Image:Reports_Tools_Ribbons_493.jpg|framed|none]]
=====
Shortcut: Ctrl <nowiki>+</nowiki> Y. Accepts the last acquisition.
=====Reject
[[Image:Reports_Tools_Ribbons_494.jpg|framed|none]]
=====
Shortcut: Ctrl <nowiki>+</nowiki> N. Rejects the last acquisition.
====Battery====
Shows the battery and powering status:
{|border="2" cellspacing="0" cellpadding="4" width="72%" align="center"
|
[[Image:Reports_Tools_Ribbons_495.png|framed|none]]
|The analyzer is powered by and external power
|-
| 
[[Image:Reports_Tools_Ribbons_496.png|framed|none]]
|The analyzer is running on its battery
|}<br clear="all">
The battery level shows the available autonomy. The steps shows: 100%, 75%, 50%, 25% and 10% of battery charge. Note: The battery level is also replicated on the LCD screen of OR36 and OR38.
''See user manual for details about battery''
====Connection mode====
Depending the connection mode an analyzer or a display icon is displayed in the bottom right area.
{|border="2" cellspacing="0" cellpadding="4" width="95%"
|
[[Image:Reports_Tools_Ribbons_497.png|framed|none]]
|Office mode. The software processes data from a signal file (post-analysis) in the PC or simulates the inputs for preparing a measurement setup.
|-
|
[[Image:Reports_Tools_Ribbons_498.png|framed|none]]
|Connected mode. The hardware is connected. The software runs the analysis on the DSPs directly from the inputs or post-processing signal files from the Mobi-disk.
|}
Note: a fly over the Analyzer icon with the mouse will show the internal temperature and fan status of the analyzer.
====Acquisition status====
{|border="2" cellspacing="0" cellpadding="4" width="95%"
|
[[Image:Reports_Tools_Ribbons_499.png|framed|none]]
|The acquisition and analysis are real-time
|-
|
[[Image:Reports_Tools_Ribbons_500.png|framed|none]]
|The acquisition is not real-time. The analyzer is not working properly. Both software and hardware should be restarted
|}
===File Menu===
====
[[Image:Reports_Tools_Ribbons_501.jpg|framed|none]]
Project====
=====New=====
Opens the Start & Go. This dialog proposes to load predefined setups or to build a new one. ''See § Tabs/Home in this chapter for details''
=====Load=====
Opens the dialog box to load a project. Select a project from the current base.
=====Save:=====
Saves the current project. If the current project is the default project, the Save command will act as the Save As.
=====Save As:=====
Saves the current project with a new name
====
[[Image:Reports_Tools_Ribbons_502.jpg|framed|none]]
Save setup as model====
Save the current setup in the ''C:\OROS\NVGate data\Workbook Library\user ''Directory. The models can be reloaded from the ''Load setup'' button in the ''Home'' Tab.
A Model includes the following items:
* Workbook
* ASB
* Layouts
* Control panel
* Save Setup
* Macros
* Sequences
* Signal file loaded in the player
After being saved, the model remains unchanged whatever the number of time it is used. In order to change a model it must be loaded, modified and saved as a model again with the same name.
====
[[Image:Reports_Tools_Ribbons_503.jpg|framed|none]]
Export====
=====Result files=====
Export results from the project manager to a user specified directory in various data format.
[[Image:Reports_Tools_Ribbons_504.png|framed|none]]
Project: Lists the projects that contain measurements. Only one project can be selected.
Measurement: Lists the measurements in the project selected. Select one or several measurements and click on the add button.
Batch list: Contains all the measurements that will be converted. Use the add/remove button to modify list content.
Format: This is the output format. The formats available are:
{|border="2" cellspacing="0" cellpadding="4" width="84%" align="center"
|Result
|Signal
|-
|Mat: to be used with Matlab
|Mat: to be used with Matlab
|-
|Txt: usable by any text or spreadsheet editor
|SDF: Standard data format
|-
|UFF: Universal File Format
|UFF: Universal File Format
|-
|&nbsp;
|Wav audio: Wav file, re-sampled to standard audio frequency (44.1, 48, 96 kHz) . To be used by any audio player
|-
|&nbsp;
|Wav: Standard wav format, usable with OR2X technology
|-
|&nbsp;
|Txt: Text usable by any text or spreadsheet editor
|}<br clear="all">
''See Chapter 7 User preferences- § Export" topic for more details''
Output directory: The location on the disk where the files will be exported. During the export, a directory will be created for each project, and will contain the exported files corresponding to all selected measurements.
=====Signals files=====
Export Signal from the project manager records to a user specified directory in various data format.
''See details from previous § Export result files''
====
[[Image:Reports_Tools_Ribbons_505.jpg|framed|none]]
Import====
=====Import project=====
This command is used to import project that are not in the project database. It makes a copy of the project and makes it available to the current user, or whoever created the project. If a project already exists in the project base, a <nowiki>~</nowiki> (tilde) will automatically be added.
Directory: Select the directory in which you would like to look for the project. The "found project" list will display all projects that are immediately in the directory selected. If the "scan" button is pressed, all the projects that are contained in the specified directory will be displayed.
Found projects: Displays the list of projects found. Select one or several projects to import.
=====Import Files=====
This command is used to import results or signals. It makes a copy of the file and makes it available to the current user, or whoever created the file. The file will be included in a measurement If a measurement already exists in the project, a <nowiki>~</nowiki> (tilde) will automatically be appended.
[[Image:Reports_Tools_Ribbons_506.png|framed|none]]
* Reception project: Determines which project will receive the new measurement
* File type: One or several types can be selected. File type may be OR2X or OR3X
* Directory: Selects the directory in which you would like to look for the files. The "found files" list will display all the files that are immediately in the directory selected. If the "scan" button is pressed, all the files that are contained in the specified directory will be displayed.
* Found files: Displays the list of files found. Select one or several projects to import.
====Recent projects====
Displays the list of the most recent projects used by the current user.
====Recent measurements====
Displays the list of the most recent measurements used by the current user.
====Help====
=====Users<nowiki>’</nowiki> manual=====
Load the users<nowiki>’</nowiki> manual. Acrobat reader must be installed on the PC.
The user manual gathers all the guides and rules to uses the analyzer from its installation to advanced automated operations. It answer to the "How do I?" question.
=====Reference manual=====
Load the reference manual. Acrobat reader must be installed on the PC.
The reference manual contains the detailed description of each item of the analyzer. It can be loaded with the F1 key on any Item.
=====What<nowiki>’</nowiki>s new=====
Load the release note of the current NVGate version. Acrobat reader must be installed on the PC.
This is helpful identifying the latest features or getting instruction of items which are not already available in the reference manual
=====Web=====
Shortcuts to the OROS pages on the web. The myOROS website gathers many helpful information and example dedicated to OROS products users. Register on www.myOROS.com
====Exit====
Exit NVGate.
----
===Shortcuts===
====General shortcuts====
{|border="2" cellspacing="0" cellpadding="4" width="101%"
|F1
|On-Line Help
|-
|Ctrl <nowiki>+</nowiki> Space
|Move from one layout to the next one
|-
|Ctrl <nowiki>+</nowiki> Tab
|Move from one window to another one in the same layout
|-
|Page Up
|Change Workspace tab (ASB, Control Panel, Project Manager)
|-
|Page Down
|Change Workspace tab (ASB, Control Panel, Project Manager)
|-
|F10
|Freeze the active window
|-
|
[[Image:Reports_Tools_Ribbons_507.png|framed|none]]
|Move the cursor to the left
|-
|
[[Image:Reports_Tools_Ribbons_508.png|framed|none]]
|Move the cursor to the right
|-
|<nowiki>+</nowiki>
|Zoom in on Y axis
|-
|<nowiki>-</nowiki>
|Zoom out on Y axis
|-
|/
|Zoom out on X axis
|-
|<nowiki>*</nowiki><br>
|Zoom in on X axis
|-
|Shift <nowiki>+</nowiki> F1
|Contextual help
|-
|Ctrl <nowiki>+</nowiki> Insert
|Edit Copy
|-
|Shift <nowiki>+</nowiki> Delete
|Edit Cut
|-
|Ctrl <nowiki>+</nowiki> X
|Edit Cut
|-
|Shift <nowiki>+</nowiki> Insert
|Edit Paste
|-
|Alt <nowiki>+</nowiki> Back
|Edit Undo
|-
|&nbsp;
|&nbsp;
|-
|Ctrl <nowiki>+</nowiki> R
|Run
|-
|Pause
|Pause
|-
|Ctrl <nowiki>+</nowiki> S
|Stop
|-
|Ctrl <nowiki>+</nowiki> A
|Y axis auto-scale on all windows
|-
|Crtl <nowiki>+</nowiki> Alt <nowiki>+</nowiki> A
|Y axis auto-scale on active window
|-
|Ctrl <nowiki>+</nowiki> Shift <nowiki>+</nowiki> A
|Auto-range
|-
|Ctrl <nowiki>+</nowiki> B
|Next Step
|-
|Ctrl <nowiki>+</nowiki> C
|Copy item content (ASB settings, mask)
|-
|Ctrl <nowiki>+</nowiki> V
|Paste item content (ASB settings, mask)
|-
|Ctrl <nowiki>+</nowiki> D
|Save current workbook
|-
|Ctrl <nowiki>+</nowiki> Y
|Accept acquisition
|-
|Ctrl <nowiki>+</nowiki> N
|Reject acquisition
|-
|Ctrl <nowiki>+</nowiki> 0 to 9
|Macro start
|-
|Ctrl <nowiki>+</nowiki> P
|Print report
|-
|Ctrl <nowiki>+</nowiki> Q
|Zoom auto-scale on Z axis
|-
|Ctrl <nowiki>+</nowiki> T
|Manual trigger
|-
|Ctrl <nowiki>+</nowiki> M
|Add record marker
|-
|Ctrl <nowiki>+</nowiki> W or Z
|Full width on active trace
|-
|Insert
|Memorize Trace
|-
|Ctrl <nowiki>+</nowiki> Delete
|Remove Active Trace
|-
|Ctrl <nowiki>+</nowiki> F5, F6, F7, F8, F9, F10
|Change the mouse mode (display mode toolbar)
|-
|X/Y/Z <nowiki>+</nowiki>Shift <nowiki>+</nowiki> Mouse wheel (up)
|Zoom in on (X/Y/Z) axis (<nowiki>+</nowiki> Ctrl for small steps)
|-
|X/Y/Z <nowiki>+</nowiki>Shift <nowiki>+</nowiki> Mouse wheel (down)
|Zoom out on (X/Y/Z) axis (<nowiki>+</nowiki> Ctrl for small steps)
|-
|X/Y/Z <nowiki>+</nowiki> Mouse wheel (up)
|Translate X/Y/Z axis positively (<nowiki>+</nowiki> Ctrl for small steps)
|-
|X/Y/Z <nowiki>+</nowiki> Mouse wheel (down)
|Translate X/Y/Z axis negatively (<nowiki>+</nowiki> Ctrl for small steps)
|-
|Ctrl <nowiki>+</nowiki> F5
|Default mode activation (scale mode)
|-
|Ctrl <nowiki>+</nowiki> F6
|Zoom mode activation
|-
|Ctrl <nowiki>+</nowiki> F7
|Cursor mode activation
|-
|Ctrl <nowiki>+</nowiki> F8
|Move mode activation
|-
|Ctrl <nowiki>+</nowiki> F9
|Rotate mode activation
|-
|Ctrl <nowiki>+</nowiki> F10
|Marker mode activation
|-
|F2 to F9, F11, F12
|Macro Hot key
|}
====Use the mouse wheel for 1D windows====
Mouse wheel: move the min, the max or shift a scale.
Note: If you do not have a mouse wheel, you can use the top and bottom arrows
====Template Editor====
{|border="2" cellspacing="0" cellpadding="4" width="100%"
|Tab
|Browse the objects on the active page
|-
|Alt Gr <nowiki>+</nowiki> Tab
|Browse the objects on the active page in the opposite direction
|-
|Alt <nowiki>+</nowiki> Enter
|Last selected object properties
|-
|
[[Image:Reports_Tools_Ribbons_509.png|framed|none]]
|Move one or several selected controls to the left
|-
|
[[Image:Reports_Tools_Ribbons_510.png|framed|none]]
|Move one or several selected controls to the right
|-
|
[[Image:Reports_Tools_Ribbons_511.png|framed|none]]
|Move one or several selected controls to the top
|-
|
[[Image:Reports_Tools_Ribbons_512.png|framed|none]]
|Move one or several selected controls to the bottom
|-
|Suppr
|Delete one or several selected controls
|}
====Use the mouse wheel for 2D windows====
====Cursor mode====
Mouse Wheel: right/left move by 5 steps.
Mouse Wheel <nowiki>+</nowiki> CTRL: right/left move by 1 step.
====Arrow mode====
When the pointer is on the X or Y axis and on the min or max value, use the mouse wheel to move 5 pixels.
When the pointer is on the X or Y axis and on the min or max value, use the mouse wheel <nowiki>+</nowiki> CRTL to move 1 pixel.
When the pointer is in the middle of X or Y axis, use the mouse wheel to shift translation of the zoom area 5 pixels.
When the pointer is in the middle of the X or Y axis, use the mouse wheel <nowiki>+</nowiki> CRTL to shift of the zoom area 1 pixel.
When the pointer is in the middle of X or Y axis, use the mouse wheel <nowiki>+</nowiki> SHIFT to zoom quickly.
When the pointer is in the middle of X or Y axis, use the mouse wheel <nowiki>+</nowiki> CRTL <nowiki>+</nowiki> SHIFT to zoom.
----
----
<references/>
[[category:Reports_Tools_Ribbons]]

Latest revision as of 14:30, 24 November 2020

Powered by the Vision interface and still based on the use of templates, the NVGate reporting toolset focuses on intuitive transfer of analyzer’s data, leaving to MSOffice the page setup and extra content.

Overview

The reporting tools are gathered in a dedicated tab called Reports. The Reports tab features 4 groups that offer respectively; the file selection (Word or Excel), the format of dropped data, contextual information and graphics preferences.

The report tab is divided in 3 sections:

  • Automatic: Generates report automatically
  • Operational: Select a template and refresh /print
  • Creation: Format, references and graphics preferences
Reports Tools Ribbons 29.png

Tutorial

Introduction

Objectives:

In this tutorial, we will show the basic operations to do a report.

Through the different steps of a typical procedure, the useful functions will be described. The report functions are based on the drag and drop of items.

Equipment
  • OR3X Analyzer
  • PC with NVGate
  • Ethernet link
  • Microsoft Word/Excel
  • 1 signal

You can create a report in On-line mode or in Office mode.

Procedure

Active file

First you need to open a new or existing Word/Excel document.

In NVGate, go in the Report tab, in the Active File group.

Usersmanual 179.png


Move the mouse over the combo-box. Automatically, the software will check the opened file on the computer and fill up the list. It is then possible to select the working template.

Usersmanual 180.png

In order to work in the best conditions, position the both windows (NVGate window and Word document) side by side.

NVGate items are identified by a tag in the template. The tags are editable in Excel cells, hidden text in Word (apply the Usersmanual 181.png mode to see the tags).

It’s better to work in Usersmanual 182.png mode while doing the report to avoid any drag and drop inside a tag.

Deposit NVGate items

The reporting operations are based on the use of Drag & Drop; Select an item from NVGate and drop it into the template. The software will add a TAG in the target file and then update it with the corresponding NVGate data.

To add a graphical result(s) into a Word document, click on the corresponding window area (grey area), then drag & drop it at the chosen location in the template:

Usersmanual 183.png

While selecting an OROS Item for reporting, an icon is displayed on the cursor to confirm:

  • this item is droppable in the report,
  • the used format (drop style) in the report
Usersmanual 184.png
Usersmanual 185.png

Obviously, any text, image, table, link can be used in the template to enrich the report with results interpretation, corporate data, and others.

We can, for example, create a table in the Word document in order to insert the sensors identification.

With tags:

Usersmanual 186.png

Without tags:

Usersmanual 187.png
Usersmanual 41.png

In addition to the actual measurement setup and result data, a measurement must be identified and detailed by meta-data (project name, measurement name, date, comments and properties.). The References group provides such information to be inserted in the report.

Drag and drop these items directly from the group.

Select More to see the whole set of properties

Example of template:

In the first lines, the Project name and date were inserted. Then a table with all sensors specifications was added.

A drag and drop of the time signal was done. After post-analyzing the time signal, a FFT spectrum was displayed in NVGate and finally dragged and dropped in the template with some FFT settings (frequency range, resolution and number of lines).

Usersmanual 188.png
Usersmanual 189.png

You can also put markers on graphs and display the Marker table by drag and drop from the infotrace.

Usersmanual 190.png


Usersmanual 191.png
Data format

In the Drop Style group, you can define the format of the data in the report file. Indeed, analysis results can be exported as data or graph as well as a setting format includes its name or units.

Usersmanual 192.png
Usersmanual 193.png

Note: advise not to use the Active Trace or All Traces for narrow band spectra within Word documents. It leads to a long process into Word.

Refresh

The refresh function is used to update the file.

You can resize the graph in the report. Even if the graph seems to be distorted, this is easily solved with the Refresh function.


Printing a report

Generating a report consists on the following operations:

1. Select a template (or target file)

2. Update its content with NVGate measurements

3. Save or print the report

The Automatic report group makes the 1, 2 and 3 steps automatically.

The report templates are built up with the Reports tab, and then the report generation is available from the Measurement and Reports tabs.

Settings

Automatic report tools

The Automatic report group is located the left side of the Report ribbon.

Reports Tools Ribbons 30.png

It features 3 fully automated report generations and a batch function for multiple measurements reports

Print all windows

This function allows printing all the displayed graphs in a comprehensive report, without requiring setup any template. Simply press the All windows button to get your data plotted in a word file.

Reports Tools Ribbons 31.png

First, a location and name are requested for the report file.

Reports Tools Ribbons 32.png

Secondly, the title of the report is requested. This text is displayed as the file title and in the header

Reports Tools Ribbons 33.png
Reports Tools Ribbons 34.png

Then for each existing Layout,

for each opened Windows, the following page is appended:
Reports Tools Ribbons 35.png

Print all results (single)

This function allows printing all channel results in a comprehensive report, without requiring the setup of any template. The procedure is the same as the All windows report.

Reports Tools Ribbons 36.png

This function is useful for multi-analysis and multi-channel measurements report. It generates automatically a report with all the acquired and analyzed data. The user select the type of result to be printed be displaying at least one of the results in one layout of the current setup.

The function scans each layout to get the plug-in (FFTx, SOAx, OCT…) and the result type (Spectrum, RMS, trigger block…) of the first trace in each window (reference trace). Then it plots the same result type for each channel of the corresponding plug-in.

As an example working with inputs 1 to 8 connected to FFT and recorder with the following layouts:

Layout 1
  Window 1: Front-end RMS input 1 to 8
  Window 2: Recorded signal input 4 and 8
Layout 2
  Window 1: FFT Average spectrum input 1
  Window 2: FFT Trigger bloc input 1

The All results automatic report will print the following graphs:

Layout 1: Window 1 RMS level: Inputs 1 to 8 (8 plots)

Layout 1: Window 2 Recorded signal: inputs 1 to 8 (8 plots)

Layout 2: Window 1 FFT avg. spectra: inputs 1 to 8 (8 plots)

Layout 2: Window 2 FFT Trigger bloc: inputs 1 to 8 (8 plots)

The format of the reference trace is applied to each corresponding plot. In the case of cross function the reference trace will be used as the reference for each result (FRF, Coherence, etc.)

Note: the report format is the same as the All windows one

Print all results (compare)

The compare version of the print all result function allows comparing every measured results with a reference one.

Reports Tools Ribbons 37.png

In this case the reference trace will remain displayed while the other results are plotted within the same graph. This method scans the result exactly as the single version except it shows 2 traces per graph in the report.

Considerations for All windows and All results(x) automatic reports

The report generation is based on the content of the saved workbook. If your workbook has been changed without saving it (CTRL+D or Save project) the content of the report file will reflect the last saved workbook content.

The report is based on predefined templates. You may adapt these templates in order to change contents (ex: your company logo, or add specific setting or marker).

The original templates are located in the NVGate installation directory \ Template library. Copy the corresponding folder (All windows or All results) from this directory and paste it in the NVGate Data\ template library. The pasted file will be taken in account instead of the original ones.

The report generated with these methods may be updated from the NVGate GUI: Open the report file, select it from the report\active file group in NVGate and press Refresh button.

Batch measurement

The Batch measurement function allows printing all the saved results of a set of similar measurements. It is adapted to the exploitation of measurement campaigns. The batch measurement report is also used to format a set of measurements with the same presentation layouts.

Reports Tools Ribbons 38.png

The inputs are:

  • A set of saved measurements
  • A reference layouts
  • A Word™/Excel™ template

The first operation consists of setting up one measurement in order to adjust the graphs format. Select one measurement and modify/enrich the layouts: graphs, scales, markers, windows/layout name, comments and properties. Click on Home/Start/Edit measurement button and save the edited measurement.

Secondly, create a Word™ template which fits the edited measurement. See the [Reference manual Vol. 3 Reports, Tools & ribbons] for instructions.

Third, select the measurements to be printed. Click on the Report/Automatic reports/Measurement batch button. The batch report selection dialog is showed (NB: it may take a few second to display if your project manager contains lot of projects/measurements).

Reports Tools Ribbons 39.png

This Dialog is divided in 3 areas, one for each input parameters and one for the output files

1. The selection of measurements to be printed selection.

2. The format to be applied on the processed measurement data (Layouts of a measurement from the Project manager)

3. The Word™ template to use for each generated report

4. The output options; directory and file name.

Last, print the reports. By selecting "Save layouts in measurements" each processed measurement will be updated with the format layouts. When these measurements are edited, the graph presentation is then homogeneous and corresponds to the report contents. By selecting "Discard layouts from measurements" the measurement layout are not modified.

Data selection

The measurements selection is helped by a search engine which filters the project manager measurements according to their properties.

The "measurement" frame reflects the project manager content. It is possible to expand or collapse the projects. The displayed measurements correspond to the following criteria:

  • One of the active properties matches the search text,
  • The measurement is already selected.

It is then possible to make mixed selection from various criteria. The properties are activated/deactivated (i.e. included in the search process) by selecting it with the button at the right of the search text.

Reports Tools Ribbons 24.jpgIt is also possible to mask/show the properties columns by right clicking on the header. The column order can be changed by drag and dropping one column to its new location.

Reports Tools Ribbons 40.png

The measurements are sorted by column content (alphanumerical sort) by left clicking on the column header.

"Active File" group

This group is used to select which file will be used for report and to update/print it.

The file must be opened and one of the following; Word or Excel (2003, 2007 and 2010).

To select the file, move the mouse over the File selection combo-box, the software will check the opened file on the computer a fill up the list. It is then possible to select the working template.

Reports Tools Ribbons 41.png

Building up a template

The Reports tab and others parts of the NVGate GUI are available to create a template or even to update an existing one for your reports.

The operations are based on the use of Drag & Drop; Select an item from NVGate and drop it into the template. The software will add a TAG in the target file and then update it with the corresponding NVGate data.

Example: To add a graphical result(s) into a word document, click on the corresponding window area, then drag & drop it at the chosen location in the template:

Reports Tools Ribbons 42.png

While selecting an OROS Item for reporting, an icon is displayed on the cursor to confirm:

  • this item is droppable in the report,
  • the used format (drop style) in the report

Any text, image, table, link can be used in the template to enrich the report with results interpretation, corporate data, and others.

NVGate items are identified by a tag in the template. The tags are editable in Excel cells, hidden text in Word (apply the mode to see the tags) or replacement text for the images (select image format and then replacement text).

Example of tags:

  • [NVGate Graph Layout1 Window1]
For a window
  • [NVGate Data ActiveTrace Layout1 Window1]Table[/] 
 For a result dataset
  • [NVGate Setting 1 1 3 Label Value Unit]Range pk 10 V'[/]
 For a setting
  • [NVGate CurrentMeasurement Comments]'My comments here [/]
 for a measurement comment.

The tag must be kept complete i.e: the last part: [/] has to remain associated to the tag without carriage return between except for the multi-line reports. As soon as data are deposited in a template their format is 100% free. Size, color, font, location, insertion, etc… can be changed to ensure a coherent page setup with existing document or complies with a company charter.

Removing the tags will definitely remove the link between NVGate and the template (i.e. the item content is no more refreshed)

Available items for report

Most of the information that can be added to a template comes from the NVGate windows and analyzer setting trees (ASB and ASV). Drag & drop the selected Item to the target file in order to add the corresponding tag (and refreshable data) to the template.

Reports Tools Ribbons 43.png
"Drop style" group

This group allows defining the format of the data in the report file. Indeed, analysis results can be exported as data or graph as well as a setting format includes its name or units.

Reports Tools Ribbons 44.png
For results
  • Graph will deposit an image of the dragged windows in the same way as the "copy/paste graph"
  • Active Trace will deposit a table that contains the active trace data (X and Y) in the same way as the "copy/paste data/active trace"
  • All Traces will deposit a table that contains all traces data (X and Y1, Y2, Yn…)

Note: advise not to use the Active Trace or All Traces for narrow band spectra within Word documents. It leads to a long process into Word.

For settings
  • Label/Value/Unit will deposit the dragged setting in the described format. E.g: for the sensitivity of a channel;
  • Label = Sensitivity (depending on the NVGate language)
  • Value = 10m
  • Unit = V/g (depending on the active preferences)
  • Value (SI) will deposit the dragged setting value in the SI units (m, A,V, s, etc…). This options force the value to be expressed in SI.

The settings export is useful to build tables for the front-end or analyses setting in the report. Example:

Input # Label Sensitivity Transducer
1 Body Top Acc 10 mV/g PCB 35456
2 Cyl 1 pres 500 nN/m² PRS 33
Ext 1 Torsion shaft1 1024 pulses/rev OROS tach.

Filled by NVGate reporting

For front-end
Reports Tools Ribbons 25.png

The Identifiers drop down button allows choosing one of the front-end input categories and deposit the corresponding table of settings in the report. Available tables are:

  • Dynamic Inputs: Inputs
  • Parametric inputs: DC and Aux DC inputs
  • Trigger/Tach.: Ext. Synch (including the Aux ones)
  • CAN parameter
  • Player tracks (include all inputs categories)

The tables are filled in the report only if content exits (i.e.: the corresponding inputs or tracks are activated). If there is no corresponding content, the table is not visible.

The result will be as follows:

Reports Tools Ribbons 45.png

Note: you may adjust the table format into the report using the text orientation and adjustment for better results. OROS recommend using the landscape orientation for the report page which contains tables.

"References" group

In addition to the actual measurement setup and result data, a measurement must be identified and detailed by meta-data. This group provides such information to be inserted in the report.

The project and measurement identification allow locating the data in your computer or network. The date and comments remind the local context of the measurement. The user name is useful to check with the operator in case of misunderstanding.

Reports Tools Ribbons 46.png
Including properties in the reports
Reports Tools Ribbons 23.png


The report toolset of NVGate allows inserting the properties values in the reports.

The properties tags are made available from the Report/References/Project and Measurements buttons.

Select More… from the corresponding Item, the following dialog is displayed.

Simply drag & drop the selected item to the Word™ or Excel™ file in order to get the current project or edited measurement properties value updated in the report

By default the measurement and project contains predefined properties:

  • The OROS properties are automatically filled by NVGate: Date, Author, Protection, Project name, Signal location and Number and type of saved results.
  • The OROS user properties are already created by NVGate. Their values, but must be filled by the operator: Comments, Site, Installation, Intervention, UUT, Serial number, Measurement type and Default type

The Users properties are created and filled by the operator while saving or by editing the properties. Their availability in the reports depends on their creation on your computer.

Automatic query

Some information or data does not have a place to be saved in a noise and vibration analyzer (e.g: unit under test S/N or duration of warm up). For this purpose NVGate7 propose to insert systematic queries in the report process reports. When a query exists, it will be asked to the operator and its answer will be inserted in the report.

Operations: Click on the Automatic query, a dialog is displayed:

Reports Tools Ribbons 47.png

The query can be issued (dropped) in the report document as many time as required. The question will be raised only once for each different query.

Auto increment row on Reports

It is now possible to add multiple acquisitions in one report. Typically designed for test of components set or assembled parts; such as end-winding or production quality check, this new feature operates with Excel reports.

Reports Tools Ribbons 48.png

The basic idea is to increment the position of the results to the next empty row at each report refresh. For such purpose the standard report capabilities now offers an auto-increment row option. When this setting is activated the drag & drop tag in the report will include the auto-increment.

Reports Tools Ribbons 49.png

This function works with any item dropped to the Excel report (markers, data, graphs, settings, etc…).

Getting the frequency, amplitude and phase of a set of components (bump test) is now fast and secured using the auto-incremented marker table coupled with a sequence for the identification data.

The following example fills the test report of an end-winding bump test. The remote control user field settings have been used for measurement identification (blade # & side). A sequence is activated to update these settings for each bump. A peak marker has been used to collect the frequency and amplitude of each bump test.

Reports Tools Ribbons 50.png

Refresh report on end of analysis

Once again OROS is enhancing your efficiency during measurement and analysis. This time we added a simple button which directly puts your result in the current opened report. By selecting this option no need to think about refreshing your report, it will remain up-to-date at any time.

Reports Tools Ribbons 51.png

Table format on Excel reports

Adding marker or inputs tables in an Excel report is a popular function of the NVGate report mode. It is now possible to define how the NVGate table will be arranged in the Excel sheet.

Reports Tools Ribbons 52.png

In the following examples we have 3 FRFs (1 hammer, 1 tri-axis accelerometer) per measurement point. We measure the highest peak amplitude, frequency and damping ratio on all FRFs at each measurement point.

The table format is governed by attributes in the NVGate Tag in the report file. After the drag & drop of the table in the report file, you can insert the following attributes<ref>To be inserted between quotes inside the tag brackets.</ref>

Flattened table

The first arrangement allows transposing the table in one unique line. This is useful with the auto-increment function when you are using multi-line table (ex: multiple traces) for each acquisition.

Regular report will provide this:

Reports Tools Ribbons 53.png

By adding the "TableStyle=Flat" to the NVGate tag:

[NVGate MarkerTable FRFs FRF "MarkerType=Peaks" "TableStyle=Flat"]Table[/]

The result is changed as follow:

Reports Tools Ribbons 54.png
Select columns

This arrangement allows selecting which columns to be printed in the report. For example if you do not need the interpolation information add the "TableColumns= " to the NVGate tag:

[NVGate MarkerTable FRFs FRF "MarkerType=Peaks" "TableStyle=Flat" '"TableColumns=1,2,4,5,7,8,9"']Table[/]

Assuming the column 3 and 6 are for the interpolation indicator, the table will look at:

Reports Tools Ribbons 55.png

Reports page setup

Reports are dedicated to be viewed out of the analysis software (electronic documents, paper, e-mails), then the NVGate dedicated color may be not suitable for this destinations.

Specific colors and traces widths preferences are used for the graphs in reports. Moreover, 2 different profiles allow managing both colored and black and white reports.

Reports Tools Ribbons 56.png

The Print color profile is saved in the active user preferences set. The changes apply to the active reports at each refreshment time.

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