Inobitec DICOM Viewer

Installing and Uninstalling the Program

Installing the Program on Windows

To install the program:

  1. Run the installer by double-click.

  2. Click CONTINUE in the window shown in Fig. 1.



  3. It is strongly recommended to update graphics adapter drivers (integrated or discrete) from the official 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 confirmation dialog click Yes) and update drivers. To return to the previous installation step click GO BACK.



  4. 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 confirmation dialog box that appears click Yes.



  5. 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.



  6. If necessary, change the Installation Folder (Fig. 5). We recommend leaving the default value. Click CONTINUE.

    Attention:

    • 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.



  7. 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 first 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.

  8. 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.



  9. 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.



  10. If necessary, change the folder for the program’s shortcuts in the Start menu (Fig. 8). We recommend leaving the default value. Click CONTINUE.



  11. In the confirmation window click the INSTALL button (Fig. 9).



  12. Wait until the installation process is complete (Fig. 10). Click the DONE button.



Silent Installation on Windows

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 file. Such installation can be launched automatically on domain computers using Microsoft Active Directory.

To prepare the installer for a silent installation:

  1. Unpack the installer to a folder using an archiver (for example, 7-zip).

  2. Go to the folder where the installer is unpacked.

  3. Edit the following parameters in the autoinstall.qs file:

    1. AllUsers = false to install only for current user (by default) or AllUsers = true to install for all users;

    2. 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.

    3. 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 specified folder.

    4. LocalStoragePath: path to the local storage. The default value is C:\Users\<username>\InobitecDICOMViewerWorkspace.

    5. OptionsFilePath: path to the file with settings exported from an already installed DICOM ViewerḞor detailes on how to export settings see Section 15.7. The settings file should be in the current folder. If the file is not specified, the default settings are used.

    6. 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 file in utf-8 encoding.

To install the DICOM Viewer run the silent_install.bat file. Log is written to file %temp%\install%DATE%.log, where %temp% and %DATE% are Windows system variables.

Uninstalling the Program on Windows

To uninstall the program:

  1. Run the uninstaller using one of the following methods:

    1. select Inobitec Dicom Viewer -> Uninstall in the Start menu or

    2. use Programs and Features in the Control Panel.

  2. Make sure that the item Remove all components is selected in the window shown in Fig. 11 and click the CONTINUE button.



  3. In the confirmation window click the UNINSTALL button (Fig. 12).



  4. In the confirmation window click the DONE button (Fig. 13).



Silent Uninstallation on Windows

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:

  1. Unpack the installer to a folder using an archiver (for example, 7-zip).

  2. Go to the folder where the installer is unpacked.

  3. 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 file.

To uninstall the DICOM Viewer run the silent_install.bat file. Log is written to the %temp%\uninstall%DATE%.log, where %temp% and %DATE% are Windows system variables.

Installing and Uninstalling the Program on Mac OS

To install the program uncompress the dmg file and drag Viewer.app into the Applications folder.

To uninstall the program remove the Viewer.app from the Applications folder.

Installing and Uninstalling the Program on Linux

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 ffmpeg library (command for Ubuntu: sudo apt install ffmpeg).

To uninstall the program remove the folder with the program.

Launching with Shortcuts

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 — simplified;

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 first series of the first 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.

Launch from the Command Line

Launching the program from the command line allows you to set specific 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 specified folder. If there are several studies, then the following options are applied to the first study in the list:

    • --open-series-images: display the first series in the flat image view window

    • --open-series-mpr: display the first series in the multiplanar reconstruction window

    • --open-series-volume: display the first series in the volume reconstruction window

    • --open-series-endoscopy(PRO): display the first 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 specified seriesUID

      • --series-index <seriesIndex>: show the series with the specified seriesIndex

  • --pacs-aetitle <aetitle>: attempt to open study list from PACSServer which AE Title matches the specified AE Title. The following options can be used with this option in different combinations:

    • --patient-id <patientID>: show the study with the specified patientID. Parameter has higher priority than --study-uid

    • --study-uid <studyUID>: show the series with the specified studyUID

    • --series-uid <seriesUID>: select the series with the specified seriesUID. If several studies are found, the first one on the list is used

    • --series-index <seriesIndex>: select the series with the specified seriesIndex. If several studies are found, the first one on the list is used

    • --open-series-images: display the selected series in the flat image view window. If a series is not selected, the first one of the first 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 first 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 specified folder, there is no series with the specified 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 first PACSServer on the list. PACSServers are sorted by the Server nickname field. 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 <file>: imports settings from <file> except parameter AE Title for DICOM Listener

    • --use-imported-listener-aetitle: parameter AE Title for DICOM Listener is set to value from <file>

      • 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 specified in <file>

      • if the option --aet <aetitle> is used at the same time then Client name (SCU) for PACS Servers is set to <aetitle>

  • --export-settings <file>: exports settings to <file>.

Launch multiple instances of the program

If one instance of editions Pro or Lite is already launched, then other instances of editions Pro or Lite exit and activate the first instance. If another instance is launched from the command line, then the command line options are sent to the first 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 flash 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.