User Tools

Site Tools


xnat

This is an old revision of the document!


CfN XNAT

XNAT is an open-source imaging informatics software platform dedicated to helping with imaging-based research. XNAT’s core functions manage importing, archiving, processing and securely distributing imaging and related study data.

CfN manages an XNAT server that is connected to the CfN cluster. The server URL:

http://picsl-xnat.uphs.upenn.edu/

Browser JAVA Requirements

For some functions on the XNAT server, your browser must have Java enabled to work with the xnat service. However since Java support is being phased out in major browsers, functionality is being transferred to desktop tools by the XNAT team.

Documentation

Direct Data Access from the Cluster

The XNAT data archive is stored on the /data/tesla-data volume, and is directly accessible with read-only permissions on the cluster at /data/XNAT. This allows direct processing from the cluster of data stored within XNAT.

Users who need to read this data must be added to the xnat_users linux group. Individual project directories are readable only by members of the linux group for lab/project members. If you need to be added to the appropriate group, please tell the admins and have your PI send approval.

Pipelines

XNAT can also be setup to run 'pipelines', which are collections of scripts and processing steps that can be launched and monitored from the XNAT web interface. Please contact the admins for details.

Accounts

User logins are separate from CfN cluster logins. Please connect the admins for more information.

Projects

XNAT organizes data by Project. Each Project has private control of its data and a user must be granted access to a Project to view or edit data.

Uploading Data

"Archive" and "Prearchive"

When data is “in Prearchive”, it means the data has been received and stored by the XNAT system, but it is in a special holding state and has not been fully integrated into a Project. It has not been fully entered into the XNAT database. The Prearchive is a useful holding place for data so it can be reviewed by a Project member and have Subject and Session labels changed as necessary (see below).

When data is “moved to Archive” in XNAT, it means the data has been fully integrated into the XNAT database as part of a Project. It is now viewable and actionable from the Project's page in the web interface.

When data is uploaded/imported to XNAT, it always goes into Prearchive, even if only temporarily before it's moved to Archive.

Manual Uploads

To manually upload data, use the desktop tool XNAT Upload Assistant. This program runs on your local machine.

For the Upload Assistant setup:

server: http://picsl-xnat.uphs.upenn.edu
username: your XNAT username (probably the same as you cluster username, but may not be)
password: you XNAT password

Pushing Data from PACS/Sectre or Research Scanner

XNAT can receive data directly from PACS/Sectre and from scanners such as the Stellar-Chance research scanner. This is typically called 'pushing' data to a 'DICOM (SCP) Receiver', or to an 'AE Title'. Please contact the admins for details.

Prearchive or Archive as Final Destination

Data can end up in either Archive or Prearchive at the completion of the upload/push process from a scanner or PACS/Sectre. This depends on project-specific settings. Namely, within a project's 'Manage' tab, it's set under 'Define Prearchive Settings'. Data always 'goes through' Prearchive briefly even if its final destination is Archive.

Data Anonymization - IMPORTANT

Anonymization refers to the removal of personally identifying information in medical data (Protected Health Information - PHI)

Site-wide Anonymization

When data is uploaded to XNAT, a site-wide anonymization script is run as the data first goes to Prearchive. See here for details.

Project-specific Anonymization

When data is moved from prearchive to archive, a Project-specific anon script is run, if one is set. Each Project can define its own anonymization script if the site-wide script is insufficient.

Fields That Are NOT Anonymized - IMPORTANT

When pushed from PACS/Sectre, the site-wide anon script does not remove DICOM 'Study Description', 'Patient Name', or 'Patient ID' (“SPP fields”, for convenience). Thus it's up to the user to change these as needed to protect PHI.

When pushed from a scanner that allows the user to modify the DICOM 'Patient Comments' or 'Study Comments' field before pushing the data, the user has the option to assign metadata that XNAT will use to new assign values to the SPP fields during import. Otherwise, the SPP fields be preserved as in a push from PACS. https://wiki.xnat.org/pages/viewpage.action?pageId=36373129

If the user moves data manually from prearchive to archive, they have two options: 1) 'Review and Archive' - user is prompted to change the XNAT Subject (DICOM field 'Patient Name') and XNAT Session (DICOM field 'Patient ID') fields. 2) 'Archive' - data is archived without prompting user to change anything

When using the XNAT Desktop Upload Assistant (client-side tool for manual uploading), data goes straight to project archive. However after the data first enters prearchive, the user is prompted to change the Subject and Session fields before it's moved to archive.

xnat.1520033302.txt.gz · Last modified: 2018/03/02 23:28 by mgstauff