Philips Research Imaging Development Environment PRIDE: Version 5 Installation Guide
Philips Research Imaging Development Environment PRIDE: Version 5 Installation Guide
Philips Research Imaging Development Environment PRIDE: Version 5 Installation Guide
NOTE:
The quick-start installation instructions (OnePageInstructions.doc) which is also included with the
PRIDE installation contains all basic information required to get PRIDE running under normal
circumstances. This installation guide is much more comprehensive containing information on
common problems and detailed information about PRIDE terms and (test) tools available with the
PRIDE installation.
At the end of the full installation one should be able to run PRIDE-applications, connect to the
database of the scanner and have a realtime data-connection (DRIN) for some advanced
applications and developments.
The installation can only be guaranteed for certain software levels required for the PRIDE-PC,
scanner software and IDL-licenses. Please carefully read the requirements in the chapter PRIDE-
requirements.
Apart from this manual and the requirements given in the following chapter, only the PRIDE
installation CD is needed (PRIDE-V5 which includes useful utilities).
Clinical scientists can obtain these through their contacts with Best. Also, depending on the
desired options, Clinical Science keys 39, 42 and 43 are required for PRIDE/DRIN to function.
(Keys are detailed on page 7.)
In case the installation did not succeed, please carefully pay close attention to and note the error-
messages that may have been generated. If these still do not help to finalize the installation please
check whether all the requirements were met, accurately describe the encountered problems and
contact one of the following persons (by email):
[email protected]
[email protected]
If the PRIDE Installation is still not working properly, please gather as much information as
possible and contact Philips for further assistance.
1.2 PARADISE.
PRIDE and PARADISE can work together, however they can result in conflicts. To minimize the
problems between the two environments, ensure that the PATH environment variable lists the
PARADISE entries BEFORE the PRIDE entries. (E.g. Install PARADISE first.)
The PRIDE Installer will automatically detect and select the newest found version of IDL on the
PRIDE PC. (The user can override this selection if the older installed IDL is desired.) Based on
the selection in the PRIDE Installer, the correct files will be automatically copied.
Networking
Network connection with the scanners host PC.
For the Local Disk installation it is up to the user Required for Patient Database
to get data to the PRIDE PC any other way, e.g. access and DRIN installations.
USB stick.
Properly set firewall: Required for direct Patient
Port 6555 need to be opened to allow all required Database access.
communications between the scanner and the Please consult your local IT
PRIDE PC. department.
Properly set firewall: Please consult your local IT
Port 8165 is required for DRIN. department.
Scanner
Except for the DRIN connection
1
R12.6 or R2.6 and up . PRIDE Installation V 5 is release
independent.
1
NOTE: From R 2.6 and up the executables and dll’s, required for the direct
database access will be present on the scanner as a default (CS-key’s still required!).
2
NOTE: From R11 (or R1) onwards the Packman Addons tools will be present on
the scanner as a default (CS-key still required!).
The installation program for each of these prerequisite steps is found under the Installations
directory of the PRIDE installation CD. For instructions, please refer to Appendix A..
When all pre-requisite programs are installed, the Pride Wizard is used to install and test the
PRIDE Workstation (chapter 5).
If any problems are encountered, please read Chapter Troubleshooting. Some commonly
occurring problems are discussed there.
NOTE: Without Microsoft .NET installed, the Pride Wizard will not start up. An error will be
shown that the application could not be initialized.
NOTE: If Microsoft Vista is installed on the PC or laptop there already will be a .NET version
present. Please, ignore this step.
After successful installation PRIDE applications, available on the PRIDE installation CD, can be
started. Open the IDL Virtual machine by double clicking the icon on your desktop. Choose the
application by selecting the correct *.sav file.
Using this application it is possible to run the basic tests to find any possible problems. Also, this
wizard can set up PRIDE for a different scanner by updating the IP address.
It is also possible to update the IDL version which PRIDE expects to find on the system from the
Pride Wizard. Only installed versions of IDL can be selected, so with the example depicted in
Figure 1 on page 8, both IDL 6.2 and IDL 6.3 are installed.
After choosing the correct IDL version, update PRIDE by clicking the button
Update IDL Version on the left hand side.
PRIDE applications.
Several PRIDE Applications are after the installation under the C:\PRIDE\Applications
directory. All of the applications below run under the currently installed PRIDE software, using
IDL 6.3 or later. All tools can read both PAR/REC V 4.* and XML/REC file pairs.
The list of tools, included on the CD, can vary. The list below is an indication of the tools
included with the PRIDE installation CD. More information of these and other PRIDE tools is
available with your clinical scientist. Each tool will contain a user manual and an IDL 6.3 *.sav
executable.
Please, also check the PRIDE pages on the Intranet (In Center) of Clinical Science under
Research Tools. Here new or updated tools will be published.
Ex_sample.
The ex_subtraction tool is the standard tool used to test the PRIDE environment.
One very useful aspect of this tool is that it can also save XML/REC data, so when a database
connection exists, it can be used to retrieve data from the patient database and store it locally on
the PRIDE PC.
It can also be used to transfer a PAR/REC file pair to a XML/REC file pair.
Source code is available for the user to customize.
Ex_Drin.
This tool is used to test the direct reconstruction connection with the scanner. It really has very
limited use other than showing scan and image information as they’re being scanned on the
scanner.
It is mainly an example tool for making your own PRIDE based DRIN tool. It shows all the
available parameters and how to handle the bulk retrieved through the PRIDE DRIN connection.
Source code is available for the user to customize.
Image_reader.
A simple tool that can display images, stored in PAR/REC format V 4.* and XML/REC format.
It also reads image data from the patient database.
The images can be zoomed, panned and windowed, using the standard mouse button
combinations. It shows the pixel-values at the point of the mouse and a ROI can be positioned for
further evaluation of pixel values.
ProcFrameExample.
This is an example tool in which own processing can be included.
Source code is available for the user to customize.
SoapBubble (SoapBubble_IDL6_V4).
The SoapBubble tool uses points set in the coronary arteries to create a curved MPR. A manual is
supplied.
Troubleshooting.
In general the previous chapter on the normal installation should have performed a correct
installation of the PRIDE V 5 environment. If there are indeed problems with the installation, this
section may help. If any problems occur during installation, please check the Status screen on the
right for more detailed information and check this chapter. If it appears that the problem can still
not be resolved, please contact your local clinical scientist or:
[email protected].
This error occurs then even twice, please press Ignore (twice).
General connection errors.
In some cases of problems it may be related to special network port settings. The firewall
within the hospital may be such that no connection can be made. Please contact the local
hospital network administrators.
The following ports are essential for correct PRIDE performance:
Port 6555:
In case the error SW-key not found appears it may be related to the fact that port 6555 is
not enabled.
The port can be tested by performing the ping command. To perform this command, open
a DOS-prompt (command) window and enter the following line:
ping <ip-address-scanner>
Port 8165:
This port needs to be enabled for the DRIN interface. If the message server not available
appears this can relate to this disabled port.
After IDL has been successfully installed, you should be able to run the IDL demo which is now
available under the Windows Start Menu.
The IDL Virtual Machine is enough to run all features of PRIDE EXCEPT for DRIN.
To set environment variables, right-click on My Computer and select Properties. Then select the
Advanced tab and click on the Environment Variables button.
The top pane shows the User variables.
The top pane should have an entry PATH. If not, create it by clicking the button NEW and
entering PATH in the variable name. (The name is not case sensitive.)
Select the path variable and click Edit.
Verify that the entry C:\PRIDE\bin is present.
If not, add it to the end of the string, separated with a ;.
E.g: