Skip to content

About

[Top rated oral EANM'26] Image-derived SUV and SUL for [18F]FDG-PET

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

ID-uptake-values

Estimate SUV (body-mass normalised) and SUL (lean-body-mass normalised) PET images without DICOM metadata such as injected dose or patient weight. Total activity and body mass / lean body mass are inferred from the images themselves, using TotalSegmentator masks and a k-nearest-neighbour model over axial distribution functions.

Installation

pip install .        # or: uv sync

The model weights are bundled with the package.

Usage

Installing provides the suv_id and sul_id commands (also runnable as python -m id_uptake_values.suv / .sul).

Inputs are NIfTI files: PET, CT, and TotalSegmentator segmentations (total, body, and for SUL also tissue).

# SUV
suv_id --pet pet.nii.gz --ct ct.nii.gz \
    --totalseg total.nii.gz --bodyseg body.nii.gz \
    --output-image suv.nii.gz --output-json suv.json --debug-image debug.png

# SUL 
sul_id --pet pet.nii.gz --ct ct.nii.gz \
    --totalseg total.nii.gz --tissueseg tissue.nii.gz --bodyseg body.nii.gz \
    --output-image sul.nii.gz --output-json sul.json --debug-image debug.png

The JSON contains the estimated activity (MBq), the estimated body mass or lean body mass (kg), and the denominator the PET image was divided by.

The scan must cover the region from C1 to the sacrum; otherwise a ValueError is raised.

Development

uv sync
uv run pytest

The tests download subject sub-000 from the DEPICT-RH/Multimodal-HC dataset into the Hugging Face cache.

About

[Top rated oral EANM'26] Image-derived SUV and SUL for [18F]FDG-PET

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages