NVGate Project manager

From OROS Wiki
Revision as of 12:05, 12 January 2022 by Lmagimel (talk | contribs) (→‎Signal)
Jump to navigation Jump to search


Introduction

The Project Manager is made up of 3 main parts: The Workbook, the Project and the Measurement.


 

 

Workbook

 

Project manager

The Project Manager is used to store all of your projects, results, and measurements. There are several display options that enable you to show or hide certain items. You can display some results with drag and drop.



Project

 The project is the highest level of the organizational structure. It contains at least one workbook and can receive an unlimited number of measurements. The project has therefore two main aspects:

  • Configuration of the analyzer and the interface using the workbook
  • Storage of data using the measurements

There is always one active project. This is this project that receives the new measurements. The project workbook configures the analyzer. To open a project, select the open command in the pop-up menu associated with the project item.

Other option

  • Save: This command is available only on the current project. It saves the project workbook.
  • Save as: This command is available only on the current project. It saves the project with a different name. It is a way of copying the current project.
  • Rename: This command is not available on the current project (Use "Save As" instead). It may be used to change the name of the project.
  • Open and Load setup This command open the project adn load a setup. The project becomes the current project.
  • Remove: This command removes the selected project. The data contained is lost permanently.


Workbook

 The workbook is designed to manage the analyzer and software setup. The table below gives the details of the functions managed by the workbook.

Analyzer setup The value of all analyzer settings
Layout All windows displaying results are stored in layouts.
Control panel The personalization of the control panel.
Save setup All results that must saved when a new measurement is created.
Report setup All information regarding report generation.


Saving

The project workbook is saved when the project is saved. This can be done several ways:

  • Select the "Save" command in the pop-up menu associated with the project item.
  • Select the "Save project" command from the file menu.
  • Use the shortcut "Ctrl + D"

A workbook is created when a measurement is created. This workbook is the copy of the project workbook at the time the measurement is created. This allows you to recover the settings used for a measurement possibly reuse them.

  • Loading

The workbook is automatically loaded when a project is loaded. It is also possible to load the content of any other workbook to the workbook of the active project. This load can be complete or partial and can be done by command in the pop-up menu associated with the workbook item.

  • Partial Load This command is similar to the "Load" command, but only parts of the workbook are loaded.

The parts of the workbook that are not selected remain unchanged.

  • Reload or "Partial reload" command in the pop-up menu associated with the active workbook item. In this case, the last saved copy of this workbook is used.


The parts of the workbook that are not selected remain unchanged.

  • Change workbook command in the pop-up menu associated with the project item.

This allows you to select any workbook from project database or any workbook template.



  • Save: This command is available only for the current project workbook. This command saves the workbook.
  • Save as Model: This command is available only for the current project workbook. This command saves the workbook in the workbook library. This makes the workbook available, however the project database will change in the future. The workbook models are available in the "Project\Change workbook" command and in the "New Project" command.
  • Add Layout: This command is available only for the current project workbook. It creates a new layout (with the desired name).
  • Remove Layout: This command is available only for the current project workbook. It removes the selected layout. This destroys all the windows that belong to this layout.
  • Properties: This command gives general information about the workbook.


Active Items

When the action "Load" is performed for an item, then the item is active (the name of the item is displayed in bold).

An item is active when it is bold. The 4 items that can be active are:

  Project: This is the current project. When the analysis mode is "measurement mode", the workbook for this project is active.
  Measurement: This is the current measurement. When the analysis mode is "result mode", the workbook for this measurement is active.
  Workbook: This is the current workbook. It can belong to the current project or the current measurement depending on this analysis mode.
  Layout: This is the current layout. The windows displayed belong to this layout.


Layout

 The layout is the part of the workbook that contains the graphic windows. There is no limitation of number of layouts, but the workbook always has at least one layout.

The windows displayed are the active layout windows. There are several ways to select a layout:

  • Double-click on the layout item in the project manager.
  • Select the load command in the pop-up menu associated with the layout item in the project manager.


  • Use the shortcut "Ctrl + Space bar" to switch to the previous active layout.
  • Use the shortcut "Ctrl + Maj+ Space bar" to switch to the next the layout

