Plugin settings for the PIXI plugin or any other XNAT plugin can be modified by administrators. From any view, select Administer -> Plugin Settings in the menu bar. Plugins will be listed vertically on the left side of the display. Please see instructions below for various configuration settings.
Site Plugin Settings
Subject settings include:
Subject Display Preferences
Animal Vendors / Suppliers
Select Subject settings under PIXI in the Plugin Setting column of the display.
Subject Display: XNAT was originally designed to collect data for human subjects. The PIXI plugin adds a data type for Animal Demographic Data, and you will want to select a default type of demographic data for your installation. Select the Demographic Data Type (xnat:demographicData, pixi:animalDemographicData) that will be most common. This will set a preference on a site-wide basis. You can override the choice for individual projects, allowing your installation to support animal subjects in some projects and human subjects in others.
The second preference for Subject Display controls the display for human search fields for PIXI installations. The is disabled by default, but can be enabled with this control.
Species: Data entry forms includes animal species information. The PIXI plugin supports an ontology of defined terms for species that will appear in menu items for user selection. The administrator can create, update and delete terms through this setting. Users will be able to user other terms for species when entering data, but these terms are not automatically added to the ontology.
Animal Vendors / Suppliers: This is similar to the preference for species. The administrator can enter a known list of suppliers in this preference setting. XNAT will provide these as menu items at the point of data entry to support consistent terminology. As with species, a user will be able to enter a different value, but that value will not be automatically added to this list.
PDX and Cell Line Preferences
Patient-Derived Xenograft (PDX) information is maintained by PIXI as a site-wide resource. That allows the PDX information to be entered once and reused/referenced in a single project and across multiple projects. You can manage the set of PDXs as an administrator. Cell lines are managed globally in the same way.
As described above, enter the Plugin Settings page from the Administer menu. Select PDXs and Cell Lines under Plugin Settings (PIXI) in the left flap. You can create, update or delete a PDX enter or a Cell Line entry when the administration page is rendered. You can provide a web link for both types of entities to refer to documentation provided by the PDX or Cell Line provider.
Hotel splitter configuration
The hotel image splitter is a feature of the PIXI plugin that allows you to split multi-subject DICOM images into single-subject DICOM images. To use the hotel image splitter, you will need to have XNAT’s Container Service and be familiar with how to manage commands and images. You may also need to review XNAT’s Event Service documentation, as automating image splitting process relies on this service.
‘Hotel’ Subject Label
The “hotel” images for a project are stored in a special placeholder “hotel” subject, which can be created automatically for new projects using an Event Service action, or created manually for existing or new projects. All hotel image sessions for a project should be uploaded to a project’s hotel subject. Note that if a project does not do hotel imagining, you do not need to create a hotel subject for that project or if one exists, you can delete it.
Automatically create hotel subject
To automatically create a hotel subject for a project, you will need to create an Event Service action that will be triggered when a new project is created. The action should be configured as follows:
Go to the Event Setup tab of the XNAT Event Service by selecting Administer –> Event Service from the top navigation bar.
Locate the default event subscription “Auto Create Hotel Subject” with action “PIXI Create Hotel Subject Action”. The PIXI plugin should have created this automatically. If it is missing, you can add it by creating a new subscription.
Ensure that the “Project - Created” event is selected, and that the “Apply to All Projects” checkbox is checked.
Optionally, choose whether to perform the action as the subscription owner or the user who initiated the event.
Set the status of the event subscription to “Enabled”.
Click “OK” to save the changes.
With this event subscription enabled, the ‘hotel’ subject will be created automatically for new projects. If you need to create the ‘hotel’ subject manually for an existing project, you can do so by following the manual steps described below.
Manually create hotel subject
From the top navigation bar, select New –> Subjects –> Create a Single Subject.
Select the project to which you want to add the ‘hotel’ subject.
In the Subject ID field, enter “Hotel”.
Click “Submit” to create the subject.
Configuring a DICOM SCP Receiver for hotel image sessions
If you do not upload images to XNAT using the DICOM SCP receiver functionality you can skip this step. If you are unfamiliar with XNAT’s DICOM receiver functionality please review the Connecting XNAT to DICOM Scanners and PACS and How XNAT Scans DICOM to Map to Project/Subject/Session documentation before preceding.
For hotel image sessions to route to the hotel subject via a DICOM SCP receiver we’ll configure an SCP receiver to always select the hotel subject regardless of the subject ID in the DICOM header. This receiver should only be used for hotel image sessions.
From the top navigation bar, select Administer –> Site Administration.
Under “Advanced XNAT Settings” select “DICOM SCP Receivers”.
Check that the “PIXI_HOTEL” Application Entity (AE) has been created and enabled. This should have been created automatically by the PIXI plugin. If it is missing, create a new DICOM SCP Receiver.
Include the word “Hotel” in the AE title to help identify this SCP receiver as being used specifically for hotel session.
Set the port to 8104. Note that this is the standard port that XNAT uses for DICOM SCP receivers, if your site is using a different port, you will need to use that port instead.
Enable receiver-specific routing expressions.
Set the Subject Routing Expression to the following:
(0010,0010):^(.*)$:1 t:^(.*)$ r:Hotel (0010,0020):^(.*)$:1 t:^(.*)$ r:Hotel
The Project Routing Expression will be site and project dependent. Here’s an example of a routing expression similar to the core XNAT routing expressions:
(0010,4000):Project:(\w+)\s*Session:(\w+):1 (0032,4000):Project:(\w+)\s*Session:(\w+):1 (0010,21B0):Project:(\w+)\s*Session:(\w+):1 (0008,1030):(.*) (0008,0050):(.*)
The Session Routing Expression will also be site and project dependent. Here’s an example of a routing expression similar to the core XNAT routing expressions:
(0010,4000):Project:(\w+)\s*Session:(\w+):2 (0032,4000):Project:(\w+)\s*Session:(\w+):2 (0010,21B0):Project:(\w+)\s*Session:(\w+):2 (0010,0020):(.*)
Click “Save” to create the DICOM SCP Receiver.
Setup the Hotel Splitter Docker Image
Before proceeding you’ll need to have XNAT’s Container Service running. We will be Adding a Command to container service.
Navigate to Administer –> Plugin Settings.
Under “Container Service” select the “Images & Commands” tab.
Click “New Image”.
For the image name enter “xnat/pixi_pydicom_split”.
For the version enter “:latest”. For specific version tags checkout out Docker Hub.
Click “Pull Image”.
Navigate to the “Command Configurations” tab.
Enable the two xnat/pixi_pydicom_split commands.
The two container commands also need to be enabled at the project level by a project owner or a site admin.
Navigate to a project and click the “Project Settings” link in the Actions box.
Click the “Configure Commands” tab.
Click the “Enable” toggle on the two xnat/pixi_pydicom_split commands.
Setting up Hotels
The ‘hotel’ splitting is based on the DICOM Subject Relative Position in Image tag. PIXI includes hotel configurations for 2, 3 and 4 subjects. If you need to add a hotel with a different configuration you can do so by following the steps below.
Navigate to Administer –> Plugin Settings.
Under “PIXI” select the “Hotel Splitter” tab.
Click “New Hotel”.
Enter a name for the hotel.
Enter the X and Y relative position for each subject in the hotel. Add a description for each position (e.g. “Top Left”). Note that Z is always set to 1, splitting is currently only done in the X and Y dimensions.
Subject Display Preferences The subject display preferences can be set at the project level to override the site-wide preferences. This allows you to have some projects that use clinical subject display preferences and others that use animal subject display. To set the subject display preferences for a project, navigate to the project and click the “Project Settings” link in the Actions box. Select the “Subject Settings” tab and select the desired subject display preferences (xnat:demographicData or pixi:animalDemographicData) from the “Subject Display Preferences” dropdown. Click “Save” to save the changes.
Image Acquisition Contexts The image acquisition context preferences are set at the project level and are used to help populate commonly repeated fields for fasting, anesthesia, and heating conditions in the hotel scan record form.
To create a fasting, anesthesia, or heating conditions template for a project, navigate to the project and click the “Project Settings” link in the Actions box. Select the “Subject Settings” tab and click the “Add” button for each context type. Add a name for the template, and then add the values that will be populated in the hotel scan record form. Click “Save” to save the changes.