LVis Wiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== THE USER INTERFACE ======
The LVis user interface has four major parts:

- [[Tool bar]]
  - [[Menu bar]]
  - [[Configuration bar]]
  - [[Desktop]]
<WRAP todo>**IMAGE MISSING**</WRAP>

===== Tool Bar =====
The tool bar provides quick access per mouse click to different actions within the application. The actions are represented using icons. These actions are not always possible in the current program status. In such cases, the icon is highlighted in gray (no colors).
<WRAP important>
**Important**\\
If the actions refer to measurements (e.g., Start, Stop, Analyze, etc.), then the icons are only active if measurements are open on the [[desktop]]. If measurements run in the background, meaning that they are not shown on the desktop, then the respective actions can only be activated in the [[configuration bar]] by directly selecting the detector. If several measurements are open, the actions (icons) in the tool bar refer to the currently active measurement!
</WRAP>
The following actions can be initiated via the tool bar.

<WRAP todo>**IMAGE MISSING**</WRAP>

==== Open File ====
Clicking the folder icon in the tool bar automatically opens the basic directory of all measurements, which is defined under [[Settings]]. Then you can open a .LVM file stored there.
<WRAP todo>**IMAGE MISSING**</WRAP>
This action is identical to the “Open file” menu item in the [[menu bar]] under “File”. As LVis can in general manage several instances at the same time (several detectors can measure at the same time, several spectra can be opened at the same time), this action is always possible, independent of the actual program status.