Notes: The layouts are associated with the analysis mode (Measurement or Result mode) and are available only in the correct mode. Therefore, a name used for a layout in the measurement mode will not be available in result mode.

  • The selected tabulation of the control panel is related to the layout. This is designed to minimize the selection in the workspace.


  • Rename: This command is used to rename the selected layout.
  • Properties: This command gives general information about the layout.

Result Template

  This item appears when results template are added to the project. They can be added from the Tab "tools": Mask or from the "Add to result template" menu in a window.

  • Displaying: To display the result template, Double-click on the item or select the "Display" command from the pop-up menu associated with the item.
  • Editing: To edit and modify the template result, use the Tools\Result Template\Main menu or the "Edit" command of the pop-up menu associated with the item.

  or  

Measurement

 This item is designed to store data. The data can be of two types:

  • Signals coming from the recorder
  • Results coming from an analyzer (FFT, Octave, Waterfall...)

A measurement always contains one workbook, which is a copy of the workbook used to create the measurement.


  • Edit: This command loads the measurement. The analysis mode is then set to "Result mode".

The Result editor is used for post-analysis of saved results. It allows to switch between 2 measurement workbooks in order to compare the results.

  • Rename: This command is used to rename the selected measurement.
  • Remove: This command removes the selected measurement. The data contained are permanently lost.
  • Properties: This command allows viewing or modifying the measurement properties in order to be used for future data mining.
  • Collapse items: This command collapses the entire branch of the selected measurement. Only the measurement item remains visible.
  • Expand items This command expands the entire branch of the selected measurement. All items (workbook, results...) are expanded and made visible.

Imported measurement

  This item comes from the import of a result or a signal file.

The behavior of this item is similar to the behavior of a usual measurement item. It differs only in that the workbook associated with the measurement is empty. There is no information about the analyzer settings, or about the layouts and other workbook elements.

Result group

  This item gathers all results of a measurement. The ctions that can be performed from this item are:

  • Remove: This command removes all the measurement results. The data is permanently lost.
  • Export: Exports the results in an external format (UFF…). This can be done from the pop-up menu associated with the item.

A command to export the results of several measurements at the same time is also available in the "File" menu.

For more details about the export formats, see the "Export" topic.


  • Properties: This command gives general information about the results.

All the plug-ins that have provided results are listed, with their corresponding number of results.

  • Display: Displays all the measurement results. One window per type of result is created, limited by the maximum curve that the window can contain.

Result

This type of item can belong to a Result group item, a Ref. Result Item or a Template Result item.

The icon associated with the item indicates the results type. The table below lists the different icons that can be found.

  Temporal result (triggered block, weighted block...)
  Spectral result (Spectrum, Order Spectrum, FRF...)
  Scalar result
  Profile result (scalar profile, order profile...)
  3D result (Waterfall of spectrum, triggered block, octave spectrum...)
  Octave result
  Coherence result


The main action that can be performed from this item is to display the result.

A new window is created, containing the result. This can be done from the pop-up menu associated with the item. This can also be done by double clicking on the item.

  • Display: Displays the selected results in a new window.
  • Remove: This command is available only when the measurement is loaded. It is used to remove the result from the measurement.
  • Properties: This command gives general information about the result.
  • Add to template result: This command adds the selected result to the template results of the current project.

Signal

  This item represents a signal file generated by the recorder. Depending on the analysis, the item points to file located on the PC or the analyzer hard disk.

Signal location

An icon to the left of the Signal icon indicates the location of the signal file. The table below explains the meaning of the 6 icons that can be found:

The file is only on the analyzer hard disk.
The file is only on the PC hard disk.
The file is on both the PC and the analyzer hard disk.
The file is on the PC and the analyzer is not connected (The file might also be on the analyzer hard disk).
The file is not on the PC and the analyzer is not connected (The file might also be on the analyzer hard disk).
The file is not found on the PC or on the analyzer hard disk.


Loading

Loading the file in the player:

Once loaded to the player, the signal can be displayed and post-analyzed. To load the file to the player, select the command "load in player" in the pop-up menu associated with the signal item. The signal file can also be loaded and displayed at once by double clicking on the signal item.

When the analyzer is connected, only files located on the analyzer hard disk can be loaded.

When the analyzer is not connected, only files located on the PC hard disk can be loaded.

