dicom-forge¶
A medical-imaging research pipeline that prepares DICOM for 3D Slicer and ITK-SNAP.
It ingests DICOM, rejects series whose metadata signals burned-in pixel text,
de-identifies the DICOM headers, runs quality control, and
converts to the formats research viewers load natively — NIfTI (.nii.gz),
NRRD (.nrrd), and Slicer's segmentation format (.seg.nrrd).
Install¶
pip install "dicom-anvil[convert]"
Installed as
dicom-anvil(the namedicom-forgewas already taken on PyPI); imported asdicomforge. The source repository isdicom-forge.
60-second tour¶
dicomforge inspect ./study # what's in this folder?
dicomforge qc ./study # is it analysis-ready?
dicomforge convert ./study ./out/case01 -f nrrd # check -> de-id -> QC -> convert
from dicomforge import run_pipeline, PipelineConfig, OutputFormat
result = run_pipeline(
"./study", "./out/case01", config=PipelineConfig(output_format=OutputFormat.NRRD)
)
print(result.model_dump_json(indent=2))
See Concepts for the pipeline design, the CLI reference for every command, and the API reference for the Python surface.
Patient data
This is not a validated anonymization tool. De-identification is header-only
risk reduction, not a compliance guarantee. Pixel data is never analysed;
burned-in text is caught only when metadata signals it. Read the
de-identification policy before relying on it,
and never commit real patient data. See the project SECURITY.md.