Difference between revisions of "Slicer3:XND"

From Slicer Wiki
Jump to: navigation, search
 
(37 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
==Important Note==
 +
'''This tutorial was created using XNAT Desktop 0.2.''' A new version (0.3) is now available, with slightly different interface and functionality. Until this example is updated to reflect those changes, it remains very easy to translate between the steps here and the new presentation layer and functionality.
 +
 +
Some differences between the two are listed here to help in the translation between versions:
 +
* '''Remove''' and '''Remove all''' in the dropdown menu have been changed to '''Unmanage''' and '''Unmanage all'''
 +
* Now multiple experiments can be uploaded at once, rather than having to upload each experiment independently.
 +
* '''Delete''' in the dropdown menu has been changed to '''Unmanage root directory'''
 +
* The set of tags available to choose in the '''Manage tags''' or '''Manage local tags''' interface is a little different.
 +
* The '''Set Predefined Tags''' or '''Set default tags''' reflects those new tags.
 +
* The console view is now persistent on the interface bottom, rather than being optionally exposed in a tab.
 +
 
==Example: Uploading data (non-dicom) to central.xnat.org using XNAT Desktop==
 
==Example: Uploading data (non-dicom) to central.xnat.org using XNAT Desktop==
  
Line 35: Line 46:
  
 
===Switch to tag view and check data description===
 
===Switch to tag view and check data description===
 +
"Tag view" organizes all tagged data according to its description. This view makes it easy to notice and fix errors in the data description.
  
 
[[image:XNDtagview.png]]
 
[[image:XNDtagview.png]]
Line 42: Line 54:
 
===Fixing misspecified tags===
 
===Fixing misspecified tags===
  
Any or all tags can be removed from managed files using the "Remove tag" or "Remove all" menu options as shown below. If you see any errors, remove a tag, and re-specify its value if appropriate.
+
Any or all tags can be removed from managed files using the "Remove tag" or "Remove all" menu options as shown below (in "Folder view"). If you see any errors, remove a tag, and re-specify its value if appropriate.
  
[[image:XNDremovetag.png]]
+
[[image:XNDremovetags.png]]
  
  
Line 53: Line 65:
  
 
[[image:XNDcreateproject.png]]
 
[[image:XNDcreateproject.png]]
 +
 +
  
 
===New project on hosted repository should correspond to local data description===
 
===New project on hosted repository should correspond to local data description===
  
 
[[image:XNDnewproject.png]]
 
[[image:XNDnewproject.png]]
 
  
 
===Create a subject for each subject in the data to be uploaded===
 
===Create a subject for each subject in the data to be uploaded===
  
 
[[image:XNDcreatesubjects.png]]
 
[[image:XNDcreatesubjects.png]]
 +
 +
  
 
===New subjects should correspond to local data description===
 
===New subjects should correspond to local data description===
Line 72: Line 87:
  
 
[[image:XNDnewsubject2.png]]
 
[[image:XNDnewsubject2.png]]
 +
 +
  
 
===Upload files to the hosted repository===
 
===Upload files to the hosted repository===
  
The current release version of XNAT Desktop actually can only upload one experiment at a time. Using this version, to upload each experiment, select it in the tag view hierarchy and use the upload tool as shown below.  
+
The current release version of XNAT Desktop actually can only upload '''one experiment at a time'''. Using this version, to upload each experiment, select it in the tag view hierarchy and use the upload tool as shown below.  
  
 
A new version of XNAT Desktop to be released soon supports uploading multiple experiments, and has also a number of important upload bug fixes.
 
A new version of XNAT Desktop to be released soon supports uploading multiple experiments, and has also a number of important upload bug fixes.
Line 86: Line 103:
  
 
[[image:XNDconsole.png]]
 
[[image:XNDconsole.png]]
 +
 +
  
 
===Check hosted repository for upload results===
 
===Check hosted repository for upload results===
Line 91: Line 110:
 
[[image:XNDresult.png]]
 
[[image:XNDresult.png]]
  
===Removing tags from data managed by XND===
 
  
[[image:XNDremovetags.png]]
 
  
[[image:XNDremovetag.png]]
+
 
 +
 
 +
===Adding more data to the project on hosted repository===
 +
 
 +
To add more data to an existing subject in the same project on the hosted repository, first manage the new data you wish to add, choose tags for the new data and add values to those tags. You may decide to use the same value for the Experiment tag, or a new value as shown below in this example. Be sure to use the same value for the Project and Subject tags as you did for the previous upload of data for that Project/Subject so this new data will be correctly associated in the repository.
 +
 
 +
[[image:XNDaddingMoreData.png]]
 +
 
 +
Then select the experiment and upload the data as before. Progress can be tracked in the Console view, and when uploading is finished and successful, the hosted repository can be checked to make sure that the data is uploaded and represented as intended.
 +
 
 +
==Downloading an XNAT catalog of selected data from central.xnat.org ==
 +
On central.xnat.org, navigate to the Project and MR Session of interest. Then, choose "Download Images" from the options provided, as shown below.
 +
 
 +
[[image:XNDdownloadXCAT.png]]
 +
 
 +
In the pop-up dialog, make sure to choose "catalog XML" as the format for your download. Select only the datasets you'd like to include in the catalog. '''Important note: Slicer3's current implementation can only handle single data files. Datasets represented by separate header and data files (like Analyze), or multiple data files (like DICOM) will not currently work with Slicer.''' This functionality is currently being developed. When you've configured the download request, click the download button as shown in the figure below.
 +
 
 +
[[image:XNDdownloadXCAT2.png]]
 +
 
 +
 
 +
 
 +
==Loading an XNAT catalog into Slicer3==
 +
 
 +
To load the catalog into Slicer3, start up the application, and choose "File->Load" from the Application Menubar.
 +
 
 +
[[image:XNDxcatFileLoad.png]]
 +
 
 +
In the File browser that is raised, select all scene files, or filter on just .xcat files. Select the catalog file you wish to open as shown below. The Cache and Remote I/O Manager dialog should raise and show you the status and progress of the download process.
 +
 
 +
[[image:XNDxcatFileBrowse.png]]

Latest revision as of 17:06, 7 August 2008

Home < Slicer3:XND

Important Note

This tutorial was created using XNAT Desktop 0.2. A new version (0.3) is now available, with slightly different interface and functionality. Until this example is updated to reflect those changes, it remains very easy to translate between the steps here and the new presentation layer and functionality.

Some differences between the two are listed here to help in the translation between versions:

  • Remove and Remove all in the dropdown menu have been changed to Unmanage and Unmanage all
  • Now multiple experiments can be uploaded at once, rather than having to upload each experiment independently.
  • Delete in the dropdown menu has been changed to Unmanage root directory
  • The set of tags available to choose in the Manage tags or Manage local tags interface is a little different.
  • The Set Predefined Tags or Set default tags reflects those new tags.
  • The console view is now persistent on the interface bottom, rather than being optionally exposed in a tab.

Example: Uploading data (non-dicom) to central.xnat.org using XNAT Desktop

Manage files to upload

First, select local directories/folders or individual files to manage with XNAT Desktop.

Select the Add managed directory icon, choose Repository->Add dir, or right click on a directory/folder for a menu option to manage that folder with XNAT Desktop, as shown below. Or, right click on an individual file for a menu option to manage that file.

XNDmanage2.png


Select tags for local data

Next, choose tags for describing your data using the icon on the toolbar, or the Repository->Manage tags menu option. XNAT has a set of default tags that are important to use, and custom tags can be added using the "New" option on the pop-up, as shown below.

XNDchoosetags2.png

Provide tag values for files you want to upload

Using the "Set Default tags" option, select datasets to be described, and quickly add values for the tags you chose in the previous step. These values will apply to all selected datasets.

XNDsetdefaulttags1.png

XNDsetdefaulttags2.png

Or select individual datasets to be described, and add values for appropriate tags to each through the "Set tag" menu option. Note, in this example, the Experiment tag for each subject 01030 and 01053 are unique: Normal_Subjects_01030 and Normal_Subjects_01053, respectively.

XNDsettag1.png

XNDsettag2.png


Switch to tag view and check data description

"Tag view" organizes all tagged data according to its description. This view makes it easy to notice and fix errors in the data description.

XNDtagview.png


Fixing misspecified tags

Any or all tags can be removed from managed files using the "Remove tag" or "Remove all" menu options as shown below (in "Folder view"). If you see any errors, remove a tag, and re-specify its value if appropriate.

XNDremovetags.png


Create a project on the hosted repository

In this example, the hosted respository is http://central.xnat.org

XNDcreateproject.png


New project on hosted repository should correspond to local data description

XNDnewproject.png

Create a subject for each subject in the data to be uploaded

XNDcreatesubjects.png


New subjects should correspond to local data description

Adding subject 01030.

XNDnewsubject1.png

Project display after adding two subjects.

XNDnewsubject2.png


Upload files to the hosted repository

The current release version of XNAT Desktop actually can only upload one experiment at a time. Using this version, to upload each experiment, select it in the tag view hierarchy and use the upload tool as shown below.

A new version of XNAT Desktop to be released soon supports uploading multiple experiments, and has also a number of important upload bug fixes.

XNDupload1.png

XNDupload2.png

Check progress in the XND console

XNDconsole.png


Check hosted repository for upload results

XNDresult.png



Adding more data to the project on hosted repository

To add more data to an existing subject in the same project on the hosted repository, first manage the new data you wish to add, choose tags for the new data and add values to those tags. You may decide to use the same value for the Experiment tag, or a new value as shown below in this example. Be sure to use the same value for the Project and Subject tags as you did for the previous upload of data for that Project/Subject so this new data will be correctly associated in the repository.

XNDaddingMoreData.png

Then select the experiment and upload the data as before. Progress can be tracked in the Console view, and when uploading is finished and successful, the hosted repository can be checked to make sure that the data is uploaded and represented as intended.

Downloading an XNAT catalog of selected data from central.xnat.org

On central.xnat.org, navigate to the Project and MR Session of interest. Then, choose "Download Images" from the options provided, as shown below.

XNDdownloadXCAT.png

In the pop-up dialog, make sure to choose "catalog XML" as the format for your download. Select only the datasets you'd like to include in the catalog. Important note: Slicer3's current implementation can only handle single data files. Datasets represented by separate header and data files (like Analyze), or multiple data files (like DICOM) will not currently work with Slicer. This functionality is currently being developed. When you've configured the download request, click the download button as shown in the figure below.

XNDdownloadXCAT2.png


Loading an XNAT catalog into Slicer3

To load the catalog into Slicer3, start up the application, and choose "File->Load" from the Application Menubar.

XNDxcatFileLoad.png

In the File browser that is raised, select all scene files, or filter on just .xcat files. Select the catalog file you wish to open as shown below. The Cache and Remote I/O Manager dialog should raise and show you the status and progress of the download process.

XNDxcatFileBrowse.png