To install the program:
Run the installer by double-click.
Click CONTINUE in the window shown in Fig. 1.
It is strongly recommended to update graphics adapter drivers (integrated or discrete) from the oﬃcial manufacturer‘s website, in order to prevent possible failure in operation of DICOM Viewer. If you are sure that drivers are up to date check the The drivers on this device have been updated box in the window shown in Fig. 2, and click CONTINUE. Otherwise stop installation (click CANCEL and in the conﬁrmation dialog click Yes) and update drivers. To return to the previous installation step click GO BACK.
Read the License Agreement carefully. Its text is also available from the link inobitec.com/eng/downloads/eula.php. If you agree the terms and conditions, check the item I accept the license and click CONTINUE (Fig. 3). Otherwise click CANCEL and in the conﬁrmation dialog box that appears click Yes.
Select for whom you want to install the program (Fig. 4). If you select Anyone who uses this computer (all users), then the program will be installed to the system folder, and you will need administrative privileges.
If necessary, change the Installation Folder (Fig. 5). We recommend leaving the default value. Click CONTINUE.
It is prohibited to specify a path with only the disk root (e.g. D:\);
It is prohibited to specify folders created by other users and third-party software;
When the program is being installed for all the users, specify a folder that can be accessed by all the users.
If another version of the program is already installed in the selected folder, then the message The directory you selected already exists and contains an installation. To install the product the installation will be uninstalled ﬁrst will be displayed.
To uninstall, click Yes. The uninstaller will start (see the Section Uninstalling the Program on Windows). After the uninstall the installation will continue.
To leave the already installed version of the program and select a new folder to install, click No and in the window shown in Fig. 5, specify another folder.
If you select installation for all users, then you need to specify the Common Directory to store the program service information (Fig. 6). If necessary, change the path to the Common Directory. We recommend leaving the default value. Click CONTINUE.
In the Select Components window, (Fig. 7) select the required components by check the boxes. To expand or collapse the component tree, click on the symbols to the left of the component group name (highlighted in red and green in the Fig. 7):
the Help group:
Slideshow tips: Compact movies for tooltips;
Assistant (English): English integrated help system;
Assistant (Russian): Russian integrated help system;
User manual PDF (English): English user manual in PDF format;
User manual PDF (Russian): Russian user manual in PDF format.
the Languages group contains available languages.
For detailed information about a component select it with the mouse.
If necessary, change the folder for the program’s shortcuts in the Start menu (Fig. 8). We recommend leaving the default value. Click CONTINUE.
In the conﬁrmation window click the INSTALL button (Fig. 9).
Wait until the installation process is complete (Fig. 10). Click the DONE button.
Silent installation allows you to speed up and automate the process of installing the program by submitting the installation parameters to the installer through the ﬁle. Such installation can be launched automatically on domain computers using Microsoft Active Directory.
To prepare the installer for a silent installation:
Unpack the installer to a folder using an archiver (for example, 7-zip).
Go to the folder where the installer is unpacked.
Edit the following parameters in the autoinstall.qs ﬁle:
AllUsers = false to install only for current user (by default) or AllUsers = true to install for all users;
TargetPathName: path to folder to install the DICOM Viewer. If AllUsers = true then the default value is C:\Program Files\InobitecDICOMViewer<Edition><Version>, if AllUsers = false then default value is C:\Users\<CurrentUserName>\InobitecDICOMViewer<Edition><Version>. If necessary, specify another value.
CommonPath: path to the common folder (only if AllUsers = true). The default value is C:\ProgramData\InobitecDICOMViewer<Edition><Version>. If necessary, specify another value. All users must have write access to the speciﬁed folder.
LocalStoragePath: path to the local storage. The default value is C:\Users\<username>\InobitecDICOMViewerWorkspace.
OptionsFilePath: path to the ﬁle with settings exported from an already installed DICOM ViewerḞor detailes on how to export settings see Section 15.7. The settings ﬁle should be in the current folder. If the ﬁle is not speciﬁed, the default settings are used.
ForceInstall = false to remove the previously installed version of the DICOM Viewer in the folder selected for installation.
If national characters are used save the autoinstall.qs ﬁle in utf-8 encoding.
To install the DICOM Viewer run the silent_install.bat ﬁle. Log is written to ﬁle %temp%\install%DATE%.log, where %temp% and %DATE% are Windows system variables.
To uninstall the program:
Run the uninstaller using one of the following methods:
select Inobitec Dicom Viewer -> Uninstall in the Start menu or
use Programs and Features in the Control Panel.
Make sure that the item Remove all components is selected in the window shown in Fig. 11 and click the CONTINUE button.
In the conﬁrmation window click the UNINSTALL button (Fig. 12).
In the conﬁrmation window click the DONE button (Fig. 13).
Silent uninstallation allows you to automate the process of uninstalling of the program similar to silent installation.
To prepare the installer for a silent uninstallation:
Unpack the installer to a folder using an archiver (for example, 7-zip).
Go to the folder where the installer is unpacked.
Change the <Disk:\Full\Path\To\Installed\DICOMViewer\You\Want\To\Uninstall> text for the path to the folder with the DICOM Viewer to uninstall in the silent_uninstall.bat ﬁle.
To uninstall the DICOM Viewer run the silent_install.bat ﬁle. Log is written to the %temp%\uninstall%DATE%.log, where %temp% and %DATE% are Windows system variables.
To install the program uncompress the dmg ﬁle and drag Viewer.app into the Applications folder.
To uninstall the program remove the Viewer.app from the Applications folder.
To install the program uncompress the archive to the desired location.
The program needs libraries, some of which must be installed in the system, the rest are is supplied in the archive. To install the required libraries, run the following commands (for Ubuntu):
sudo apt install libqt5opengl5
sudo apt install libqt5xml5
sudo apt install libqt5xmlpatterns5
sudo apt install qt5-image-formats-plugins
sudo apt install libqt5printsupport5
sudo apt install libqt5help5
sudo apt install libqt5webkit5
For builds that support video recording, you need to install the ﬀmpeg library (command for Ubuntu: sudo apt install ﬀmpeg).
To uninstall the program remove the folder with the program.
Inobitec DICOM Viewer software for Linux OS is comprised of only one ﬁle in
<InobitecDICOMViewer><Bitness><Edition><Version> format with AppImage
extension. The ﬁle contains the program with all the libraries required for its functioning.
To install and run the program in AppImage format, proceed as follows (for Ubuntu):
We advise you to transfer the downloaded Inobitec DICOM Viewer ﬁle from the Downloads ﬁle directory to the directory you need.
Provide the AppImage ﬁle a permission to be executed. For that purpose, mouse over the ﬁle and click the right mouse button. In the context menu, select Properties. When the Properties menu (Fig. 14) pops up, go to the Permissions tab and check the Allow executing ﬁle as program box. Close the Properties menu.
To run the program ﬁle, double-click on it with the left mouse button.
To uninstall the program in AppImage format remove the ﬁle from the directory.
Starting from version 2.6 the DICOM Viewer shortcut in Windows operating systems is displayed in the format: <Inobitec><Edition><Version>.
The editions available are:
PRO — professional;
LITE — simpliﬁed;
For example Inobitec PRO 2.6.0.
Each version and edition of the DICOM Viewer installed in Windows has their own shortcuts on the Desktop and the Start Menu to ensure the convenience of launching.
To launch the program, double-click on the desktop shortcut or click on the shortcut from the Start menu.
On Windows and macOS, the DICOM Viewer may be launched by dragging and dropping the data folder on the program icon. The studies contained in the folder will be opened in a new tab DICOM data in the folder, and, depending on the data type, the ﬁrst series of the ﬁrst study on the list will be opened:
In the Flat image viewing tab;
In the ECG viewing tab;
With the PDF viewer (if installed), by default;
In the DICOM Tag Viewing tab, if the series cannot be opened in the above mentioned tabs/by the above mentioned programs.
If the DICOM Viewer has already been launched, the data will be opened in it. If there are no data in the folder to be displayed, an empty tab DICOM data in the folder will pop up.
Launching the program from the command line allows you to set speciﬁc parameters for the current session of the program, change the settings and get help information about the command line options. To launch the DICOM Viewer use the following syntax on the command line:
[<path_to_the_program>]< executable_program> [ --help] | [--study-folder <path> [--open-series-images | --open-series-mpr | --open-series-volume | --open-series-endoscopy [--series-uid <uid> | --series-index <index>]]] | [--pacs-aetitle <aetitle> [--patient-id <patientID>] [--study-uid <studyUID>] [--series-index <seriesIndex> | --series-uid <seriesUID>] [--open-series-images] ] | [--aet <aet>] | [--import-settings <path> [--use-imported-listener-aetitle | --aet <aet>] [--update-scu-aetitle]] | [--export-settings <path>]
--help: display the help information about the command line options, exit the program.
--study-folder <path>: display the study (studies) contained in the speciﬁed folder. If there are several studies, then the following options are applied to the ﬁrst study in the list:
--open-series-images: display the ﬁrst series in the ﬂat image view window
--open-series-mpr: display the ﬁrst series in the multiplanar reconstruction window
--open-series-volume: display the ﬁrst series in the volume reconstruction window
--open-series-endoscopy(PRO): display the ﬁrst series in the virtual endoscopy window
Any of these parameters can be used with the following parameters:
--series-uid <seriesUID>: show the series with the speciﬁed seriesUID
--series-index <seriesIndex>: show the series with the speciﬁed seriesIndex
--pacs-aetitle <aetitle>: attempt to open study list from PACSServer which AE Title matches the speciﬁed AE Title. The following options can be used with this option in diﬀerent combinations:
--patient-id <patientID>: show the study with the speciﬁed patientID. Parameter has higher priority than --study-uid
--study-uid <studyUID>: show the series with the speciﬁed studyUID
--series-uid <seriesUID>: select the series with the speciﬁed seriesUID. If several studies are found, the ﬁrst one on the list is used
--series-index <seriesIndex>: select the series with the speciﬁed seriesIndex. If several studies are found, the ﬁrst one on the list is used
--open-series-images: display the selected series in the ﬂat image view window. If a series is not selected, the ﬁrst one of the ﬁrst study is used
Example: C:\Users\user\DICOMViewerPro1.9.1\viewer.exe --study-folder D:\dicom_data --open-series-images --series-index 1 shows series with seriesIndex 1 of the ﬁrst study from the D:\dicom_data folder in the Flat images view window.
If the option is wrong, then the help information about the command line options is displayed, and the program exits. If the option value is wrong (e.g. there are not DICOM data in the speciﬁed folder, there is no series with the speciﬁed seriesUID or seriesIndex), then this and all subsequent options are ignored.
Attention! If some AE Titles of several PACSServers match, then data will be searched on the ﬁrst PACSServer on the list. PACSServers are sorted by the Server nickname ﬁeld. For details on how to set up connection to PACSServer, see Section 12.2.
The length of AE Title value shall not exceed 16 characters. Cyrillic letters and «\» symbols in AE titles are not allowed.
The following options are used to change the settings. After executing any of these commands, the program exits. In case of a successful execution, the word Done appears on the command line.
--aet <aetitle>: parameter AE Title for DICOM Listener is set to <aetitle>
--import-settings <ﬁle>: imports settings from <ﬁle> except parameter AE Title for DICOM Listener
--use-imported-listener-aetitle: parameter AE Title for DICOM Listener is set to value from <ﬁle>
if the option --aet <aetitle> is used at the same time then AE Title for DICOM Listener is set to <aetitle>
--update-scu-aetitle: Client name (SCU) for PACS Servers is set to AE Title for DICOM Listener speciﬁed in <ﬁle>
if the option --aet <aetitle> is used at the same time then Client name (SCU) for PACS Servers is set to <aetitle>
--export-settings <ﬁle>: exports settings to <ﬁle>.
If one instance of editions Pro or Lite is already launched, then other instances of editions Pro or Lite exit and activate the ﬁrst instance. If another instance is launched from the command line, then the command line options are sent to the ﬁrst instance.
Note that sometimes the program cannot exit immediately when the main window closes (e.g. if data is being transferred over the network, or if information is being written to a disk or ﬂash card). In this case, if you try to launch the program, the main window of the launched instance does not open and you should wait until the launched instance exits and then launch the program again.