![Page 1: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/1.jpg)
1
XNAT and Basic Knowledge Vanderbilt University
2013-09-23
Benjamin Yvernault,
Bennett Landman, Brian Boyd
![Page 2: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/2.jpg)
2
After this short course, you will be able to:
– Register and Log in to XNAT– See your projects and join other projects– Manage access permissions– Browse data and view image previews – Search for projects/subjects/sessions and
corresponding data– Download images and stored meta-data
![Page 3: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/3.jpg)
3
Register and login
XNAT : http://xnat.vanderbilt.edu/xnat
Register by clicking the link and completing the form. Enter username and password if you already have an account
![Page 4: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/4.jpg)
4
PI Account Info
XNAT account for PI with an IRB approval are automatically createdUsername : firstnamelastnamePassword : random password
Click “Forgot password or username” to retrieve your username and reset your password for the first connection.
![Page 5: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/5.jpg)
5
XNAT Home Screen
Click a project to go to the project view (slide 6)
« Other projects » : list of projects where you don’t have access. Option to request access to a project.List of your Projects
![Page 6: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/6.jpg)
6
Request access to a Project
List of projects where you don’t have access.
![Page 7: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/7.jpg)
7
E-mail sent to all owners
An email is sent to all owners of a project when requesting access. Any owner can grant you access by clicking on the link
XNAT email address : [email protected]
![Page 8: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/8.jpg)
8
XNAT Data Hierarchy
• Project– Subject
• Experiment / Session– Scan
» Resources : Raw Image Data (various formats, thumbnail snapshots, log files)
– Assessor / Processing» Resources : processed Data (output images/files,
PBS scripts, outlog files, text files)
![Page 9: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/9.jpg)
9
Project View
Click on a subject to access the subject view (slide 8)
List of subjects
Project overview
« Access » tab to manage users access for the project
![Page 10: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/10.jpg)
10
Give access to a project
Tools to add users
Access levels:• Collaborator• Member• Owner
« Show List » gives the list of all XNAT users
![Page 11: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/11.jpg)
11
Access Levels in XNAT Data relationship between projects :
Shared (read-only) : Data shared from another project can be deleted. You need access to the primary project.
Owned (All access) : Data owned by the project. Access depends on the user access.
User Access :Collaborator : users with read-only access
E.G : Consultant, people off site …
Member : users with management permissions on the data that the project owns. WARNING: no access to the prearchiveE.G : Image Analyst…
Owner : users with all permissions on the data owned by the project and the project itselfE.G: PI, Engineers, developers, script runners, Image Analyst, etc…
![Page 12: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/12.jpg)
12
User Roles and Permissions
More information at :https://wiki.xnat.org/display/XNAT16/User+Roles+and+Permissions
![Page 13: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/13.jpg)
13
Subject View
Click on a Session to access the session view (slide 9)
![Page 14: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/14.jpg)
14
Session View
![Page 15: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/15.jpg)
15
What’s the difference between scans and processes?
Scan : raw data coming from a scanner with different transcodings/formats (e.g. T1 with DICOM, NIFTI and PAR/REC format)
Processing (or Assessor in XNAT vocabulary) : processed Data. All files produced by a script using data from one scan / multiple scans / another Processing data.
![Page 16: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/16.jpg)
16
Scan View (1)
« Show Counts » can take a few seconds to load
« Show Counts » shows the resources/images raw presents
Preview of the Raw Data (DICOM/NIFTI)
![Page 17: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/17.jpg)
17
Scan View (2)
Preview of the Raw Data (DICOM/NIFTI)
Show Counts
![Page 18: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/18.jpg)
18
Processing View (1)« Show Counts » to see the resources / output
Link to the process overview (slide 13)
PDF download link
show preview of process (snapshots)
Don’t worry if it takes a while to show / pop up for the PDF and Show Counts
![Page 19: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/19.jpg)
19
Processing View (2)
See preview
Show Counts
![Page 20: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/20.jpg)
20
Processing Overview
![Page 21: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/21.jpg)
21
How to use XNAT Search
Four ways of searching within XNAT
1) Quick search
2) Advanced search
4) Data & Stored Searches3) Tabs (Project, Subject, …)
![Page 22: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/22.jpg)
22
How to use “quick search”?
Type a label that you want to search/access e.g. search “208404”
Useful when you know what you are looking forE.G : I am looking for the subject 208404
Only works if the label exists in the database
Results: Two projects one subject one experiment
Link to access data
![Page 23: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/23.jpg)
23
How to use “advanced search”?
Advanced search is difficult to understand Avoid using it unless you really want to understand how it
works (slide 26 for more details)
Link to the XNAT wiki : https://wiki.xnat.org/display/XNAT16/Using+Advanced+Search
![Page 24: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/24.jpg)
24
How to use the tabs to search? (1)
You can use only one tab at a time
![Page 25: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/25.jpg)
25
How to use the tabs to search? (2)
Search on sessions with “2”
Why?
Filters
![Page 26: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/26.jpg)
26
Warning with search :
XNAT identifies a Session / Subject / Process by a Label or a ID (both unique, Scan ID and label are the same)
XNAT IDs are automatically generatedXNAT searches both Label and IDAdvanced Search will check only the ID and
most of the time you don’t know the ID but the Label
![Page 27: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/27.jpg)
27
Create your own search (1)
Use Data & Stored Searches
13253 processings
![Page 28: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/28.jpg)
28
Create your own search (2)
Let’s search all processing that are running Filter : procstatus = Running
![Page 29: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/29.jpg)
29
Result of your own search (3)
13,253 Processes only 7 running
![Page 30: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/30.jpg)
30
Options for the search
Spreadsheet will download the content of the tab as a .csv file
Email will send a link to the search Save (x2) will be explain next slide Show XML displays the spreadsheet data
in XML format You can “Add columns” to your
spreadsheet Join to … will give you the possibility to
add an other type of search
![Page 31: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/31.jpg)
31
Add columns Some information are missing. E.G: what is the project for each process?
![Page 32: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/32.jpg)
32
Save your own search
Using the options save search will open a pop-window You should use “Save New Search” when you are using a previous
search that you don’t want to delete
![Page 33: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/33.jpg)
33
Reopen your search : “Stored search”
![Page 34: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/34.jpg)
34
Download Data
Downloading Data with the Action Menu on the session page : Using « Manage Files » Using « Download Images »
![Page 35: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/35.jpg)
35
Download Images
![Page 36: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/36.jpg)
36
Manage Files
1. Check the data to download
2. Select the format3. Hit Download
Click the link to download only one file
![Page 37: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/37.jpg)
37
WARNING The scissors will delete the resources/images/output files. Use with caution
![Page 38: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/38.jpg)
38
Interactive Assignment
• Create an account or login to your account• Log in as “vuiistest” password “password” and grant
yourself ‘MEMBER’ access to the project VUSTP. • Count the number of scans in the project• Count the number of sessions in the project • Find an MPRAGE scan• Create a stored search for MPRAGE scans• Download an MPRAGE image
![Page 39: XNAT and Basic Knowledge Vanderbilt University 2013-09-23 Benjamin Yvernault, Bennett Landman, Brian Boyd 1](https://reader038.vdocuments.us/reader038/viewer/2022110401/56649e295503460f94b16b99/html5/thumbnails/39.jpg)
39
Next time
• Create project / sharing data• Delete scans / sessions / projects• Use the Pre-Archive• Upload scans through DicomBrowser• Quality Assurance
– Mark scans as usable / questionable / etc.
– Mark processing status
– View QA results in RedCAP
• Use Basic XNAT tools on ACCRE