Pre/Post-processing pipeline for tractography wrapped around nipype and mrtrix3
Project description
Pipetography
Nipype and mrtrix3 based pre-/post- processing pipeline for brain diffusion-MRI and generation of structural connectomes of the brain.
The pre-processing workflow has been updated to reflect what's seen in the optimal DESIGNER pipeline and on mrtrix3 cloud apps on brainlife.io.
The post-processing pipeline, including co-registration of atlases and connectome generation is now included in the connectomes module
Install
Since most usages will be on HPC resources, I highly recommend that you use the Singularity
definition file in the repository instead of installing the Python module.
Singularity:
-
This is a large image, you will need to set the following environment variables to somewhere other than
/tmp
if you want to avoid memory errors:export SINGULARITY_TMPDIR={YOUR DESTINATION DIR}
export SINGULARITY_LOCALCACHEDIR={YOUR DESTINATION DIR}
export SINGULARITY_CACHEDIR={YOUR DESTINATION DIR}
export SINGULARITY_PULLFOLDER={YOUR DESTINATION DIR}
-
Build the singularity image with the
singularity.def
file provided in Github, you will need to havesudo
permissions to perform singularity build. If you run into memory problems, consider building as a sandbox at first with the-s
flag.sudo singularity build {image_file_name}.sif singularity.def
-
OR pull the built singularity image from cloud library:
singularity pull --arch amd64 library://axiezai/pipetography/pipetography:0.3.6
-
To run interactively or as a job execution, you will need a few flags:
-e -c
flags for a clean environnment upon container start-B
to bind your data & code directories.- Example:
singularity shell -e -c -B <BIDS_DIR>:<SINGULARITY_BIDS_DIR> {Path to singularity .sif}
Creating your own environment and install pipetography
as a Python module:
pip install pipetography
Since pipetography
is a Nipype
wrapper around mrtrix3
, ANTs
, and FSL
, you have to follow their installation instructions and set them up appropriately on your machine as well:
Everything listed in this section is included in the Singularity and Docker containers.
The pipeline:
Currently supports acquisitions with no reverse phase encoding (-rpe_none
) and reverse phase encoding in all DWI directions (-rpe_all
) options. See pipeline for preprocessing details, and connectomes for postprocessing details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pipetography-0.3.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6721593f0edfaa7eb9ea626c61dd91433631fc67a5c46e00a3845bf517ba98b1 |
|
MD5 | da27c1aa847d836ce478b1d261279e7a |
|
BLAKE2b-256 | ebb0a40368f38b1a7c33f8af12ace371010ef01496bf9268fd335d405027ba7c |