-
Develop a standardized acquisition protocol for whole-body quantitative MRI of muscle for the most common MR manufacturers.
-
Generate an open-source large (n≥1,000) annotated multi-site, multi-racial, and multi-ethnic heterogenous whole-body muscle MRI dataset across the lifespan using the standardized acquisition protocol.
-
Create an open-source toolbox for the analysis of whole-body muscle morphometry and composition using the hetergenous whole-body muscle MRI dataset.
We are currently developing the standardized acquisition protocol for whole-body quantitative MRI of Muscle. You can access the Google doc here. To collaborate on the standardized acquisition protocol, please contact us.
We strongly recommend following the Brain Imaging Data Structure (BIDS) specification for organizing your dataset.
Click to see an example BIDS directory structure.
```
dataset
├── derivatives
│ └── labels
│ └── sub-example01
│ └── sub-example02
│ ├── ses-abdomen
│ │ └── anat
│ │ ├── sub-example02_ses-abdomen_T2w_label-muscle_dseg.json
│ │ └── sub-example02_ses-adomen_T2w_label-muscle_dseg.nii.gz
│ │ ├── sub-example02_ses-abdomen_water_label-muscle_dseg.json
│ │ └── sub-example02_ses-adomen_water_label-muscle_dseg.nii.gz
│ └── ses-neck
│ └── anat
│ ├── sub-example02_ses-neck_water_label-muscle_dseg.json
│ └── sub-example02_ses-neck_water_label-muscle_dseg.nii.gz
└── sourcedata
└── participants.tsv
└── sub-example01
└── sub-example02
├── ses-abdomen
│ ├── anat
│ │ ├── sub-example02_ses-abdomen_fatfrac.json
│ │ ├── sub-example02_ses-abdomen_fatfrac.nii.gz
│ │ ├── sub-example02_ses-abdomen_fat.json
│ │ ├── sub-example02_ses-abdomen_fat.nii.gz
│ │ ├── sub-example02_ses-abdomen_inphase.json
│ │ ├── sub-example02_ses-abdomen_inphase.nii.gz
│ │ ├── sub-example02_ses-abdomen_outphase.json
│ │ ├── sub-example02_ses-abdomen_outphase.nii.gz
│ │ ├── sub-example02_ses-abdomen_R2star.json
│ │ ├── sub-example02_ses-abdomen_R2star.nii.gz
│ │ ├── sub-example02_ses-abdomen_T1w.json
│ │ ├── sub-example02_ses-abdomen_T1w.nii.gz
│ │ ├── sub-example02_ses-abdomen_T2w.json
│ │ ├── sub-example02_ses-abdomen_T2w.nii.gz
│ │ ├── sub-example02_ses-abdomen_water.json
│ │ └── sub-example02_ses-abdomen_water.nii.gz
│ └── dwi
│ ├── sub-example02_ses-abdomen_dwi.bval
│ ├── sub-example02_ses-abdomen_dwi.bvec
│ ├── sub-example02_ses-abdomen_dwi.json
│ └── sub-example02_ses-abdomen_dwi.nii.gz
└── ses-neck
└── anat
├── sub-example02_ses-neck_fat.json
├── sub-example02_ses-neck_fat.nii.gz
├── sub-example02_ses-neck_fatfrac.json
├── sub-example02_ses-neck_fatfrac.nii.gz
├── sub-example02_ses-neck_inphase.json
├── sub-example02_ses-neck_inphase.nii.gz
├── sub-example02_ses-neck_outphase.json
├── sub-example02_ses-neck_outphase.nii.gz
├── sub-example02_ses-neck_R2star.json
├── sub-example02_ses-neck_R2star.nii.gz
├── sub-example02_ses-neck_T2w.json
├── sub-example02_ses-neck_T2w.nii.gz
├── sub-example02_ses-neck_water.json
└── sub-example02_ses-neck_water.nii.gz
```
* sourcedata = contains participants.tsv, raw images, json sidecar files, and no other files
* derivatives = contains segmentation images and any other derivatives
* If you have a large dataset to convert, the [DICOM](https://www.dicomstandard.org/) to [BIDS](https://bids.neuroimaging.io/) conversion can be automated. If needed, feel free to reach out to [us](mailto:[email protected]) for help automating the conversion.
We provide a step-by-step installation and usage tutorial video here.
- Python 3.9.0
-
Install python:
-
Create python environment:
conda create --name MuscleMap python==3.9.0
-
Activate python environment:
conda activate MuscleMap
-
Download MuscleMap repository:
-
Using the git command line tool:
git clone https://github.com/MuscleMap/MuscleMap
-
From your browser:
-
Open https://github.com/MuscleMap/MuscleMap in your browser
-
Click the green <> Code ▼ button
-
Click Download Zip
-
Unzip the MuscleMap repository
-
-
Navigate to MuscleMap repository:
cd ./MuscleMap
-
Install python packages:
pip install .
-
To use a GPU , you will need a NVIDIA GPU and CUDA installed.
-
-
Activate python environment:
conda activate MuscleMap
-
To run mm_segment:
mm_segment -i image.nii.gz -r abdomen
- mm_segment uses contrast agnostic segmentation models by default and only the body region needs to be specified. Users may specify another available model with -m.
- mm_segment will use GPU if detected. Users can force mm_segment to use CPU with -g N.
- Abdomen
- Left and right multifidus, erector spinae, psoas major, and quadratus lumborum
Regions in development: neck, shoulder, arm, forearm, thorax, pelvis, thigh, leg, and foot
We highly recommend visualizing and manually correcting the segmentations for errors. We use ITK-SNAP and Slicer, which are free and open-source.
If the models do not work well on your images, please contact us. If you share your images, we can update the MuscleMap models to improve their accuracy.
-
To run mm_extract_metrics:
-
For T1w and T2w MRI:
mm_extract_metrics -m gmm -r abdomen -i image.nii.gz -s image_dseg.nii.gz -c 3
- Users may specify Gaussian mixture modeling (gmm) or kmeans clustering (kmeans) with -m.
- Users may specify 2 or 3 components with -c.
- For gmm, probability maps are ouput for each component and label (*_softseg.nii.gz).
- For gmm and kmeans, binarized segmentations are ouput for each component and label (*_seg.nii.gz).
-
For Dixon Fat-Water MRI:
mm_extract_metrics -m dixon -r abdomen -f fat_image.nii.gz -w water_image.nii.gz -s image_dseg.nii.gz
-
For Dixon Fat Fraction MRI or CT:
mm_extract_metrics -m average -r abdomen -i image.nii.gz -s image_dseg.nii.gz
-
-
To run mm_segment and mm_extract_metrics via a graphical user interface (GUI):
mm_gui
- To run mm_segment followed by mm_extract metrics use the chaining options in the GUI.
When using the MuscleMap Toolbox please cite the following publications:
-
Wesselink EO, Elliott JM, Coppieters MW, Hancock MJ, Cronin B, Pool-Goudzwaard A, Weber II KA.Convolutional neural networks for the automatic segmentation of lumbar paraspinal muscles in people with low back pain. Sci Rep. 2022;12(1):13485. https://doi.org/10.1038/s41598-022-16710-5
-
Wesselink EO, Pool-Goudzwaard A, De Leener B, Law CSW, Fenyo MB, Ello GM, Coppieters MW, Elliott JM, Mackey S, Weber KA 2nd. Investigating the associations between lumbar paraspinal muscle health and age, BMI, sex, physical activity, and back pain using an automated computer-vision model: a UK Biobank study. Spine J. 2024;24(7):1253-1266. https://doi.org/10.1016/j.spinee.2024.02.013
- Wesselink EO, Elliott JM, Pool-Goudzwaard A, Coppieters MW, Pevenage PP, Di Ieva A, Weber II KA. Quantifying lumbar paraspinal intramuscular fat: Accuracy and reliability of automated thresholding models. N Am Spine Soc J. 2024;17:100313. https://doi.org/10.1016/j.xnsj.2024.100313
-
Wesselink EO, Pool-Goudzwaard A, De Leener B, Law CSW, Fenyo MB, Ello GM, Coppieters MW, Elliott JM, Mackey S, Weber KA 2nd. Investigating the associations between lumbar paraspinal muscle health and age, BMI, sex, physical activity, and back pain using an automated computer-vision model: a UK Biobank study. Spine J. 2024;24(7):1253-1266. https://doi.org/10.1016/j.spinee.2024.02.013
-
Wesselink EO, Elliott JM, Pool-Goudzwaard A, Coppieters MW, Pevenage PP, Di Ieva A, Weber II KA. Quantifying lumbar paraspinal intramuscular fat: Accuracy and reliability of automated thresholding models. N Am Spine Soc J. 2024;17:100313. https://doi.org/10.1016/j.xnsj.2024.100313
-
Perraton Z, Mosler AB, Lawrenson PR, Weber II K, Elliott JM, Wesselink EO, Crossley KM, Kemp JL, Stewart C, Girdwood M, King MG, Heerey JJ, Scholes MJ, Mentiplay BF, Semciw AI. The association between lateral hip muscle size/intramuscular fat infiltration and hip strength in active young adults with long standing hip/groin pain. Phys Ther Sport. 2024;65:95-101. https://doi.org/10.1016/j.ptsp.2023.11.007
- Wesselink EO, Pool JJM, Mollema J, Weber KA 2nd, Elliott JM, Coppieters MW, Pool-Goudzwaard AL. Is fatty infiltration in paraspinal muscles reversible with exercise in people with low back pain? A systematic review. Eur Spine J. 2023;32(3):787-796. https://doi.org/10.1007/s00586-022-07471-w
-
Wesselink EO, Elliott JM, Coppieters MW, Hancock MJ, Cronin B, Pool-Goudzwaard A, Weber II KA.Convolutional neural networks for the automatic segmentation of lumbar paraspinal muscles in people with low back pain. Sci Rep. 2022;12(1):13485. https://doi.org/10.1038/s41598-022-16710-5
-
Bodkin SG, Smith AC, Bergman BC, Huo D, Weber KA, Zarini S, Kahn D, Garfield A, Macias E, Harris-Love MO. Utilization of Mid-Thigh Magnetic Resonance Imaging to Predict Lean Body Mass and Knee Extensor Strength in Obese Adults. Front Rehabil Sci. 2022;3:808538. https://doi.org/10.3389/fresc.2022.808538
-
Snodgrass SJ, Stanwell P, Weber KA, Shepherd S, Kennedy O, Thompson HJ, Elliott JM. Greater muscle volume and muscle fat infiltrate in the deep cervical spine extensor muscles (multifidus with semispinalis cervicis) in individuals with chronic idiopathic neck pain compared to age and sex-matched asymptomatic controls: a cross-sectional study. BMC Musculoskelet Disord. 2022;23(1):973. https://doi.org/10.1186/s12891-022-05924-3
-
Franettovich Smith MM, Mendis MD, Weber KA 2nd, Elliott JM, Ho R, Wilkes MJ, Collins NJ. Improving the measurement of intrinsic foot muscle morphology and composition from high-field (7T) magnetic resonance imaging. J Biomech. 2022;140:111164. https://doi.org/10.1016/j.jbiomech.2022.111164
-
Perraton Z, Lawrenson P, Mosler AB, Elliott JM, Weber KA 2nd, Flack NA, Cornwall J, Crawford RJ, Stewart C, Semciw AI. Towards defining muscular regions of interest from axial magnetic resonance imaging with anatomical cross-reference: a scoping review of lateral hip musculature. BMC Musculoskelet Disord. 2022;23(1):533. https://doi.org/10.1186/s12891-022-05439-x
-
Paliwal M, Weber KA 2nd, Smith AC, Elliott JM, Muhammad F, Dahdaleh NS, Bodurka J, Dhaher Y, Parrish TB, Mackey S, Smith ZA. Fatty infiltration in cervical flexors and extensors in patients with degenerative cervical myelopathy using a multi-muscle segmentation model. PLoS One. 2021;16(6):e0253863. https://doi.org/10.1371/journal.pone.0253863
-
Weber KA 2nd, Abbott R, Bojilov V, Smith AC, Wasielewski M, Hastie TJ, Parrish TB, Mackey S, Elliott JM. Multi-muscle deep learning segmentation to automate the quantification of muscle fat infiltration in cervical spine conditions. Sci Rep. 2021;11(1):16567. https://doi.org/10.1038/s41598-021-95972-x
-
Elliott JM, Smith AC, Hoggarth MA, Albin SR, Weber KA 2nd, Haager M, Fundaun J, Wasielewski M, Courtney DM, Parrish TB. Muscle fat infiltration following whiplash: A computed tomography and magnetic resonance imaging comparison. PLoS One. 2020;15(6):e0234061. https://doi.org/10.1371/journal.pone.0234061
-
Franettovich Smith MM, Collins NJ, Mellor R, Grimaldi A, Elliott J, Hoggarth M, Weber II KA, Vicenzino B. Foot exercise plus education versus wait and see for the treatment of plantar heel pain (FEET trial): a protocol for a feasibility study. J Foot Ankle Res. 2020;13(1):20. https://doi.org/10.1186/s13047-020-00384-1
- Weber KA, Smith AC, Wasielewski M, Eghtesad K, Upadhyayula PA, Wintermark M, Hastie TJ, Parrish TB, Mackey S, Elliott JM. Deep Learning Convolutional Neural Networks for the Automatic Quantification of Muscle Fat Infiltration Following Whiplash Injury. Sci Rep. 2019;9(1):7973. https://doi.org/10.1038/s41598-019-44416-8
- Smith AC, Weber KA, Parrish TB, Hornby TG, Tysseling VM, McPherson JG, Wasielewski M, Elliott JM. Ambulatory function in motor incomplete spinal cord injury: a magnetic resonance imaging study of spinal cord edema and lower extremity muscle morphometry. Spinal Cord. 2017;55(7):672-678. https://doi.org/10.1038/sc.2017.18