XNAT Plugin

From user's Wiki!
Jump to: navigation, search

This functionality is in development phase.

Added XNAT functionality that allows to connect to a remote XNAT database.

For users

XNAT toolbar

The XNAT toolbar consists of only one button that will open the XNAT working area.

XnatToolbar.PNG


XNAT working area

This is the XNAT working area:

XnatPlugin60.PNG


It consists of 6 areas: Login credentials, Search criteria, Local files, XNAT tree and Detailed information.


Login credentials

Here you can select wich XNAT connection you want to use. If you click Manage connections you will be able to add, remove or edit connections.

XnatConn.PNG


Search criteria

You can filter XNAT subjects by different criteria: label, gender, handedness, year of birth and project. Each criteria is a regular expression. If no expression is entered for a field, then ".*" is used.

XnatSearchCriteria.PNG

When you click Query, a search is performed in the selected XNAT node. The results are two data entities containing all subjects information and the query results, respectively. This information is shown in the XNAT tree along with the experiments associated to the subjects.


(XNAT Experiments filtering will be allowed in the future but it is not finished yet)


Local Files

Here you select the local database (where all files are downloaded) and you can browse it to remove, update or upload files.

XnatLocalFiles.PNG

This functionality is not available yet.


XNAT tree

This widget shows the query results in a tree format: each subject has as children its experiments.

XnatTree.PNG

As you can see you can perform the Download, Load or Import URLs operations on the selected items. This tree allows multiple selection.


Detailed information

Here you can inspect the selected item information.

XnatDetailedInfo.PNG


Experiment actions

When you select an experiment in the XNAT tree, the Experiment information is shown in the Detailed information widget and you can perform the following actions with it:

Import URLs

If only one experiment is selected, a Core::ImageTypeId Core::DataEntity is created containing the following information in its metadata:

You will find a RemotePath tag containing:

  • User and Password.
  • Type (in this case, it will always be "XNAT")
  • URL will contain the URL where you can directly download the experiment.


If several experiments are selected, also a single data entity will be created. It will also have the RemotePath tag but with this information:

  • User and Password.
  • Type (in this case, it will always be "XNAT")
  • URLs will contain multiple URL tags


This data entity can be used like any other Core::ImageTypeId data entity, but it will not have any processing data until the application (maybe running in another machine) needs it and downloads it.

Download

Downloads the image experiment into the local XNAT database.

Load

Does the same as download and opens the selected file in Gimias after uncompressing it.

Go back to Users