==== Save File ====
Via the floppy disc icon, you can save an open project (spectrum, spectrum with adjusted analysis parameters or spectrum with analysis parameters, etc.) can be saved as an .LVM file
<WRAP important>
**Important**\\	If a name is assigned for this file in the parameter set, then the file will be saved without confirmation prompt into the basic directory, in a folder with the detector name, and there in a folder with the name of the parameter set.
</WRAP>
If no name is entered, you must define via a dialog where and under which name the project should be saved (corresponds to the Windows action “Save as”).
The possibility to save a project is of course only available, if a spectrum or a measurement is open. 
==== Analyze Active Spectrum ====
Using this icon, an active spectrum (hence a spectrum, which is shown on the desktop and is active and was started parameterized, can be evaluated using the parameters defined at the beginning of the measurement.

If for an active spectrum on the [[desktop]] the analysis parameters are not available (since it was started manually) you will have to define all parameters manually as well.

Normally this icon can be used to check a running measurement by a preliminary analysis (e.g., if the limit of detection is reached) or to analyze a finished measurement.

==== Start Spectrum Acquisition ====
In order to start spectra acquisition without parameters, click on “Start spectra acquisition”. This is possible if the detector (or the memory content of the corresponding electronic measurement equipment) is active and shown on the [[desktop]]. In addition, it is possible to continue a stopped spectra acquisition.

If the memory content is not shown on the desktop, then you can only start spectra acquisition from the context menu of a detector in the [[configuration]] bar. 
<WRAP important>
**Important**\\
For this action it is not important whether the spectrum was started in the memory of electronic measurement equipment with measurement parameters and has already been evaluated or if the memory is empty. The spectrum currently stored in the memory of electronic measurement equipment is simply continued.
</WRAP>

==== Stop Spectrum Acquisition ====
Using this action, you can stop a spectrum acquisition started without parameters (not parameterized). Parameterized started measurements can only be stopped via the context menu of a detector in the [[configuration bar]] (Choose “Analyze” — after saving the measurement you will be asked if the acquisitions shall be stopped). This action is only available for spectra, which are currently shown on the [[desktop]] and are active.
==== Delete Spectrum (manually acquired spectra only) ====
This command clears the detector memory (hence, the spectrum) corresponding to the currently active spectrum window on the [[desktop]]. This only applies to spectra acquisition started without parameters. It does not matter whether data acquisition is currently underway place or not.

==== Login (green “padlock” icon) ====
Click on the green “Open lock icon” to [[unlock]] protected functions of the application. This requires the [[administrator password]]. If the administrator is logged in, this icon is highlighted in gray. 
==== Logoff (red “padlock” icon) ====
If the “Closed lock icon” is active (red) this indicates that the application is currently [[unlocked]]. Clicking this icon locks the program.
==== Peak Search ====
Using this icon, you can start a peak search in the currently active [[spectrum window]]. The results of a peak search started via the tool bar are subsequently shown in the spectrum. However, they will not be saved and cannot be used for a report. They are only used for a quick verification of the energy calibration. In order to distinguish between analysis results, the peak description always displays a question mark next to the nuclide name. The illustration of the peak search results can be hidden by repeated clicking on the icon in the tool bar.
<WRAP todo>**IMAGE MISSING**</WRAP>
The peak search basically corresponds to a GammaVision WAN32 analysis without library (or a library without content), hence to a pure Mariscotti peak search.
<WRAP important>
**Important**\\
GammaVision requires a library without entries for this peak search. The used library file Null.lib can be found in the \Config folder under the LVis program directory. Do not delete or change this file, otherwise peak search will not function anymore.
</WRAP>

All other peak search parameters required for peak search are different, depending if it is a [[manually]] or a [[parameterized]] started data acquisition.

If the measurement was started using a parameter set, then the [[parameters defined]] in the Spectrum section of the [[Analysis]] tab apply:
<WRAP todo>**IMAGE MISSING**</WRAP>

The results of the peak search are subsequently compared with the entries in the [[Analysis library]] defined in the parameter set. The nuclide, whose peak energy is closest to a found centroid and which is inside the specified [[match width]], will be assigned to the peak.

If data acquisition was started manually, the parameters adjusted in the Default.sdf file apply and the comparison is performed using the suspect library defined in the global settings.
<WRAP info>
**Info**\\
In case of parameterized spectra, this peak search corresponds to the automatic peak search within the scope of spectrum analysis (see [[Peak search results]]).</WRAP>

==== Change Sample ====
This button is only active, when a [[sample changer controlled by the ORTEC hardware I/O]] is defined for the currently selected detector. Clicking this button changes the output level on the “CHANGE SAMPLE” output of your ORTEC MCB.
==== SampleSetEditor ====
This button is only active when a [[sample changer]] is defined for the currently selected detector. Clicking this button opens the editor for the definition of a set of samples (sample batches), the LVis SampleSetEditor.
==== LabJournal ====
Clicking this button opens the [[LVis LabJournal]].
===== Menu bar =====
The menu bar consists of the following menu items:

<WRAP todo>**IMAGE MISSING**</WRAP>

Similar to all Windows applications, existing program files (.LVM files) can be opened here. Furthermore, a list of recently used files is provided and you can exit the program. In addition the Crystal Reports Designer Report Editor can be started from here. However this is just possible when no other measurement is active on the LVis desktop (see left screenshot). If an acquisition is currently being acquired or an existing .LVM file is displayed on the LVis desktop the menu is somewhat different because it is now possible to save the active document or save it as a different file (see right screenshot).
<WRAP todo>**IMAGE MISSING**</WRAP>
==== Report Editor ====
LVis has a built in Report Editor based on the Crystal Reports Designer. The Report Editor can be used to modify existing report templates. Typically all your report templates are located in your LVis database subfolder \Reports10xx (xx = 31 German; xx=33 English; xx= 36 French). Select the *.rpt file that you would like to modify and click open.

<WRAP todo>**IMAGE MISSING**</WRAP>
<WRAP important>
**Important**\\
The names used for the report templates located in your respective LVis database\Reports10xx folder are critical! Do not delete these files. Before you modify one of these reports, don’t forget to make a backup of the original ones. It is possible to add templates for the analysis reports which can then be selected in the respective menu on the parameter sets. All report templates that have a name starting with “Standard” will be listed as available analysis report templates on your parameter sets.
</WRAP>

The selected file will be opened in the LVis Report Editor.
<WRAP todo>**IMAGE MISSING**</WRAP>
Here you can modify your reports. Since the Report Editor is part of the Business Objects Crystal Reports 2011 Developer software that we use for designing the reporting we included the designer in LVis. It works the same way as Crystal Reports itself but offers some limited functionality. Because of the complexity of this software package it is not possible to describe all its features in this manual. The Report Editor is more intended to be used to do minor changes like new headings or activation/suppression of individual subreports.

You can preview your modifications and save your new report templates by using the buttons on the bottom bar of the editor.

If you want a completely new, customized report, contact your local ORTEC representative.

==== View ====
In the “View” menu you can select, whether you would like to display the [[tool bar]] and the “status bar”. By default both are active. The status bars is used to display error messages and can be deactivated. 
==== Windows ====

==== Settings ====
=== Global Settings ===

=== Pre-Defining Sample Size Units for Parameter Sets ===

=== Pre-Defining Users, Sample Descriptions, and Sample Locations for Parameter Sets ===

==== Editors ====
=== Analysis Library Editor ===
=== Correction Library Editor ===
=== Peak Background Correction Editor ===
=== Geometry Correction Editor ===
=== Materials Editor ===
=== External Database Editor ===

==== Admin ====
=== Login and Logoff ===
=== Change Password ===
=== Set Start Password ===

==== LabJournal ====

==== Help ====

===== Configuration bar =====

==== Detectors ====
=== Detector Context Menus ===
=== Adding Detectors ===
=== Removing Detectors ===
=== Reconnecting Detectors (eg after replacement of hardware) ===
=== Detector Configuration ===
=== Detector Calibration ===

==== Parameter Sets ====
=== Create and Delete Parameter Sets ===
=== Edit Parameter Set ===
=== Copy Parameter Set - Insert Parameter Set ===
=== Save Parameter Set — Load Parameter Set ===
=== Import Parameter Set from existing .LVM-file ===

==== Reference Sources ====
=== Creation of a New Reference Source ===
=== Save and Load Reference Sources ===
=== Edit Reference Source ===

==== Buffer ====
=== Spectrum Summing – Spectrum Subtraction ===

==== Multi-Detector Configurations ====
=== Creation of a Multi-Detector Configuration ===
=== Starting a Multi-Detector Configuration ===
=== Edit or Delete a Multi-Detector Configuration ===

==== Save and Restore the LVis Configuration ====
=== Restoring a Configuration ===

==== Currently Open ====

===== Desktop =====
==== Spectrum Window – Live Detector Display ====
==== Measurement Presentation ====

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International