Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...
Transcript of Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...
![Page 1: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/1.jpg)
An open multi-software framework for non-human primate anatomical MRI processingDavid Meunier, Bastien Cagna, Kep Kee Loh, Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier Coulon, Pascal Belin
Macapype
Presentation RMN Centre IRM Cerimed, 10/09/2020
1
![Page 2: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/2.jpg)
How it all started:● starting from the local hackathon on monkey MRI processing● different teams working with macaques were having different
approach on PNH MRI processing
A common framework:● each approach may be optimal for different set of acquisitions● how to compare them (bash scripts, matlab code, etc)?
-> develop a common framework to share the knowledge -> make Marseille great again!
2
History
Outline
Kepkee will introduce the rationale of PNH MRI processing and the PRIME-RE initiative
David and Bastien will present macapype, a tool dedicated to build PNH MRI pipelines
![Page 3: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/3.jpg)
Kep Kee
3
![Page 4: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/4.jpg)
Nonhuman Primate (NHP) /Comparative MRIUsing MRI to study NHP brains, and compare them with humans..
![Page 5: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/5.jpg)
Nonhuman Primate (NHP) /Comparative MRIUsing MRI to study NHP brains, and compare them with humans..
Key Advantages
• Less invasive...
• Repeatable *******
• Equivalent measurements across individuals and species
• Multimodal - gives a complete picture of the brain.. (DTI, rs-fMRI, sMRI…)
• Digital – data-sharing, public databases, big data..
![Page 6: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/6.jpg)
Nonhuman Primate (NHP) /Comparative MRIUsing MRI to study NHP brains, and compare them with humans..
Key Advantages
• Less invasive...
• Repeatable *******
• Equivalent measurements across individuals and species
• Multimodal - gives a complete picture of the brain.. (DTI, rs-fMRI, sMRI…)
• Digital – data-sharing, public databases, big data..
Autio et al 2020
Cottereau et al 2017
![Page 7: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/7.jpg)
7
Nonhuman Primate (NHP) /Comparative MRIUsing MRI to study NHP brains, and compare them with humans..
Key Advantages
• Less invasive...
• Repeatable *******
• Equivalent measurements across individuals and species
• Multimodal - gives a complete picture of the brain.. (DTI, rs-fMRI, sMRI…)
• Digital – data-sharing, public databases, big data.. Roumazeilles et al 2020
http://www.j-monkey.jp/BIR/about_e.html
Amiez et al 2019
Eichert et al 2020
![Page 8: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/8.jpg)
NHP MRI – An emergent and “open” field
Neuroimage, under review
Neuroimage, under review
Comparative MRI Consortium
(no logo yet…)
https://prime-re.github.io/
8
![Page 9: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/9.jpg)
Getting started on NHP MRI (processing)!
https://prime-re.github.io/ https://github.com/PRIME-RE/prime-re.github.io/wiki
9
![Page 10: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/10.jpg)
NHP MRI processing – same same, but different..
Typical human anatomical pipeline
Dicom2nii
Reorientation/denoising/ bias-correction
Skull-stripping
Tissue Segmentation
Normalise to standard space (MNI)
Registration with functional/DTI
pretty-good T1 (uc davis dataset)
10
quite-good T1 (newcastle dataset)
![Page 11: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/11.jpg)
NHP MRI data processing – Key challenges…
1. Non-classic orientations2. Non-head/brain parts3. Bias-correction4. Denoising5. Registration6. Segmentation
11
![Page 12: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/12.jpg)
NHP MRI data processing – Solutions
https://github.com/PRIME-RE/prime-re.github.io/wiki/Structural-processing
• Involves a “mix-n-match” of available neuroimaging tools and codes.
• Need to adapt to various acquisitions.
• No one single pipeline to rule them all..
12
![Page 13: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/13.jpg)
David
13
![Page 14: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/14.jpg)
What is macapype?
Nipype-based framework:
Nipype wraps the most used softwares in Neuroimaging i.e. FSL/SPM/AFNI/ANTS
(Quick self ad):neuropycon for EEG/MEG (ephypype) and functional connectivity / graph analysis (graphpype)
14
![Page 15: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/15.jpg)
What is macapype? Nipype-based framework:
● Notion of pipeline/nodes: design of sequences that can be easily re-used, or re-combined
Based on the notion of workflow
A workflow is a sequence of nodesEach node is a step in the full processing
it can call another program (interface/ wrapper) or be written by the user (in python)
A node in the workflow can be a workflow itself (by convention, called a pipeline) 15
![Page 16: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/16.jpg)
FunctionalitiesWraps of specific NHP tools
• AtlasBREX:
• a specific tool for brain extraction,
• multiple fine-grain parameters for contrast differences
• NMTSubjectAlign:
• Advanced tools for normalisation to NMT template
• also works for normalisation to other templates
16
![Page 17: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/17.jpg)
FunctionalitiesWraps of specific NHP tools
• AtroposN4: Ants based tools for segmentation
• Shell-based tools by Regis Trapeau:
• IterREG, T1xT2BiasCorrection, T1xT2BET, etc.)
17
![Page 18: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/18.jpg)
General scheme of the pipelinesSplit in 3 big categories
• Data preparation
• Brain extraction
• Segmentation
2 types of input data
• T1/T2 available
• T1 only (~ work in progress ?)
18
![Page 19: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/19.jpg)
General scheme of the pipelines● Data preparation
• short (using the T1xT2BET by Regis),
• long single (average same modality images, then crop and N4debias)
• long multi (crop and N4debias before average same modality images)
19
![Page 20: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/20.jpg)
Wrapped pipelinesPipeline by Kepkee: ANTS-based T1*T2
data preparation
brain extraction
brain segmentation
20
![Page 21: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/21.jpg)
Wrapped pipelinesPipeline by Kepkee: ANTS-based T1*T2
• data preparation (long single)
• average same modality images,
• crop
• N4debias
• denoise
• then align T2 on T1
21
![Page 22: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/22.jpg)
Wrapped pipelinesPipeline by Kepkee: ANTS-based T1*T2
Brain extraction:
AtlasBREX
first T1*T2BiasCorrection (sub-pipeline)
! Local know-how !
22
![Page 23: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/23.jpg)
Wrapped pipelinesPipeline by Kepkee: ANTS-based T1*T2
• Brain segmentation
AtroposN4 (ANTS)
Normalisation of the NMT template to native space
! Local know-how !
T1*T2 bias correctionon masked T1 (i.e. brain only)
! Local know-how !
23
![Page 24: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/24.jpg)
Bastien
24
![Page 25: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/25.jpg)
25SPM based pipelines
T1w + T2w Only T1w
Pipelines designed by Regis Trapeau
![Page 26: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/26.jpg)
● Anaconda cloudconda install -c macatools macapype
● PIPpip install macapype
● Github (source code)git clone https://github.com/Macatools/macapype.gitcd macapypepython setup.py install
26How to use Macapype ?
![Page 27: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/27.jpg)
python segment_pnh.py -data /path/to/my/bids/data -out /path/to/output/directory -soft SPM_t1 -params params_segment_macaque_spm_based.json -subjects Elouk Apache -acq 0p4mm -indiv_params indiv_params_segment_macaque_spm_based.json
Ready to use workflow:BIDS directory Output directory
Pipeline to use (SPM, SPM_T1 or ANTS) JSON parameters
file (opt.)Subjects names
Acquisition name (opt.)
JSON file for individual parameters (opt.)
27How to use Macapype ?
![Page 28: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/28.jpg)
Ready to use workflow:
python segment_pnh.py -data /path/to/my/bids/data -out /path/to/output/directory -soft SPM_t1 -params params_segment_macaque_spm_based.json -subjects Elouk Apache -acq 0p4mm -indiv_params indiv_params_segment_macaque_spm_based.json
28How to use Macapype ?
![Page 29: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/29.jpg)
New python script:
New nipype workflow:
29
29How to use Macapype ?
![Page 30: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/30.jpg)
30Nipype tools: Parallel processing & caching
Several running strategies:● Simple processing
● Multicores processing
● Others parallel processing
Caching:Re-run the pipeline = starting where it has stopped
![Page 31: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/31.jpg)
Earlier tests on macaque:- iterative FLIRT/FNIRT- OldSegment SPM
Data courtesy of Regis Trapeau/Pascal Belin. For more information, see https://macatools.github.io/macapype/auto_examples/plot_segment_macaque_spm_based.html
31Some results on macaque
![Page 32: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/32.jpg)
Macaque (same dataset):- atlasbrex- ANTS atropos
Data courtesy of Regis Trapeau/Pascal Belin. For more information, see https://macatools.github.io/macapype/auto_examples/plot_segment_macaque_ants_based.html
32Some results
![Page 33: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/33.jpg)
infant baboon (same dataset):- atlasbrex (using adult template)- ANTS atropos
Data courtesy of Yannick Becker/Adrien Meguerditchian (ERC GestImage). For more information, see https://macatools.github.io/macapype/auto_examples/plot_segment_baboon_ants_based.html
33Some results: on baboons
![Page 34: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/34.jpg)
Also tried on marmoset (from cerimed 3T):- atlas brex (different settings)- ANTS atropos
Data courtesy of Thomas Brochier/Frederic Chavane (Marmobrain project). For more information, see https://macatools.github.io/macapype/auto_examples/plot_segment_marmo_ants_based.html
34Some results: on marmoset
![Page 35: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/35.jpg)
https://macatools.github.io/macapype
35Online Documentation
![Page 36: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/36.jpg)
● Test it!● Install Macapype● Input your data to the segmentation workflow● Wait and see what append!● Use mattermost channel to get some help or report bugs or failures
https://framateam.org/signup_user_complete/?id=ebtxf45nmiyqmkm8e6oh9qjsoe
● Be part of the development● Fork the github repository● Create a new branch● Modify the package (adding new features or pipelines)● Submit a pull request
36How to contribute ?
![Page 37: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/37.jpg)
Thanks for your attention !
This is the “unofficial logo”, let us know what you think...
david.meunier AT univ-amu.fr
Further information?
37
![Page 38: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/38.jpg)
Macapype links:Official Repo:https://github.com/Macatools/macapypeDocumentation:https://macatools.github.io/macapype/index.htmlPYPI : https://pypi.org/project/macapype/Docker hub:https://hub.docker.com/r/macatools/macapype
Useful links:PRIME-RE: https://github.com/PRIME-RE/prime-re.github.io/wiki
PRIME-DE: http://fcon_1000.projects.nitrc.org/indi/indiPRIME.html38
![Page 39: Régis Trapeau, Julien Sein, Sylvain Takerkart, Olivier ...](https://reader031.fdocuments.us/reader031/viewer/2022012511/618a18f0bf0cea07d42e23fc/html5/thumbnails/39.jpg)
ReferencesNipype :Gorgolewski, K et al. (2011). Nipype: a flexible, lightweight and extensible neuroimaging data processing framework in Python. Front. Neuroinform.5:13.BIDS : Gorgolewski, K et al. (2016). The brain imaging data structure, a format for organizing and describing outputs of neuroimaging experiments. Sci Data.3:160044.AtlasBREX : Lohmeier, J et al. (2019). AtlasBREX: Automated template-derived brain extraction in animal MRI. Sci Rep. 9(1):12219NMT template and scripts : Seidlitz J et al. (2018). A population MRI brain template and analysis tools for the macaque. Neuroimage 170:121-131
39