graymatter

Segmentation of gray matter agnostic to MRI contrasts and regions

This model for spinal cord gray matter (GM) segmentation uses a 2D nnU-Net architecture. It outputs a binary segmentation. The model was trained and tested on datasets including >20 sites, 3 magnetic field strengths, 9 sequences, 1367 subjects included: 1.5T-PDw(N = 8), 3T-MGE-T2starw(N = 509), 3T-MTR(N = 21), 3T-PDw(N = 145), 3T-PSIR(N = 176), 3T-rAMIRA(N = 48), 3T-TSE-T1w(N = 64), 7T-MGE-T2starw(N = 89), 7T-MP2RAGE-T1map(N = 144), 7T-MP2RAGE-UNI(N = 144), 7T-QSM(N = 14), 7T-SWI(N = 5), acquired in the cervical, thoracic and lumbar regions from healthy controls, pediatrics, multiple sclerosis, spinal muscular atrophy, cervical degenerative myelopathy, spinal cord injury, amyotrophic lateral sclerosis post-polio syndrome and stroke.

Reference

Project URL: https://github.com/ivadomed/model-gm-contrast-region-agnostic

usage: sct_deepseg graymatter [-i <file> [<file> ...]] [-o <str>] [-install]
                              [-custom-url CUSTOM_URL [CUSTOM_URL ...]]
                              [-largest {0,1}] [-fill-holes {0,1}]
                              [-remove-small REMOVE_SMALL [REMOVE_SMALL ...]]
                              [-qc <folder>] [-qc-dataset <str>]
                              [-qc-subject <str>] [-qc-plane <str>]
                              [-qc-seg <file>] [-h] [-v <int>] [-r {0,1}]
                              [-test-time-aug]

INPUT/OUTPUT

-i

Image filename(s) to segment. If segmenting multiple files, separate filenames with a space.

-o

Output file name. The chosen filename will be used as a base name, and model-specific suffixes will be added to the end depending on the type of output (e.g. ‘_cord.nii.gz’, ‘_gm.nii.gz’, etc.).

TASKS

-install

Install models that are required for specified task.

Default: False

-custom-url

URL(s) pointing to the .zip asset for a model release. This option can be used with -install to install a specific version of a model. To use this option, navigate to the ‘Releases’ page of the model, find release you wish to install, and right-click + copy the URL of the .zip listed under ‘Assets’. Example: sct_deepseg graymatter -install -custom-url CUSTOM_URL sct_deepseg graymatter -i t2.nii.gz

PARAMETERS

-largest

Possible choices: 0, 1

Keep the largest connected object from each output segmentation; if not set, all objects are kept.

Default: 0

-fill-holes

Possible choices: 0, 1

If set, small holes in the segmentation will be filled in automatically.

Default: 0

-remove-small

Minimal object size to keep with unit (mm3 or vox). A single value can be provided or one value per prediction class. Single value example: 1mm3, 5vox. Multiple values example: 10 20 10vox (remove objects smaller than 10 voxels for class 1 and 3, and smaller than 20 voxels for class 2).

-test-time-aug

Perform test-time augmentation (TTA) by flipping the input image along all axes and averaging the resulting predictions. Note: The time it takes to run the model will increase due to the additional predictions.

Default: False

MISC ARGUMENTS

-qc

The path where the quality control generated content will be saved.

-qc-dataset

If provided, this string will be mentioned in the QC report as the dataset the process was run on.

-qc-subject

If provided, this string will be mentioned in the QC report as the subject the process was run on.

-qc-plane

Possible choices: Axial, Sagittal

Plane of the output QC. If Sagittal, it is highly recommended to provide the -qc-seg option, as it will ensure the output QC is cropped to a reasonable field of view.

Default: 'Axial'

-qc-seg

Segmentation file to use for cropping the QC. This option is useful when you want to QC a region that is different from the output segmentation. For example, it might be useful to provide a dilated cord segmentation to expand the QC field of view.

If -qc-seg is not provided, the default behavior will depend on the value of -qc-plane:

  • ‘Axial’: Without ‘-qc-seg’, a sensible crop radius between 15-40 vox will be automatically used, depending on the resolution and segmentation type.

  • ‘Sagittal’: Without ‘-qc-seg’, the full image will be displayed by default. (For very large images, this may cause a crash, so using -qc-seg is highly recommended.)

-v

Possible choices: 0, 1, 2

Verbosity. 0: Display only errors/warnings, 1: Errors/warnings + info messages, 2: Debug mode.

Default: 1

-r

Possible choices: 0, 1

Remove temporary files.

Default: 1