In order to post-analyze the selected signal, a shortcut is available by right-clicking on the specified signal.

Uploading/Downloading

Upload\Download:

Used to transfer files to\from the analyzer hard disk from\to the PC hard disk. This can be done from the pop-up menu associated with the signal item.

A command to transfer several files at the same time is also possible.

Exporting

Export:

Exports the signal file in an external format (wav…).

A signal can be exported only when it is located on the PC hard disk. The export can be done from the pop-up menu associated with the signal item.

A command to export several files at the same time is also available in the "File" menu.

For more details about the export formats, see the "Export" topic.

Item status

Workbook

Attachments

Add extra files on a folders for each Item (Project, Measurement and Model) that can hold various files not directly managed by NVGate. Ex: Voice record, Word pad, pictures, scheme, planning, etc…

Selecting Attachments…on the contextual menu (right click) of an Item of the project manager opens the Windows explorer in the corresponding Item directory/Attachments.

The files deposited in this directory will be transferred with the Items during share/collate actions.

Advanced Rules

The way a new measurement is created is defined in the Save Setup dialog box using the Save Option property.

There are some specific cases where the behavior defined by the Save Option must be overridden:

  • When the recorder is stopped, a measurement is created, overriding the "Do not save" choice.
  • When the recorder is stopped, the measurement takes an specific name, overriding the "In default measurement" choice.
  • For multi-analysis, the results corresponding to the different plug-ins are saved in separate measurements if the plug-ins do not stop simultaneously. While NVGate is Running (meaning that at least one plug-in is still running), the measurements are saved with "With name confirmation" unless the Save option choice is "Do not save".

Recovered project

Each time NVGate is not closed correctly and a default measurement is present in the project, the project is automatically loaded when NVGate is launched, to ensure that no data is lost. If the project was the "Default project", then to the user is prompted to rename this project "Recovered project".


Contextual menu

The contextual menus are accessible by right clicking on the area.

General menu: Appears by right clicking anywhere on the Project Manager background.


  • Remove project: This command opens the following dialog box.

You may also remove one or several projects from the project base. The current project cannot be removed.

  • Save active: This command saves the current project and, if there is a measurement loaded, it also saves the current measurement.
  • Options: This command opens the following dialog box:

This option is used to modify the way the project manager is presented.

  • Project: It is possible to hide projects that do not belong to the current user. This is particularly useful when there are multiple NVGate users on the same PC.

The project can be sorted alphabetically, chronologically or inversely chronologically.

  • Measurement: The measurement can be filtered by keyword. The keywords are assigned to the measurement when it is created, or can be changed in measurement properties. This option is very helpful when organizing measurement campaigns.
  • General: It is possible to hide all the inactive workbooks and to delete the measurement level. The table below illustrates the differences:
  • Save in user preferences: These settings can be stored in the user preferences and can be set in the preferences.


Clean up

The purpose of the following dialog box is to accelerate the cleaning of the project base. It is used to remove projects or measurements.

  • Project: The list contains all projects except the current one. Once a project is selected, it is possible to remove the full project or to select a measurement to remove. If several projects are selected, it is then only possible to remove the selected project.
  • Measurement: When one project is selected, the list of project measurements is displayed and available to be removed.

Collapse all items: Collapses all the branches of the project manager tree. Only the project items are visible.

Expand all items: Expands the entire branch of the project manager tree. All the items of the tree are visible. This can make the tree very large.

Auto width: Adjusts the width of the tree to the widest branch, so that every item is fully visible.

Group properties
  • Properties: This command gives general information about the project.

It is possible to modify the project attribute. When "Read-only" is selected, it is not possible to modify the project. When "Read-only to all other users" is selected, the project cannot be modified by another user, but can be used freely.

"Allow access to" property must be set on "All users" to enable restricted users to use this project.

A comments area is available to add information. (Use "Ctrl + Return" to start a new line).

Protection

An icon can appear to the left of the project, workbook, layout and measurement icon. When there is no icon, this means that the item is not protected. The table below explains the meaning of the 3 icons that can be found:

The item is in read-only. This protection can be removed using the properties command by unselecting the read-only protection.
The item does not belong to the current user and is protected by its user. The current user cannot modify this item.
The item does not belong to the current user, but is not protected. The current user can freely use this item.