pet-linear
- Linear processing of PET images¶
This pipeline performs spatial normalization to the MNI space and intensity normalization of PET images. Its steps include:
- affine registration to the MNI152NLin2009cSym template [Fonov et al., 2011, 2009] in MNI space with the SyN algorithm [Avants et al., 2008] from the ANTs software package [Avants et al., 2014]
- intensity normalization using the average PET uptake in reference regions resulting in a standardized uptake value ratio (SUVR) map
- cropping of the registered images to remove the background
Clinica & BIDS specifications for PET modality
Since Clinica v0.6
, PET data following the official specifications in BIDS version 1.6.0 are now compatible with Clinica.
See BIDS page for more information.
Prerequisites¶
You need to have performed the t1-linear
pipeline on your T1-weighted MR images.
Dependencies¶
If you only installed the core of Clinica, this pipeline needs the installation of ANTs on your computer.
Running the pipeline¶
The pipeline can be run with the following command line:
clinica run pet-linear [OPTIONS] BIDS_DIRECTORY CAPS_DIRECTORY ACQ_LABEL
{pons|cerebellumPons|pons2|cerebellumPons2}
where:
BIDS_DIRECTORY
is the input folder containing the dataset in a BIDS hierarchyCAPS_DIRECTORY
is the output folder containing the results in a CAPS hierarchyACQ_LABEL
is the label given to the PET acquisition, specifying the tracer used (trc-<acq_label>
). It can be for instance '18FFDG' for 18F-fluorodeoxyglucose or '18FAV45' for 18F-florbetapir- The reference region is used to perform intensity normalization (i.e. dividing each voxel of the image by the average uptake in this region) resulting in a standardized uptake value ratio (SUVR) map.
It can be
cerebellumPons
orcerebellumPons2
(used for amyloid tracers) andpons
orpons2
(used for FDG). See PET introduction for more details about masks versions.
By default, cropped images (matrix size 169×208×179, 1 mm isotropic voxels) are generated to reduce the computing power required when training deep learning models.
Use the --uncropped_image
option if you do not want to crop the image.
It is possible to select only images based on a specific reconstruction method with the --reconstruction_method
option.
Warning
It can happen that a BIDS dataset contains several PET scans for a given subject and session.
In this situation, these images will differ through at least one BIDS entity like the tracer or the reconstruction method.
When running the pet-linear
pipeline, clinica will raise an error if more than one image matches the criteria provided through the command line.
To avoid that, it is important to specify values for these options such that a single image is selected per subject and session.
The pipeline also offers the possibility to save the PET image in the T1w space after rigid transformation using the --save_pet_in_t1w_space
option.
Note
The arguments common to all Clinica pipelines are described in Interacting with Clinica.
Tip
Do not hesitate to type clinica run pet-linear --help
to see the full list of parameters.
Outputs¶
Results are stored in the following folder of the CAPS hierarchy: subjects/<participant_id>/<session_id>/pet_linear
.
The main output files are:
<source_file>_space-MNI152NLin2009cSym_desc-Crop_res-1x1x1_suvr-<label>_pet.nii.gz
: PET SUVR image registered to theMNI152NLin2009cSym
template and cropped.<source_file>_space-T1w_rigid.mat
: rigid transformation between the PET and T1w images estimated with ANTs.- (optional)
<source_file>_space-MNI152NLin2009cSym_res-1x1x1_pet.nii.gz
: PET SUVR image affinely registered to theMNI152NLin2009cSym
template (i.e. not cropped). - (optional)
<source_file>_space-T1w_pet.nii.gz
: PET image affinely registered to the associated T1w image.
Going further¶
You can now use the ClinicaDL framework presented in [Wen et al., 2020] for classification based on deep learning methods.
Describing this pipeline in your paper¶
Example of paragraph
These results have been obtained using the pet-linear
pipeline of Clinica
[Routier et al., 2021].
This pipeline first performs intra-subject rigid registration of the PET
image into the space of the subject’s T1-weighted (T1w) MR image using the
SyN algorithm [Avants et al., 2008]
from ANTs [Avants et al., 2014].
The PET to T1w transformation is then composed with T1w to ICBM 2009c
nonlinear symmetric template affine transformation, obtained with
t1-linear
, to transport the PET image to the MNI space [Fonov et al.,
2011,
2009].
The PET image is further intensity normalized using the average PET uptake
in a reference region ([pons | pons + cerebellum]), resulting in a
standardized uptake value ratio (SUVR) map.
The PET SUVR image in MNI space is finally cropped to remove the background,
resulting in images of size 169×208×179 with 1 mm isotropic voxels.
Tip
Easily access the papers cited on this page on Zotero.
Contact us !¶
- Check for past answers on Clinica Google Group
- Start a discussion on GitHub
- Report an issue on Github