Name: datman
Owner: Kimel Family Translational Imaging-Genetics Research Lab
Description: scripts for managing xnat, QC, and data analysis
Created: 2015-01-20 17:03:11.0
Updated: 2017-07-03 22:57:26.0
Pushed: 2018-01-04 16:29:25.0
Size: 85373
Language: Python
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
A set of python scripts we use for three major functions:
links
definitions
dependencies
setup
Datman requires that each project in XNAT's Define Prearchive Settings
under Manage
be set to 'All image data will be placed into the archive automatically and will overwrite existing files. Data which doesn't match a pre-existing project will be placed in an 'Unassigned' project.'
To setup the datman python package:
git clone https://github.com/tigrlab/datman cd datman conda env create && . activate datman-env # only if you are using anaconda python setup.py install
Your environment needs to be set up as so:
DATMAN_ASSETS
to point to datman/assets.and
MATLABPATH`.Datman runs a standard QC pipeline on all major datatypes. It largely does this using the qcmon project.
We QC the data at two levels: single subject, and chronologically. When QCing a single subject, we're looking for major artifacts in the data, or problems with the subject (tumors, strokes, etc). When we are QCing chronologically, we're looking for things in one subject that look rather different from all of the others (or most of the others). This is a good practice when you don't know of a good 'cut-off'. For example, no one know what SNR number is so low that the data becomes corrupted.
The report generator also runs all of the QC metrics on our data. These files are placed (for each subject) in:
/archive/data/${project}/qc/${subject}
A single-subject report will be generated here:
/archive/data/${project}/qc/${subject}/qc_${subject}.html
.
All other files are used for chronological analysis. They will have a 'prefix' being the nifti file it was generated from. So SPN01_ZHH_0018_01_01_RST_06_Resting-State-212_spectra.csv
is the spectra of SPN01_ZHH_0018_01_01_RST_06_Resting-State-212.nii.gz
human fmri metrics
${prefix}_stats.csv
${prefix}_spectra.csv
: average and standard deviation of the BOLD timeseries spectra across the brain.${prefix}_scanlength.csv
: number of TRs in the obtained scan.${prefix}_qascripts_bold.csv
: a collection of QA measures from the qascripts package${prefix}_fd.csv
: framewise displacement vector (instantaneous head motion, per TR).${prefix}_corr.nii.gz
: per-voxel correlation of each voxel with the rest of the brain.${prefix}_sfnr.nii.gz
: per-voxel signal fluctuation to noise ratio.human dti metrics
${prefix}_stats.csv
:${prefix}_qascripts_dti.csv
:phantom ADNI metrics
This tracks the T1 weighted value across the 5 primary ROIs in the ADNI phantom, and the T1 ratios between each of the higher ones with the lowest one. For more information, please see http://www.phantomlab.com/library/pdf/magphan_adni_manual.pdf.
+ mean s1, s2, s3, s4, s5
+ intensitiy ratios: s2/s1, s3/s1, s4/s1, s5/s1
phantom fBIRN fMRI
This uses the fBIRN pipeline to define % signal fluctuation, linear drift, signal to noise ratio, signal-to-fluctuation noise ratio, and radius of decorrelation. For more information, please see [1], http://www.ncbi.nlm.nih.gov/pubmed/16649196.
phantom fBRIN DTI
A pipeline designed by Sofia Chavez to assess the performance of DTI protocols.
further reading
[1] Spurious but systematic correlations in functional connectivity MRI networks arise from subject motion. Jonathan D. Power et al. 2011. Neuroimage 59:3. [2] Report on a multicenter fMRI quality assurance protocol. Friedman L et al. 2006. J Magn Reson Imaging 23(6).
Who dat Who dat Who dat Who dat Who dat Who dat Who dat Who dat Who dat man?