UserManual EN
UserManual EN
User Manual
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Table of Contents
1 ABBREVIATIONS ................................................................................................................................................... 4
3 INTRODUCTION .................................................................................................................................................... 4
4.1 SAVE/EXPORT...................................................................................................................................................... 6
4.1.1 Exporting to local disk... ............................................................................................................................. 7
4.1.1.1 Export DICOM files to local disk .............................................................................................................................7
4.1.1.2 Export images in JPG format to local disk................................................................................................................9
4.1.1.3 Export series in AVI format to local disk ...............................................................................................................10
4.1.2 Copying images to the system clipboard ................................................................................................... 10
4.2 SETTINGS ........................................................................................................................................................... 11
4.3 VIEW ................................................................................................................................................................. 12
4.3.1 Basic viewing preferences ......................................................................................................................... 12
4.3.2 Viewing preferences for reference lines .................................................................................................... 15
4.4 HELP .................................................................................................................................................................. 16
2
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
9 THUMBNAILS PANEL......................................................................................................................................... 56
11 ACKNOWLEDGMENTS ...................................................................................................................................... 57
3
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
1 Abbreviations
Abbreviation Description
3 Introduction
The following chapters explain the user features available from the LocalEye Viewer's Graphical
User Interface (GUI) and how to exploit the capabilities of this system.
The LocalEye Viewer's GUI is composed of the following main panels and toolbars:
Main menu bar: this top menu bar allows accessing the main functionalities of the viewer.
Top, and left and right toolbars: these toolbars contain buttons which correspond with actions
available within the viewer. Example of such actions are: patients/studies search, association of tools
4
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
with mouse buttons, image manipulation functions, display layout configuration functions, reporting
functions, etc.
In LocalEye Viewer’s default configuration, there are no buttons configured for the left toolbar, so the
GUI will appear with just a top toolbar and a right toolbar.
Study panel(s): each study loaded in LocalEye Viewer is displayed in its own dedicated study panel.
By default, multiple study panels are arranged in a "tabbed" fashion. However, it is possible to
manually drag the tab title of each study panel to arrange and dock the panel according to the user's
preference (e.g., in a side-by-side fashion). A study panel contains one or more series panels,
depending on the “series tiling” (or series layout) currently set on that study panel.
Series panel(s): each study panel contains one or more series panels, depending on the series tiling
currently set on the study panel. Each series panel contains and shows images belonging to a given
series or sequence. In turn, each series panel contains one or more image panels, depending on the
“image tiling” (or image layout) currently set on that series panel.
Thumbnails panel: this panel displays thumbnail images. The thumbnails may represent the
available series or all available images, depending on the user’s choice. This thumbnails panel can
be dragged (through the panel’s title bar) to a different position within the viewer’ window, and can
be arranged either vertically or horizontally, according to user’s preference.
Bottom bar: this thin bar located at the bottom of the viewer’s window contains several context-
specific tools and information. In the left edge, it shows the currently-active mouse tool. Next to the
currently-active tool, it shows the tool options panel related to this currently-active tool, showing the
options and information related to this tool. Hence, the content of this tool options panel changes
according to the currently-active mouse tool. Then, in the right portion of the bottom bar we can find
the hanging steps / hanging views selection and iteration panel. Finally, in the right edge of the
bottom bar we can find the viewer jobs panel, showing the progress of eventual active jobs within the
viewer (e.g., a loading operation).
The following picture shows a screenshot of LocalEye Viewer's GUI, with the main panels clearly shown:
5
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The following sections provide a detailed description of each element of the GUI, as well as of the related
features.
4 Main menu
4.1 Save/Export
Here is a screenshot of the Save/Export menu:
The functions reachable through this menu allow exporting content (typically, images, but also other DICOM
content) outside of the viewer application.
6
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Through this dialog, user can select which output format to use for the "export to local disk" operation.
7
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
This page can be used to export currently-loaded DICOM images to the local file system, or to save to the
local file system modifications and settings made on images, through the Presentation State or Key Object
Selection DICOM objects.
Through this dialog, user can select which series (among the loaded ones) need to be included in the "export
to local" operation.
User can also choose to select all series pressing the Select all series button or to deselect all series
pressing the Deselect all series button.
On the Export DICOM files to local disk page, you can choose to export the original DICOM files of the series
which have been selected in the top list. You can also choose whether to create and export new
Presentation States for the selected series. Presentation State objects are able to save and store all settings
performed by the user on the medical images, including contrast settings, rotation, flipping, annotations, etc.
They don’t contain the image, but only the transformations to be applied to images. They are the preferred
way to save all modifications and annotations performed on the displayed DICOM images. Usually, the
Presentation State files are quite small in size, so the store operation is efficient. In addition, you can choose
whether to export the selections of Key Images for the selected series: this option allows supporting
persistence of the Key Image information, which can be maintained the next time the study will be loaded.
When the Export as DICOM button is pressed, a Save file dialog is shown, through which the user will be
able to select the path to be used to save the appropriate DICOM files.
8
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
This page can be used to export currently-loaded medical images to the local disk in JPEG format; it allows
selecting which images need to be exported in JPEG format, as well as the quality and resolution of the
JPEG images to be created.
Also, by selecting the Crop images to displayed area option, it is possible to crop images to be exported to
the portion which is visible in the currently displayed area. This option is only available when the export
selection is set to Current image or Current series.
When the Export as JPG button is pressed, a Save file dialog is shown, through which the user will be able
to select the path to be used to save the appropriate JPEG files.
Warning: the supported JPEG export format is a lossy compression format. Even if a “100 %” quality
is specified, the output image is still lossy.
9
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
This page can be used to export currently-loaded series to the local disk in AVI format, as movies; it allows
selecting which series need to be exported in AVI format, as well as quality and frame rate of the AVI movie
to be created.
Also, by selecting the Crop images to displayed area option, it is possible to crop images to be exported to
the portion which is visible in the currently displayed area. This option is only available when the export
selection is set to Current series.
When the Export as AVI button is pressed, a Save file dialog is shown, through which the user will be able to
select the path to be used to save the appropriate AVI files.
10
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The "Copy screenshot..." set of functions perform a real snapshot of the content of the on-screen display
panels, and copy it to the system clipboard. This implies that in this case the images copied to the system
clipboard have the same pixel size as the related on-screen display panels, hence they are influenced by the
current screen resolution and display mode.
On the other side, the remaining "Copy ... to clipboard" functions copy the medical images to clipboard at
their original pixel size / resolution.
The Ctrl+C keyboard shortcut may be used to copy a screenshot of the current image panel to the system
clipboard.
4.2 Settings
Here is a screenshot of the Settings menu:
This menu allows directly selecting a set of preferences on the scope of the operations which can be
performed on the images.
Zoom operations can be applied to a single image panel, to a series panel or to the study panel; whereas
contrast, geometric and enhancement operations can be applied to a single image, to a series or to the
entire study, depending on the user's preference.
11
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
4.3 View
Here is a screenshot of the View menu:
This menu allows specifying several viewing preferences about what shall be displayed and what shall be
hidden on the image panels of the viewer.
The Display stack widget menu item controls display on each image of a widget allowing to quickly scroll
across frames of a series, as well as to enable the "thick slab" mode on the original series, as long as the
series represents a volume inside the patient's body (typically, CT or MR series):
12
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
When the "thick slab" mode is disabled, the user will be allowed to scroll the series by dragging the white
cursor labelled with the image number. Moreover, a double click on the cursor will allow the user to manually
set the frame he wants to display:
The "thick slab" mode can be enabled by vertically dragging the horizontal line located next to the white
cursor:
The thickness of the "thick slab" will vary depending on the dragging operation.
13
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
When the "thick slab" mode is enabled, users will be allowed to change the projection algorithm for the slab
by clicking on the box located underneath the widget (MIP, AvgIP or MinIP algorithms are available). Thick
slab mode can be turned off by double-clicking on the central reference line. Finally, a double click on the
horizontal lines which mark the end of the extent of the thick slab on the widget will allow user to manually
set the slab thickness parameters:
The Display annotations menu item allows enabling and disabling the display of measurement and graphical
annotations over all the displayed images.
The Display orientation markers menu item allows enabling and disabling the display of orientation markers,
normally available on CT and MR images, and sometimes on other kinds of images. If the image orientation
information is present inside the related DICOM image file, the orientation markers will be displayed at the
four edges of each DICOM image. The orientation will be indicated as:
A: Anterior
P: Posterior
I: Inferior
S: Superior
L: Left
R: Right
Warning: the orientation markers are information generated by a software algorithm. As such, their
correctness depends on the correctness of several information stored in the original DICOM
datasets, in addition to the correctness of the implemented algorithm. The viewer itself has no mean
to ensure these input data are correct. Hence, orientation markers shall be checked and treated in a
very “critical” way by the user/radiologist, and any conclusion coming from the orientation markers
shall be carefully evaluated.
The Display rulers menu item allows enabling and disabling the display of on-screen rulers showing actual
distances over the displayed images. The rulers show a short tick every 1 cm on the image, and a longer tick
14
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
every 5 cm on the image. Rulers will only be displayed on images having the appropriate calibration
information inside the related DICOM image file.
The Display grid menu item allows enabling and disabling the display of an on-screen reference grid, which
is shown on top of the medical image(s), like this:
The Grid options menu item allows setting the distance between consecutive lines (i.e., the step) of the grid.
15
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
indicates the location of an image slice (the currently selected image) on another image of an intersecting
plane.
The Display first/last reference lines menu item allows enabling and disabling the display of reference lines
related to the first and last image of the currently selected series.
The Display all reference. lines menu item allows enabling and disabling the display of reference lines
related to all images of the currently selected series.
The following picture shows an example of how reference lines look like on a MR study:
Warning: reference lines are generated by a software algorithm. The correctness of their location
and geometry depends on the correctness of several positioning, orientation and spacing data stored
in the original DICOM datasets, in addition to the correctness of the implemented algorithm. The
viewer itself has no mean to ensure these input data are correct. Hence, reference lines displayed on
the images shall be checked and treated in a very “critical” way by the user/radiologist, and any
conclusion coming from reference lines shall be carefully evaluated.
4.4 Help
Here is a screenshot of the Help menu:
16
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The Online help menu item allows accessing the application’s user manual. A suitable PDF reading software
will need to be available on the client machine in order to ensure proper functionality of this feature.
Pressing the About this software menu item, the “About this software” dialog box will appear, showing
information about the current software version in use:
5 Study panels
In LocalEye Viewer, each loaded study is displayed in its own dedicated study panel, which in turn
contains one or more series panels. The number and layout of series panels contained in the study panel
depends on the series tiling setting (i.e., the number of series columns and series rows), which can be set by
acting on the appropriate toolbar button, as detailed in the following chapter.
Once the study is open, and several series are displayed on screen, you can maximize a given series (thus
switching to 1x1 series tiling and 1x1 image tiling) by double-clicking on it when the Select/Stack tool is
associated with the double-clicked mouse button. Then, when you are done with this image, you can double-
click again on it in order to return to the previous display mode, and all previously displayed images will be
restored on screen.
17
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
By default, multiple study panels (corresponding to multiple open studies) are arranged in a "tabbed" fashion.
However, it is possible to manually drag the tab title of each study panel to arrange and dock the panel
according to the user's preference (e.g., in a side-by-side fashion).
In addition, by right-clicking on the tab title related to a study panel, the following drop-down menu will
appear:
As can you see, this menu allows user to arrange study panels on screen in some different ways: study
panels can be grouped together in a tabbed fashion, they can be tiled horizontally or they can be tiled
vertically.
6 Toolbar actions
Toolbars are now entirely configurable in LocalEye Viewer, through the dedicated section of the
Viewer settings. Hence, toolbars can contain virtually any button associated with any action defined and
available within LocalEye Viewer.
Due to this flexibility, your toolbar(s) may differ also substantially from the toolbars shown in the following
sections of this manual. However, the following paragraphs will describe all the main actions which may be
typically assigned with toolbar buttons, obviously including the actions associated with the default toolbar
buttons configuration.
Here is how the top toolbar and the right toolbar appear in a typical default configuration:
18
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The Patients / Studies toolbar button ( ) can be used to search for available patients or
studies.
If you press the Patients / Studies button, the Find Patients or Studies window will appear, as shown in the
following picture:
19
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Double-clicking on a patient node (only possible with Patient-root view) will cause loading all studies
belonging to that patient. A confirmation for such operation is asked by LocalEye Viewer;
Double-clicking on a study node will cause loading all series belonging to that study;
Double-clicking on a series node will cause loading all images belonging to that series;
Double-clicking on an image node will cause loading just that image.
A powerful search filter is also provided to facilitate the search of a particular patient, study or series.
The user may specify a value for a given search parameter, then press the Filter button: the “Patient / Study /
Series / Image” hierarchy will be filtered and only those nodes matching the search parameter(s) will be
displayed. In particular, the following search parameters are supported:
Patient Name
20
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Patient ID
Patient birthdate
Modality
Study Description
Accession Number
Referring Physician
Study Date
Study Status (Read, Dictated, Transcribed, Report present, Report complete, Verified - some study
statuses are only available when a specific type of reporting is enabled)
Calling AE Title (only available with the “query” integration model)
Called AE Title (only available with the “query” integration model)
You can apply a previously-saved filter (if any) using the Apply saved search filter drop-down list. Also, you
can delete the currently-selected filter, with the Delete preset filter button.
It is possible to clear/reset all the currently-set search parameters by pressing the Clear Filter button. On the
other side, you can reset each individual search parameter by pressing the small “X” button ( ) located
next to each search field.
With the Save current filter as... button you can save the current set of search parameters, and assign an
identifying name to this preset. The newly-saved search filter will be added to the drop-down list located at
the top of this Find panel.
The Load selected button allows loading the selected studies.
Holding down the Ctrl button of the keyboard, you can select several studies at the same time.
If the checkbox Auto-close window upon load is checked, the Find Patients or Studies window will be
automatically closed after a load operation is triggered on this view.
Clicking on the arrow-shaped drop down button located next to the Patients / Studies toolbar button
( ), a drop down menu containing the other studies (both older and newer) related to the current
patient will appear, allowing to speed up the patient's studies search. See the following picture:
21
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
When moving the mouse pointer over each one of the above toolbar buttons, a tooltip text will appear,
providing additional information about the function of the button.
The Associate tool with LEFT mouse button toolbar button ( ) can be used to associate an image
manipulation tool with the left mouse button. If you press this toolbar button, the following drop-down menu
will appear:
22
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The Associate tool with RIGHT mouse button toolbar button ( ) can be used to associate an image
manipulation tool with the right mouse button. If you press this toolbar button, the same drop-down menu as
above will appear.
Each available image manipulation tool can be independently associated with the left mouse button and with
the right mouse button. All combinations of left / right mouse button tools are supported.
The Associate tool with mouse WHEEL toolbar button ( ) can be used to associate Stack image or
Zoom image tools with the mouse wheel. If you press this toolbar button, the following drop-down menu will
appear:
This flexible functionality implies that each single image tool is always usable with a single mouse button. For
instance, the Poly line (annotation) tool allows drawing a poly-line with a single mouse button; double-click of
the associated mouse button must be used to conclude the shape.
The icon of the tool currently associated with the left and right mouse buttons will appear in the next to the
left, right and wheel mouse button icons.
In addition to using these toolbar buttons, there are also other ways to associate tools to mouse buttons:
By CTRL + right-clicking over an image panel, the following contextual menu will appear:
23
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Using the Associate tool with LEFT mouse button, Associate tool with mouse WHEEL and Associate
tool with RIGHT mouse button menu items, you are able to change the association between mouse
buttons and tools.
By SHIFT + left-clicking, the viewer directly shows the popup menu to associate a tool with the left
mouse button. By SHIFT + right-clicking, the viewer directly shows the popup menu to associate a
tool with the right mouse button. By SHIFT + wheel-clicking, the viewer directly shows the popup
menu to associate a tool with the mouse wheel.
Each image manipulation tool has its own associated Tool options panel. When the user starts using an
image manipulation tool on a medical image, that tool becomes the active tool, and the Tool options panel
related to that tool will be displayed in the viewer’s bottom bar. Also, the icon of the active tool is displayed in
the bottom left corner of the viewer’s window:
The following paragraphs will describe each image manipulation tool, as well as the options and information
available in the Tool options panel associated with each tool.
24
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The interpolation algorithm used to zoom images can be chosen through the Interpolation quality drop-down
list on the Tool options panel associated with this tool. Three different interpolation types are supported,
providing a speed vs quality trade-off.
6.2.3 Magnifier
The Magnifier tool allows magnifying a moving portion of the image, by dragging with the
associated mouse button over the image.
The Tool options panel associated with this tool is shown in the picture below, in the viewer’s bottom bar:
25
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The magnification factor used by the magnifier, as well as the size of the magnifier itself, can be modified by
dragging the Zoom factor and the Magnifier size sliders on the Tool options panel associated with this tool.
6.2.5 Shutter
The Shutter tool allows applying a shutter over the image, i.e., hiding a sub-region of the image,
which is not interesting for medical purposes. The shutter is always applied to the entire series.
The Tool options panel associated with this tool is shown in the picture below, in the viewer’s bottom bar:
You can select the shape of the shutter to apply on the series by selecting the appropriate Shape option in
this panel. In order to draw a Rectangular or Circular shutter, it is sufficient to select the Shutter tool, to drag
with the associated mouse button over the image, and then to release the mouse button when you are
satisfied with the size of the shutter. On the other side, if you want to draw a Polygonal shutter, then you
need to click the associated mouse button on every point of the polygon contour that you want to define.
When you want to define the last point of the contour, double-click the associated mouse button, and the
polygonal shutter will complete (i.e., close the polygon) automatically.
26
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
It is possible to change the sensitivity of mouse dragging movements for contrast changes, by dragging the
Sensitity slider in this panel.
Window width and window level values can also be changed by selecting one of the available contrast
presets (from the Presets drop-down list). Finally, you can manually enter window/level values in the W / W
and W / L text fields, and press Enter on your keyboard to confirm and apply them.
Press the Auto window button ( ) in order to apply an automatic “optimal” windowing for the currently
selected image. The Reset W/L to default button ( ) may be used to restore the original Window / Level
setting suggested in the DICOM data set (if present).
Once a measurement or graphical annotation shape is selected, the Tool options panel will reflect the
properties of the specific selected shape, and will offer more options. Also, when an annotation is selected,
you can delete it by pressing the Delete key on the keyboard, or the Delete button in the Tool options panel.
Finally, once an annotation is selected, you can select the previous or next annotation of the current image
by pressing the ‘-’ or ‘+’ keys on the numeric keypad of your keyboard.
27
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Warning: measurements taken through the LocalEye Viewer software are based on pixel-to-
millimetres calibration information which is read from the DICOM dataset. This calibration information
is stored by the modality which originally acquired the medical images. LocalEye Viewer has no
mean to guarantee that the calibration information is correct and accurate, hence it has no mean to
guarantee that the final measurements taken by the software are actually accurate. It is
recommended that the user of LocalEye Viewer critically checks the result of each measurement.
User needs to enter the Actual distance corresponding to the measured Pixel distance. User also has the
option of specifying that the following calibration must be applied to the whole series, that is, to all images
belonging to the current series. If this option is not checked, then the calibration will only be applied to the
DICOM file containing the current image.
The Tool options panel associated with this tool is shown in the picture below, in the viewer’s bottom bar:
This panel basically allows you to modify the measurement unit used for calibration.
28
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The user may choose to create an annotation of each measurement, thus leaving a persistent graphic object
over the image, by enabling the Create annotation checkbox. In addition, the user may choose to add the
drawn measurement annotations to all images of the current series, by pressing the Apply to series toggle
button. If the Create annotation option is disabled, the graphic object representing the current measurement
over the image will immediately disappear when the measurement is complete (i.e., the mouse button is
released).
The user may also choose whether to display an on-screen label of each performed measurement, by
checking or unchecking the Show on-screen meas. option.
The measurement unit used for measurements may be chosen by selecting the corresponding option (mm,
cm, or in) in the Unit drop-down list of this Tool options panel.
Finally, it is possible to delete the currently selected annotation by pressing the Delete button, or to delete all
measurement annotations by pressing the Delete all meas.
29
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The user may choose whether he wants to compute the horizontal offset (i.e., horizontal distance) or the
vertical offset (i.e., vertical distance) between the start and end point which have been identified through the
mouse drag operation, by acting on the Type drop-down box.
Warning: in order to guarantee maximum accuracy, it is recommended that the Measure CTR tool is
only used on a PA (Posterior - Anterior) chest xray image.
The user may choose whether he wants only angles among intersecting segments are computed and shown,
by checking the Show inters. angles only option. Also, it is possible to set the number of segments in a
sequence to a fixed value, by acting on the Num of segments drop-down box: this will eliminate the need for
a double-click to terminate the sequence, as the sequence will be automatically terminated once the just-set
number of segments will be traced.
Each sequence of segments is independent from other sequences, even on a single image. Once a
sequence is terminated, it can still be modified both in terms of position of each single segment and in terms
of number of segments: this last aspect can be managed by acting on the Add segment(s) and Remove last
segment buttons (a sequence must be selected first).
30
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Please refer to the paragraph about the Measure distance tool for an explanation of the options available in
this panel.
In addition, as shown in the following screenshots, on PET images containing the appropriate data elements
in their DICOM dataset, LocalEye Viewer is able to provide the minimum/maximum/mean SUV, and the
standard deviation of the SUV within the selected rectangular area.
SUV (Standardized Uptake Values) is commonly used in PET image analysis. It measures the concentration
of a radiotracer in a defined region of interest (ROI), which provides interesting diagnostic information. In
particular, LocalEye Viewer computes SUV according to the "SUV Body Weight" algorithm which is based on
the following formula:
where:
activityConcentration: the pixel value in the image, after processing of Modality LUT.
radionuclTotalDoseBq: the radionuclide total dose, expressed in Bequerels.
31
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Warning 1: computation of SUV in LocalEye Viewer is based on generally accepted methods and
equations, and in particular on the Body Weight equation reported above. However, some institutions
may use methods and/or equations that differ from those used by LocalEye Viewer and described in
this user manual. Prior to use in a clinical environment, it is important that all equations be confirmed
and an independent evaluation be conducted of the SUV values reported by LocalEye Viewer with
studies from all PET acquisition devices present at your facility, under typical acquisition conditions.
Warning 2: LocalEye Viewer computes SUV only based on the information stored in the image's
DICOM dataset. It is the modality technician's responsibility to ensure that all information is correct
and accurate. LocalEye Viewer won't compute SUV if some of the data elements which are used to
compute SUV are not present or empty in the DICOM dataset.
Warning 3: LocalEye Viewer does not compute SUV on images that have not been decay-corrected
by the acquisition device, because the computed SUV value would not be reliable in that case.
Please refer to the paragraph of the Measure distance tool for an explanation of the options available in this
panel.
In addition, as shown in the following screenshots, on PET images containing the appropriate data elements
in their DICOM dataset, LocalEye Viewer is able to provide the minimum/maximum/mean SUV, and the
standard deviation of the SUV within the selected elliptical area.
32
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Please refer to the previous paragraph "Measure rect area" for details and recommendations about SUV
(Standardized Uptake Values).
Please refer to the paragraph of the Measure distance tool for an explanation of the options available in this
panel.
33
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Please refer to the paragraph of the Measure distance tool for an explanation of the options available in this
panel.
Moreover, on PET images containing the appropriate data elements in their DICOM dataset, LocalEye
Viewer is able to provide the SUV for each point which is selected on the image. The value provided in
square brackets is the actual detected pixel value, after modality LUT transformation.
Please refer to the paragraph "Measure rect area" for details and recommendations about SUV
(Standardized Uptake Values).
34
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
More specifically, the "reset" toolbar button above may correspond with the Reset selected image, or with the
Reset selected series, or with the Reset selected study action, depending on which item is selected in the
related drop-down menu, which can be shown by pressing the down arrow next to the "reset" toolbar button,
as visible in the screenshot above.
Here is a short description of each Reset operation available:
Reset selected image: all changes and operations performed on the currently selected image will be
reset.
Reset selected series: all changes and operations performed on the current series will be reset.
Reset selected study: all changes and operations performed on the current study will be reset.
The Show image information toolbar button ( ) allows viewing information about the currently
selected image. If you press this toolbar button, the Current Image Info dialog box will appear:
35
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Patient tab
Study tab
Series tab
Equipment tab
Image tab
Clinical Trial tab (if enabled)
Meta-Info tab
DICOM dump tab
These tabs display information extracted from the current DICOM file, i.e., the DICOM file related to the
currently selected image.
36
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
In particular, the DICOM dump tab allows performing the DICOM dump of the selected image or of a file not
open in LocalEye Viewer, dragging it in the "dump area". In this second instance, the DICOM dump could be
a useful diagnostic tool, when, for some reason, is impossible opening the file.
The DICOM dump, indeed, shows all the DICOM data elements related to the selected file/image.
A search box is also supported, allowing to easily find information in the DICOM dataset dump.
37
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
When moving the mouse pointer over each single zoom button, a tooltip text will appear, providing additional
information about the function of the underlying button.
The following paragraphs will describe each zoom operation tool.
6.5.1 Zoom in
Pressing the Zoom in toolbar button ( ) the image displayed in the current panel will be zoomed
in.
Pressing the Zoom out toolbar button ( ) the image displayed in the current panel will be
zoomed out.
Pressing the Zoom to fit toolbar button ( ) the image displayed in the current panel will be
zoomed to fit the size of the panel itself.
Pressing the Zoom reset toolbar button ( ) the image displayed in the current panel will be set
at zoom 100%, i.e., at its original pixel size.
38
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
When moving the mouse pointer over each single contrast management button, a tooltip text will appear,
providing additional information about the function of the underlying button.
The following paragraphs will describe each contrast management operation, corresponding with each
button.
6.6.1 Invert
Pressing the Invert toolbar button ( ) all images of the current series will be contrast-inverted.
In other words, the images are transformed into their “negative” images.
Pressing the Auto window toolbar button ( ) all images of the current series will be auto-
windowed. In other words, an automatic “optimal” contrast windowing will be applied to images.
When moving the mouse pointer over each single geometric transformation button, a tooltip text will appear,
providing additional information about the function of the underlying button.
The following paragraphs will describe each geometric transformation operation, corresponding with each
button.
Pressing the Rotate +90° toolbar button ( ) all images of the current series will be rotated
clockwise of 90 degrees.
39
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Pressing the Rotate -90° toolbar button ( ) all images of the current series will be rotated
counter-clockwise of 90 degrees.
Pressing the Flip horizontally toolbar button ( ) all images of the current series will be flipped
horizontally.
Pressing the Flip vertically toolbar button ( ) all images of the current series will be flipped
vertically.
Pressing the View 'key' images in current study toolbar button ( ) all images previously marked
as “Key Images” will be displayed in the current study panel, each key image in a dedicated image panel.
40
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
When this button is pressed, the report dialog-box will be show and it will be possible to view the existing
report for the current study (i.e., the study of the currently-selected image).
Depending on the viewer's configuration, one or more Report templates may be available. Selecting a given
report template will affect the way the DICOM structured report is presented to screen and printed to an
output sheet (which information is included in the report, how the text will look like, how each data is laid out
to screen / sheet, etc.).
In case multiple DICOM structured reports are available, a selection window will appear, allowing to choose
the desired SR. The displayed DICOM structured report may also be printed, through the Print… button.
41
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
By pressing the Print preferences... button, the SR print preferences dialog box (in case of DICOM structured
report) will be shown, allowing to define a custom header and footer for the printed structured report,
including both images and texts:
Pressing the Set display mode... toolbar button ( ) is pressed, the following drop-down menu
will appear:
42
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
This section allows defining exactly how series and images are presented within this study panel.
Series Tiling allows specifying the series tiling for the current study. The series tiling determines how many
series will be concurrently visible, and their layout on screen.
If Auto view all series item is chosen, then all series are automatically shown and an auto-selected layout will
be applied.
Image tiling allows specifying the image tiling for the series panel. The image tiling determines how many
images of each series will be concurrently visible, and the layout of images inside the series panel.
43
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
If the View study in full-screen mode toolbar button ( ) is pressed, the selected study is viewed in full
screen. You can the exit from the full-screen mode by pressing the ESC button on the keyboard: normal-
screen mode will then be restored.
The Toggle automatic series synchronization... toolbar button ( ) allows synchronizing different CT or
MR series whose images (slices) were acquired moving in the same direction (acquisition planes with the
same orientation). The synchronization causes a scrolling through the images of these series, in such a way
all panels show images related to the same patient coordinates (where available). The reference coordinates,
at which all other panels are synchronized, are the ones of the currently selected image panel / series. In
order to support synchronization of all series, the image tiling of all series panels is automatically set to 1x1.
Once the Toggle automatic series synchronization... function is enabled, all scrolling operations will be
synchronized across the displayed series. In order to disable the Toggle automatic series synchronization...
function and the related locked scrolling among series, it is sufficient to click once again on the same toolbar
button.
The Toggle manual series synchronization... toolbar button ( ) allows manually synchronizing
different CT or MR series whose images (slices) were acquired moving in the same direction (acquisition
planes with the same orientation). This manual function is useful when it is necessary to manually set the
initial "aligned" state among several different series, and/or to synchronize scrolling among series belonging
to different studies, even acquired by different modalities: under these conditions, the Toggle automatic
series synchronization... function won't work. In order to use the manual series synchronization, the user
must scroll all relevant series in such a way they all show images related to the same patient coordinates.
When synchronized scrolling among several studies is necessary, the user shall select a given study, then
click on the arrow-shaped drop down button, placed next to the Toggle manual series synchronization...
toolbar button ( ). A drop-down menu will appear, allowing user to choose the other studies (in
addition to the current one) to synchronize with.
44
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
In case of cross-study manual synchronized scrolling, before activating the synchronization, the user must
scroll all relevant series of each study, in such a way they all show images related to the same patient
coordinates.
Once all relevant series have been scrolled in such a way to represent an initial "aligned" situation, it is
possible to press the Toggle manual series synchronization... button in order to lock scrolling of all those
series in a synchronized way. The scrolling position of each series in the moment when the Toggle manual
series synchronization... button is pressed is considered to be the initial reference point. In order to disable
the Toggle manual series synchronization... function and the related locked scrolling among series, it is
sufficient to click once again on the same toolbar button.
Warning: synchronized scrolling functionalities are based on a software algorithm. As such, the
proper functioning of sync scrolling depends on the correctness of several orientation and spacing
data stored in the original DICOM datasets, in addition to the correctness of the implemented
scrolling algorithm. The viewer itself has no mean to ensure these input data are correct. Hence, the
proper synchronization of the series shall be checked in a very “critical” way by the user/radiologist,
and any conclusion coming from these functionalities shall be carefully evaluated.
The Share study through Dropbox ( ) toolbar button allows sharing the current DICOM study with
a remote recipient (e.g., for a consultation, second opinion, etc.) by exploiting the sending user's Dropbox
and a NeoLogica-powered cloud viewing infrastructure. This cloud-based viewing infrastructure has been
called "Exams Sharing Portal (ESP)".
Clicking on this button, a step-by-step Share through Dropbox wizard is started, as shown in the following
picture:
45
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The first step of this wizard allows user to authenticate on the Exams Sharing Portal by entering email and
password related to his ESP account. If the user does not have a user account on the ESP yet, he can
create a new one selecting the appropriate option, as shown in the following screenshot:
Once user has successfully logged in to the ESP, LocalEye Viewer stores his login data, so that he will be
able to auto-login upon later usages of the Share through Dropbox functionality.
Clicking on the Next button, the page related to the second step of the wizard will appear:
46
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Once user has authenticated on ESP, an attempt will be made to authenticate on Dropbox. If automatic
authentication succeeds, user can choose to proceed with that Dropbox account, as shown in the image
above. Otherwise, if automatic authentication on the user's Dropbox is impossible or fails, or user just wants
to associate a different Dropbox account, an authentication and authorization step takes place on Dropbox,
as you can see in the images below:
47
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Once user has logged in to the ESP, and access to user's Dropbox is granted, LocalEye Viewer is ready to
upload current study's DICOM files to Dropbox.
48
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
In this step, user is prompted to choose a password needed to encrypt all DICOM files which will be
uploaded to his Dropbox. This password must be at least 8 characters long, and user will need to
communicate it to the recipient of the shared study. Through this password, indeed, the recipient will be able
to decrypt and view the medical images.
In addition, selecting the option Anonymize DICOM files before uploading to Dropbox, a further layer of
privacy will be added to the data that user is going to share.
Important note: please consider that only the attributes inside the DICOM header will be
anonymized, according to the anonymization preferences. Eventual personal identifying information
burnt into the image pixels will be left unchanged. Also, please notice that in this case anonymous
information will be published to the Exams Sharing Portal (ESP), hence the recipient will see
anonymous data.
At this point, LocalEye Viewer is ready to encrypt and upload all DICOM files related to the current study to
user's Dropbox. During the upload of DICOM files to Dropbox, a progress bar shows the current progress of
the whole upload procedure, which may be very lengthy. User can choose to abort and stop the upload
operation.
Once the upload to Dropbox of all DICOM files of the study has successfully completed, the "Publish to
Exam Sharing Portal" step takes place:
49
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Here, it is necessary to enter the email address of the recipient, which will be used to send him a notification
email, informing him about the availability of a shared study for him on the ESP. This email will provide the
recipient with an appropriate link, as well as login information, which will enable him to access the exam's
images. Also, this email address will be used to create the recipient's user account on ESP, if not already
existing. It is possible to send the exam password to the recipient directly by email, by selecting the Transmit
exam password to recipient by email option.
Warning: transmitting the exam password to the recipient by email may be insecure. If you want to
ensure maximum security, please leave this option unselected, and transmit the password to the
recipient through a different mean (e.g., phone call).
Finally, user can type a note for the recipient of the shared exam through the appropriate box.
At this point, clicking on the Next button LocalEye Viewer will publish the current study to the Exams Sharing
Portal (ESP).
Once the study has been successfully published to ESP, user can choose whether to use one of his existing
credits (if available) to unlock viewing of the study, or to purchase new credits to unlock the study on behalf
of the recipient, or rather to leave the recipient the task of unlocking the study at a later stage.
50
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
Once a user has unlocked a shared exam, that exam will be online and viewable (by both the sender and the
recipient) as long as the sender will keep it in his own Dropbox, for an unlimited number of times.
Once the unlock step has been done or skipped, the exam sharing operation is complete, and LocalEye
Viewer provides a final summary:
51
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The Play/Stop cine movie toolbar button (toggling between and ) allows you to start or stop the
cine-playback of cine-sequences currently displayed within the current study panel.
Pressing the Playback preferences… toolbar button ( ), the following options panel will appear:
52
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The Apply cine commands and settings to all series in the study option let you decide whether the play and
stop commands will have effect just on the currently-selected cine sequence, or rather to all series within the
study.
It's possible to modify the speed of the playback (in terms of frames per second, or FPS) by dragging the
dedicated slider. The Apply default FPS (movie speed) button ( ) allows setting the predefined
playback speed for a given cine-sequence (according to the information coming from the DICOM dataset, if
available).
The buttons on the bottom of this cine preferences panel allow controlling the loop mode of the playback,
which can be Play once, Looping (default) or Sweeping (i.e., back and forth).
Pressing the Play once button ( ) the frames 1 to N (where N is the total number of frames in the current
series) are displayed in rapid sequence, then the playback is stopped.
Pressing the Looping button ( ) the frames 1 to N are displayed in rapid sequence, then the playback
begins again from frame 1 and so on (frame sequence: 1,2,…,N,1,2,…,N,1,2,…).
53
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
The Previous series toolbar button ( ) and Next series toolbar button ( ) are used switch the
currently-selected series panel to the next or previous series (if multiple series are available in the current
study).
In case "hanging steps" are defined within a hanging protocol, it will be possible for the user to easily iterate
through all "hanging steps" which are present within the hanging protocol, also in a next/previous fashion,
through the arrow buttons available next to this dropdown box ( ). Switching to a different hanging
step is a viewer-wide operation, which may have an effect on what is hung on all available monitors. It is
possible to open several studies, belonging to different modalities or even different patients, and to hang
them all together according to their hanging steps.
Each individual hanging view defined in the matching hanging protocol(s) can be directly applied to the
single study panel through the same dropdown box.
54
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
LocalEye Viewer also supports a faster association of the tools with the left, right and wheel mouse buttons.
In order to change the tool associated with the left mouse button, press the left mouse button while keeping
the Shift key pressed on the keyboard. In order to change the tool associated with the right mouse button,
55
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
press the right mouse button while keeping the Shift key pressed on the keyboard. Finally, in order to change
the tool associated with the wheel mouse button, press the wheel mouse button while keeping the Shift key
pressed on the keyboard.
The pop-up menus are particularly useful when operating in full-screen mode, since most functions may be
accessed without the need for the main toolbars.
9 Thumbnails panel
The Thumbnails panel displays thumbnail images:
If the Series option button is selected on the Thumbnails panel, then each thumbnail image will represent a
series currently loaded in LocalEye Viewer, and the number of displayed thumbnail images for each study
will be equal to the number of series currently loaded in LocalEye Viewer for that specific study. The
thumbnails are grouped by study.
On the other hand, if the Images option button is selected on the Thumbnails panel, then each thumbnail
image will represent a single image currently loaded in LocalEye Viewer, and the number of displayed
56
LocalEye Viewer v10: User Manual [LE-V-UM-EN-10 – Rev A]
thumbnail images for each study will be equal to the total number of images currently loaded in LocalEye
Viewer for that specific study. Also in this case the thumbnails will be grouped by study and series.
Drag&drop of images or series from the Thumbnails panel to the study panel(s) is supported. You can also
select multiple thumbnails in the Thumbnails panel, by the Windows-usual Shift-click or Ctrl-click, and then
dragging & dropping all selected images or series (depending on the active mode) to the Study panel.
Double-clicking on a thumbnail will load the double-clicked series or image into the currently selected image
panel. Double-clicking on a series thumbnail while pressing the Alt key on the keyboard will load the study
panel with the scene starting at the double-clicked series. Double-clicking on the tab related to a particular
study, will hang the study, following the rules of the first matching hanging protocol.
When the proper option is enabled in the Settings section (under Display preferences) , the thumbnails will
be marked by symbols to identify the series or images displayed on the main study panel(s): while the
symbols identify the series or images currently displayed (i.e., hung on screen) in LocalEye Viewer, the
symbol indicates the currently-selected series.
The thumbnail panel may be hidden or shown by clicking on the pin icon appearing at the top right of the
panel itself.
https://www.neologica.it/Support
You will then be able to open a new "support ticket", and specify the details of the issue you have detected.
The NeoLogica Support Staff will analyze the reported issue and will reply promptly, then making every effort
to solve the issue in the shortest possible time.
11 Acknowledgments
LocalEye Viewer relies on the CharLS library in order to decode JPEG-LS-compressed images.
57