Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time


a heuristic-centric DICOM converter

Our Docker image TravisCI CodeCoverage Readthedocs Zenodo (latest)


heudiconv is a flexible DICOM converter for organizing brain imaging data into structured directory layouts.

  • it allows flexible directory layouts and naming schemes through customizable heuristics implementations
  • it only converts the necessary DICOMs, not everything in a directory
  • you can keep links to DICOM files in the participant layout
  • using dcm2niix under the hood, it's fast
  • it can track the provenance of the conversion from DICOM to NIfTI in W3C PROV format
  • it provides assistance in converting to BIDS.
  • it integrates with DataLad to place converted and original data under git/git-annex version control, while automatically annotating files with sensitive information (e.g., non-defaced anatomicals, etc)

How to cite

Please use Zenodo record for your specific version of HeuDiConv. We also support gathering all relevant citations via DueCredit.