XNAT Gateway Setup for Osirix

Introduction

OsiriX is an image processing software dedicated to DICOM images (".dcm" / ".DCM" extension) produced by imaging equipment (MRI, CT, PET, PET-CT, SPECT-CT, Ultrasounds, ...). It is fully compliant with the DICOM standard for image communication and image file formats. OsiriX is able to receive images transferred by DICOM communication protocol from any PACS or imaging modality.

For these instructions we assume you have a basic understanding of using and configuring OsiriX. The XNAT Gateway allows the user to communicate with the XNAT DICOM server from within OsiriX.

Step 1: Installation and Setup

After installing and configuring OsiriX, you will need to download and install the OS X version of the XNAT Gateway.
Installation of XNAT Gateway for OS X
Setup XNAT Gateway

Step 2: OsiriX Configuration Overview

Below is an overview of the OsiriX menus used for configuring it to work with the XNAT Gateway.

OsiriX Preferences

The OsiriX Preferences menu lists all of the available configurable items in OsiriX. It can be found in the file menu bar under OsiriX->Preferences.... For setting up the XNAT Gateway we'll only need to use Listener and Locations in the bottom left corner.

OsiriX Preferences Menu

Listener

The Listener menu will not be modified. The AETitle, Port Number and Address for OsiriX are needed to configure the XNAT Gateway.

Osirix Listener Menu

Locations

A new node will need to be created pointing to the XNAT Gateway.

Step 3: Configure Osirix Locations

In order for OsiriX to talk to the XNAT Gateway, a new node must be added and configured in the Locations DICOM Nodes list.

1. Click on the "Add new node" button. This will generate a new row with default settings.
2. Click on the default address and you will go into an edit mode. Set the address to the IP of the XNAT Gateway.
3. Click on the default AETitle and set it to the AETitle of the XNAT Gateway.
4. Click on the default Port and set it to the port defined in the XNAT Gateway.
5. Click on the default Description and set it to a recognizable description of the connection.

After adding and configuring the node, select it and click on the "Verify" button to test the connection. The XNAT Gateway must already be configured and running for this to verify correctly.

Step 4: Configure Gateway Remote Device

A remote device will need to be added to XNAT Gateway referencing OsiriX. Under the Local/Remote AE Configuration menu in the XNAT Gateway, click on the "Add" button under Remote Devices. Provide a name describing the device, in this case OsiriX. Using the OsiriX Listener menu as a reference, enter the AE Title, Hostname (or IP) and Port number listed. Then click the "Add" button. This is the only thing you'll need to configure in the XNAT Gateway.

Step 5: Run a Query in Osirix

Now that OsiriX and the XNAT Gateway are configured, it's time to access the data. Open the DICOM Query/Retrieve menu. Select the DICOM node for the XNAT Gateway from the DICOM Nodes list. Enter in a patient name you have access to in the search field and make sure "Any date" is selected. Click on the "Query" button and the data will load below.

Troubleshooting

"Add new node" button is greyed out in Locations menu.

If you are trying to add a node in the Locations menu and the node list and "Add new node" button are greyed out, make sure "Automatically sync the DICOM Nodes List....." check box is unchecked. This will disable the manual configuration of the nodes list.

Osirix Locations Broken Menu

Support and Resources

OsiriX Imaging Software homepage
https://www.osirix-viewer.com/