Run this notebook
Date: 23 Nov 2024
License:
Note: If this notebook uses neuroimaging tools from Neurocontainers, those tools retain their original licenses. Please see Neurodesk citation guidelines for details.
Citation and Resources:¶
Tools included in this notebook¶
dcm2niix:
Li, X., Morgan, P. S., Ashburner, J., Smith, J., & Rorden, C. (2016). The first step for neuroimaging data analysis: DICOM to NIfTI conversion. Journal of Neuroscience Methods, 264, 47–56. Li et al. (2016)
BIDScoin:
Zwiers MP, Moia S and Oostenveld R (2022) BIDScoin: A User-Friendly Application to Convert Source Data to Brain Imaging Data Structure. Front. Neuroinform. 15:770608. doi: Zwiers et al. (2022)
HeuDiConv:
Yaroslav O. Halchenko, Mathias Goncalves, Satrajit Ghosh, Pablo Velasco, Matteo Visconti di Oleggio Castello, Taylor Salo, John T. Wodder II, Michael Hanke, Patrick Sadil, Krzysztof Jacek Gorgolewski, Horea-Ioan Ioanas, Chris Rorden, Timothy J. Hendrickson, Michael Dayan, Sean Dae Houlihan, James Kent, Ted Strauss, John Lee, Isaac To, … David N. Kennedy. (2024). HeuDiConv — flexible DICOM conversion into structured directory layouts (v1.3.1). Zenodo. Yaroslav O. Halchenko et al. (2024)
Dataset¶
This example uses a phantom dataset generated by the University of Arizona on their Siemens Skyra 3T with Syngo MR VE11c software on 2018_02_08.
BIDS conversion¶
In this interactive example notebook, we first download DICOM data using
datalad.Next we will convert DICOMS into the BIDS data structure using:
2.1.
dcm2niixwhich converts data to NIfTi and then manually organizes the folder.2.2.
heudiconvto automate the conversion and organization with a provided heuristic file.2.3.
bidscointo automate the conversion and organization with the bidseditor interface (optionally using--automatedto disable user interaction).
1. Data preparation¶
Download DICOM data from Datalad.
%%bash
set -euo pipefail
# Retry transient network failures, then fail the cell instead of continuing without data.
retry() { for i in 1 2 3 4 5; do "$@" && return 0; echo "Attempt $i failed: $*" >&2; [ "$i" -lt 5 ] && sleep $((i * 15)); done; return 1; }
[ -d heudiconv-reproin-example ] || retry datalad install https://datasets.datalad.org/repronim/heudiconv-reproin-example
cd heudiconv-reproin-example/REPROIN/dicom && retry datalad get 001[INFO] Attempting a clone into /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example
[INFO] Attempting to clone from https://datasets.datalad.org/repronim/heudiconv-reproin-example to /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example
[INFO] Attempting to clone from https://datasets.datalad.org/repronim/heudiconv-reproin-example/.git to /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example
[INFO] Start enumerating objects
[INFO] Start counting objects
[INFO] Start compressing objects
[INFO] Start receiving objects
[INFO] Start resolving deltas
[INFO] Completed clone attempts for Dataset(/home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example)
We will be working from a directory called REPROIN. Under the REPROIN directory is the dicom subdirectory: Under the subject number 001 the session Patterson_Coben - 1 is nested. Each dicom sequence folder is nested under the session:
!tree heudiconv-reproin-example/REPROIN/ -I "*.dcm"heudiconv-reproin-example/REPROIN/
└── dicom
└── 001
└── Patterson_Coben - 1
├── Localizers_4
├── anatT1w_acqMPRAGE_6
├── dwi_dirAP_9
├── fmap_acq4mm_7
├── fmap_acq4mm_8
├── fmap_dirPA_15
└── func_taskrest_16
11 directories, 0 files
2. Convert DICOMS to BIDS-formatted NIfTI¶
2.1. Using dcm2niix (manual workflow)¶
dcm2niix converts neuroimaging data from the DICOM format to the NIfTI format and generates a BIDS JSON format sidecar which includes relevant information. However, users need to manually organize these files into a bids-compliant subject directory.
2.1.1. Convert DICOM to NIfTI¶
import module
await module.load('dcm2niix/v1.0.20240202')!dcm2niix -hChris Rorden's dcm2niiX version v1.0.20240202 (JP2:OpenJPEG) (JP-LS:CharLS) GCC8.4.0 x86-64 (64-bit Linux)
usage: dcm2niix [options] <in_folder>
Options :
-1..-9 : gz compression level (1=fastest..9=smallest, default 6)
-a : adjacent DICOMs (images from same series always in same folder) for faster conversion (n/y, default n)
-b : BIDS sidecar (y/n/o [o=only: no NIfTI], default y)
-ba : anonymize BIDS (y/n, default y)
-c : comment stored in NIfTI aux_file (up to 24 characters e.g. '-c VIP', empty to anonymize e.g. 0020,4000 e.g. '-c ""')
-d : directory search depth. Convert DICOMs in sub-folders of in_folder? (0..9, default 5)
-e : export as NRRD (y) or MGH (o) or JSON/JNIfTI (j) or BJNIfTI (b) instead of NIfTI (y/n/o/j/b, default n)
-f : filename (%a=antenna (coil) name, %b=basename, %c=comments, %d=description, %e=echo number, %f=folder name, %g=accession number, %i=ID of patient, %j=seriesInstanceUID, %k=studyInstanceUID, %m=manufacturer, %n=name of patient, %o=mediaObjectInstanceUID, %p=protocol, %r=instance number, %s=series number, %t=time, %u=acquisition number, %v=vendor, %x=study ID; %z=sequence name; default '%f_%p_%t_%s')
-g : generate defaults file (y/n/o/i [o=only: reset and write defaults; i=ignore: reset defaults], default n)
-h : show help
-i : ignore derived, localizer and 2D images (y/n, default n)
-l : losslessly scale 16-bit integers to use dynamic range (y/n/o [yes=scale, no=no, but uint16->int16, o=original], default o)
-m : merge 2D slices from same series regardless of echo, exposure, etc. (n/y or 0/1/2, default 2) [no, yes, auto]
-n : only convert this series CRC number - can be used up to 16 times (default convert all)
-o : output directory (omit to save to input folder)
-p : Philips precise float (not display) scaling (y/n, default y)
-q : only search directory for DICOMs (y/l/n, default y) [y=show number of DICOMs found, l=additionally list DICOMs found, n=no]
-r : rename instead of convert DICOMs (y/n, default n)
-s : single file mode, do not convert other images in folder (y/n, default n)
-u : up-to-date check
-v : verbose (n/y or 0/1/2, default 0) [no, yes, logorrheic]
-w : write behavior for name conflicts (0,1,2, default 2: 0=skip duplicates, 1=overwrite, 2=add suffix)
-x : crop 3D acquisitions (y/n/i, default n, use 'i'gnore to neither crop nor rotate 3D acquistions)
-z : gz compress images (y/o/i/n/3, default n) [y=pigz, o=optimal pigz, i=internal:zlib, n=no, 3=no,3D]
--big-endian : byte order (y/n/o, default o) [y=big-end, n=little-end, o=optimal/native]
--progress : Slicer format progress information (y/n, default n)
--ignore_trigger_times : disregard values in 0018,1060 and 0020,9153
--terse : omit filename post-fixes (can cause overwrites)
--version : report version
--xml : Slicer format features
Defaults file : /home/jovyan/.dcm2nii.ini
Examples :
dcm2niix /Users/chris/dir
dcm2niix -c "my comment" /Users/chris/dir
dcm2niix -o /users/cr/outdir/ -z y ~/dicomdir
dcm2niix -f %p_%s -b y -ba n ~/dicomdir
dcm2niix -f mystudy%s ~/dicomdir
dcm2niix -o "~/dir with spaces/dir" ~/dicomdir
Example output filename: 'myFolder_MPRAGE_19770703150928_1.nii'
!mkdir -p dcm2niix_bids
!dcm2niix n -o ./dcm2niix_bids ./heudiconv-reproin-example/REPROIN/dicomChris Rorden's dcm2niiX version v1.0.20240202 (JP2:OpenJPEG) (JP-LS:CharLS) GCC8.4.0 x86-64 (64-bit Linux)
Found 791 DICOM file(s)
Slices not stacked: orientation varies (vNav or localizer?) [0.718684 0.55589 0.417708 0.0695744 0.540223 -0.838641] != [0.103134 0.857794 0.503541 0.0414863 0.502091 -0.863819]
Convert 1 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_3_i00002 (162x162x1x1)
Convert 1 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_3_i00003 (162x162x1x1)
Convert 2 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_3_i00001 (162x162x2x1)
Convert 1 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_3_i00004 (162x162x1x1)
Convert 128 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_1 (160x160x128x1)
Convert 128 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_2 (160x160x128x1)
Convert 4 DICOM as ./dcm2niix_bids/dicom_func_task-rest_20190208142838_16 (64x64x44x4)
Convert 132 DICOM as ./dcm2niix_bids/dicom_fmap_dir-PA_20190208142838_15 (122x122x66x2)
Convert 1 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_4_i00003 (162x162x1x1)
Convert 1 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_4_i00002 (162x162x1x1)
Convert 1 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_4_i00001 (162x162x1x1)
Convert 16 DICOM as ./dcm2niix_bids/dicom_dwi_dir-AP_20190208142838_9 (122x122x66x16)
Slices not stacked: echo varies (TE 7.38, 4.92; echo 2, 1). Use 'merge 2D slices' option to force stacking
Convert 44 DICOM as ./dcm2niix_bids/dicom_fmap_acq-4mm_20190208142838_7_e2 (64x64x44x1)
Convert 44 DICOM as ./dcm2niix_bids/dicom_fmap_acq-4mm_20190208142838_7_e1 (64x64x44x1)
Convert 240 DICOM as ./dcm2niix_bids/dicom_anat-T1w_acq-MPRAGE_20190208142838_6 (224x224x240x1)
Convert 1 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_5_i00002 (162x162x1x1)
Convert 1 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_5_i00003 (162x162x1x1)
Convert 1 DICOM as ./dcm2niix_bids/dicom_anat-scout_20190208142838_5_i00001 (162x162x1x1)
Convert 44 DICOM as ./dcm2niix_bids/dicom_fmap_acq-4mm_20190208142838_8_e2_ph (64x64x44x1)
Conversion required 0.419127 seconds (0.418237 for core code).
2.1.2. Organize data into BIDS structure¶
%%bash
mkdir -p ./dcm2niix_bids/anat
mkdir -p ./dcm2niix_bids/fmap
mkdir -p ./dcm2niix_bids/dwi
mkdir -p ./dcm2niix_bids/func
find ./dcm2niix_bids -maxdepth 1 -type f -name *anat* -exec mv {} ./dcm2niix_bids/anat \;
find ./dcm2niix_bids -maxdepth 1 -type f -name *fmap* -exec mv {} ./dcm2niix_bids/fmap \;
find ./dcm2niix_bids -maxdepth 1 -type f -name *dwi* -exec mv {} ./dcm2niix_bids/dwi \;
find ./dcm2niix_bids -maxdepth 1 -type f -name *func* -exec mv {} ./dcm2niix_bids/func \;!tree ./dcm2niix_bids/./dcm2niix_bids/
├── anat
│ ├── dicom_anat-T1w_acq-MPRAGE_20190208142838_6.json
│ ├── dicom_anat-T1w_acq-MPRAGE_20190208142838_6.nii
│ ├── dicom_anat-scout_20190208142838_1.json
│ ├── dicom_anat-scout_20190208142838_1.nii
│ ├── dicom_anat-scout_20190208142838_2.json
│ ├── dicom_anat-scout_20190208142838_2.nii
│ ├── dicom_anat-scout_20190208142838_3_i00001.json
│ ├── dicom_anat-scout_20190208142838_3_i00001.nii
│ ├── dicom_anat-scout_20190208142838_3_i00002.json
│ ├── dicom_anat-scout_20190208142838_3_i00002.nii
│ ├── dicom_anat-scout_20190208142838_3_i00003.json
│ ├── dicom_anat-scout_20190208142838_3_i00003.nii
│ ├── dicom_anat-scout_20190208142838_3_i00004.json
│ ├── dicom_anat-scout_20190208142838_3_i00004.nii
│ ├── dicom_anat-scout_20190208142838_4_i00001.json
│ ├── dicom_anat-scout_20190208142838_4_i00001.nii
│ ├── dicom_anat-scout_20190208142838_4_i00002.json
│ ├── dicom_anat-scout_20190208142838_4_i00002.nii
│ ├── dicom_anat-scout_20190208142838_4_i00003.json
│ ├── dicom_anat-scout_20190208142838_4_i00003.nii
│ ├── dicom_anat-scout_20190208142838_5_i00001.json
│ ├── dicom_anat-scout_20190208142838_5_i00001.nii
│ ├── dicom_anat-scout_20190208142838_5_i00002.json
│ ├── dicom_anat-scout_20190208142838_5_i00002.nii
│ ├── dicom_anat-scout_20190208142838_5_i00003.json
│ └── dicom_anat-scout_20190208142838_5_i00003.nii
├── dwi
│ ├── dicom_dwi_dir-AP_20190208142838_9.bval
│ ├── dicom_dwi_dir-AP_20190208142838_9.bvec
│ ├── dicom_dwi_dir-AP_20190208142838_9.json
│ └── dicom_dwi_dir-AP_20190208142838_9.nii
├── fmap
│ ├── dicom_fmap_acq-4mm_20190208142838_7_e1.json
│ ├── dicom_fmap_acq-4mm_20190208142838_7_e1.nii
│ ├── dicom_fmap_acq-4mm_20190208142838_7_e2.json
│ ├── dicom_fmap_acq-4mm_20190208142838_7_e2.nii
│ ├── dicom_fmap_acq-4mm_20190208142838_8_e2_ph.json
│ ├── dicom_fmap_acq-4mm_20190208142838_8_e2_ph.nii
│ ├── dicom_fmap_dir-PA_20190208142838_15.bval
│ ├── dicom_fmap_dir-PA_20190208142838_15.bvec
│ ├── dicom_fmap_dir-PA_20190208142838_15.json
│ └── dicom_fmap_dir-PA_20190208142838_15.nii
└── func
├── dicom_func_task-rest_20190208142838_16.json
└── dicom_func_task-rest_20190208142838_16.nii
5 directories, 42 files
2.2. Using HeuDiConv (automated workflow)¶
Typical use of heudiconv will require the creation and editing of your heuristics file.
But heudiconv also comes with existing heuristics which can be used as is, like convertall or ReproIn could be immediately reused and represent two ends of the spectrum in heuristics:
convertallis very simple and does not automate anything – it is for a user to modify filenames in the prepared conversion table, and then rerun with-c dcm2niixreproincan be used fully automated, if original sequences were named according to its ReproIn convention.
await module.load('heudiconv/1.3.1')!heudiconv -f reproin -b -o ./heudiconv_reproin_bids --files ./heudiconv-reproin-example/REPROIN/dicom/001WARNING: Could not check for version updates: 500 Server Error: Internal Server Error for url: https://rig.mit.edu/et/projects/nipy/heudiconv
INFO: Running heudiconv version 1.3.1 latest Unknown
INFO: Analyzing 791 dicoms
INFO: Filtering out 0 dicoms based on their filename
INFO: Generated sequence info for 1 studies with 11 entries total
INFO: Processing sequence infos to deduce study/session
INFO: Study session for StudySessionInfo(locator='Patterson/Coben', session=None, subject='001')
INFO: Need to process 1 study sessions
INFO: PROCESSING STARTS: {'subject': '001', 'outdir': '/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben', 'session': None}
INFO: Processing 11 pre-sorted seqinfo entries
INFO: Processing 11 seqinfo entries
WARNING: Deduced datatype to be dwi from DICOM, but got fmap out of fmap_dir-PA
WARNING: Detected 4 duplicated run(s) for template {bids_subject_session_dir}/anat/{bids_subject_session_prefix}_scout: ['1-anat-scout', '2-anat-scout', '3-anat-scout', '4-anat-scout']
INFO: Doing conversion using dcm2niix
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_scout (3 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat . Converter: dcm2niix . Output types: ('dicom',)
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_acq-MPRAGE_T1w (240 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat . Converter: dcm2niix . Output types: ('nii.gz', 'dicom')
261008-17:45:45,734 nipype.workflow INFO:
[Node] Setting-up "convert" in "/tmp/dcm2niixhowhljv8/convert".
INFO: [Node] Setting-up "convert" in "/tmp/dcm2niixhowhljv8/convert".
261008-17:45:45,849 nipype.workflow INFO:
[Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
INFO: [Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
261008-17:45:46,290 nipype.interface INFO:
stdout 2026-10-08T17:45:46.290284:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
INFO: stdout 2026-10-08T17:45:46.290284:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
261008-17:45:46,290 nipype.interface INFO:
stdout 2026-10-08T17:45:46.290284:Found 240 DICOM file(s)
INFO: stdout 2026-10-08T17:45:46.290284:Found 240 DICOM file(s)
261008-17:45:46,290 nipype.interface INFO:
stdout 2026-10-08T17:45:46.290284:Convert 240 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_acq-MPRAGE_T1w_heudiconv998 (224x224x240x1)
INFO: stdout 2026-10-08T17:45:46.290284:Convert 240 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_acq-MPRAGE_T1w_heudiconv998 (224x224x240x1)
261008-17:45:46,675 nipype.interface INFO:
stdout 2026-10-08T17:45:46.675830:Compress: "/usr/bin/pigz" -b 960 -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_acq-MPRAGE_T1w_heudiconv998.nii"
INFO: stdout 2026-10-08T17:45:46.675830:Compress: "/usr/bin/pigz" -b 960 -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_acq-MPRAGE_T1w_heudiconv998.nii"
261008-17:45:46,676 nipype.interface INFO:
stdout 2026-10-08T17:45:46.675830:Conversion required 0.469148 seconds (0.164484 for core code).
INFO: stdout 2026-10-08T17:45:46.675830:Conversion required 0.469148 seconds (0.164484 for core code).
261008-17:45:46,692 nipype.workflow INFO:
[Node] Finished "convert", elapsed time 0.509002s.
INFO: [Node] Finished "convert", elapsed time 0.509002s.
261008-17:46:07,274 nipype.workflow INFO:
[Node] Setting-up "embedder" in "/tmp/embedmetafx_2l49r/embedder".
INFO: [Node] Setting-up "embedder" in "/tmp/embedmetafx_2l49r/embedder".
261008-17:46:07,290 nipype.workflow INFO:
[Node] Executing "embedder" <nipype.interfaces.utility.wrappers.Function>
INFO: [Node] Executing "embedder" <nipype.interfaces.utility.wrappers.Function>
261008-17:46:11,661 nipype.workflow INFO:
[Node] Finished "embedder", elapsed time 4.370079s.
INFO: [Node] Finished "embedder", elapsed time 4.370079s.
INFO: Post-treating /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_acq-MPRAGE_T1w.json file
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_magnitude (88 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap . Converter: dcm2niix . Output types: ('nii.gz', 'dicom')
261008-17:46:11,691 nipype.workflow INFO:
[Node] Setting-up "convert" in "/tmp/dcm2niixvc1m0cux/convert".
INFO: [Node] Setting-up "convert" in "/tmp/dcm2niixvc1m0cux/convert".
261008-17:46:11,733 nipype.workflow INFO:
[Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
INFO: [Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
261008-17:46:11,797 nipype.interface INFO:
stdout 2026-10-08T17:46:11.797087:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
INFO: stdout 2026-10-08T17:46:11.797087:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
261008-17:46:11,797 nipype.interface INFO:
stdout 2026-10-08T17:46:11.797087:Found 88 DICOM file(s)
INFO: stdout 2026-10-08T17:46:11.797087:Found 88 DICOM file(s)
261008-17:46:11,797 nipype.interface INFO:
stdout 2026-10-08T17:46:11.797087:Slices not stacked: echo varies (TE 7.38, 4.92; echo 2, 1). Use 'merge 2D slices' option to force stacking
INFO: stdout 2026-10-08T17:46:11.797087:Slices not stacked: echo varies (TE 7.38, 4.92; echo 2, 1). Use 'merge 2D slices' option to force stacking
261008-17:46:11,797 nipype.interface INFO:
stdout 2026-10-08T17:46:11.797087:Convert 44 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_magnitude_heudiconv407_e2 (64x64x44x1)
INFO: stdout 2026-10-08T17:46:11.797087:Convert 44 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_magnitude_heudiconv407_e2 (64x64x44x1)
261008-17:46:11,813 nipype.interface INFO:
stdout 2026-10-08T17:46:11.813463:Compress: "/usr/bin/pigz" -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_magnitude_heudiconv407_e2.nii"
INFO: stdout 2026-10-08T17:46:11.813463:Compress: "/usr/bin/pigz" -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_magnitude_heudiconv407_e2.nii"
261008-17:46:11,813 nipype.interface INFO:
stdout 2026-10-08T17:46:11.813463:Convert 44 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_magnitude_heudiconv407_e1 (64x64x44x1)
INFO: stdout 2026-10-08T17:46:11.813463:Convert 44 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_magnitude_heudiconv407_e1 (64x64x44x1)
261008-17:46:11,828 nipype.interface INFO:
stdout 2026-10-08T17:46:11.828374:Compress: "/usr/bin/pigz" -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_magnitude_heudiconv407_e1.nii"
INFO: stdout 2026-10-08T17:46:11.828374:Compress: "/usr/bin/pigz" -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_magnitude_heudiconv407_e1.nii"
261008-17:46:11,828 nipype.interface INFO:
stdout 2026-10-08T17:46:11.828374:Conversion required 0.058651 seconds (0.030774 for core code).
INFO: stdout 2026-10-08T17:46:11.828374:Conversion required 0.058651 seconds (0.030774 for core code).
261008-17:46:11,852 nipype.workflow INFO:
[Node] Finished "convert", elapsed time 0.118267s.
INFO: [Node] Finished "convert", elapsed time 0.118267s.
WARNING: For now not embedding BIDS and info generated .nii.gz itself since sequence produced multiple files
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_phasediff (44 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap . Converter: dcm2niix . Output types: ('nii.gz', 'dicom')
261008-17:46:12,567 nipype.workflow INFO:
[Node] Setting-up "convert" in "/tmp/dcm2niixnf7vnzgq/convert".
INFO: [Node] Setting-up "convert" in "/tmp/dcm2niixnf7vnzgq/convert".
261008-17:46:12,589 nipype.workflow INFO:
[Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
INFO: [Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
261008-17:46:12,635 nipype.interface INFO:
stdout 2026-10-08T17:46:12.634941:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
INFO: stdout 2026-10-08T17:46:12.634941:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
261008-17:46:12,635 nipype.interface INFO:
stdout 2026-10-08T17:46:12.634941:Found 44 DICOM file(s)
INFO: stdout 2026-10-08T17:46:12.634941:Found 44 DICOM file(s)
261008-17:46:12,635 nipype.interface INFO:
stdout 2026-10-08T17:46:12.634941:Convert 44 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_phasediff_heudiconv383_e2_ph (64x64x44x1)
INFO: stdout 2026-10-08T17:46:12.634941:Convert 44 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_phasediff_heudiconv383_e2_ph (64x64x44x1)
261008-17:46:12,648 nipype.interface INFO:
stdout 2026-10-08T17:46:12.648040:Compress: "/usr/bin/pigz" -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_phasediff_heudiconv383_e2_ph.nii"
INFO: stdout 2026-10-08T17:46:12.648040:Compress: "/usr/bin/pigz" -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_phasediff_heudiconv383_e2_ph.nii"
261008-17:46:12,648 nipype.interface INFO:
stdout 2026-10-08T17:46:12.648040:Conversion required 0.028452 seconds (0.015868 for core code).
INFO: stdout 2026-10-08T17:46:12.648040:Conversion required 0.028452 seconds (0.015868 for core code).
261008-17:46:12,664 nipype.workflow INFO:
[Node] Finished "convert", elapsed time 0.074714s.
INFO: [Node] Finished "convert", elapsed time 0.074714s.
261008-17:46:13,27 nipype.workflow INFO:
[Node] Setting-up "embedder" in "/tmp/embedmetal80yo7dz/embedder".
INFO: [Node] Setting-up "embedder" in "/tmp/embedmetal80yo7dz/embedder".
261008-17:46:13,33 nipype.workflow INFO:
[Node] Executing "embedder" <nipype.interfaces.utility.wrappers.Function>
INFO: [Node] Executing "embedder" <nipype.interfaces.utility.wrappers.Function>
261008-17:46:13,947 nipype.workflow INFO:
[Node] Finished "embedder", elapsed time 0.913299s.
INFO: [Node] Finished "embedder", elapsed time 0.913299s.
INFO: Post-treating /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_acq-4mm_phasediff.json file
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/dwi/sub-001_dir-AP_dwi (16 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/dwi . Converter: dcm2niix . Output types: ('nii.gz', 'dicom')
261008-17:46:13,960 nipype.workflow INFO:
[Node] Setting-up "convert" in "/tmp/dcm2niixp134pv8f/convert".
INFO: [Node] Setting-up "convert" in "/tmp/dcm2niixp134pv8f/convert".
261008-17:46:13,968 nipype.workflow INFO:
[Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
INFO: [Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
261008-17:46:14,38 nipype.interface INFO:
stdout 2026-10-08T17:46:14.038199:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
INFO: stdout 2026-10-08T17:46:14.038199:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
261008-17:46:14,38 nipype.interface INFO:
stdout 2026-10-08T17:46:14.038199:Found 16 DICOM file(s)
INFO: stdout 2026-10-08T17:46:14.038199:Found 16 DICOM file(s)
261008-17:46:14,38 nipype.interface INFO:
stdout 2026-10-08T17:46:14.038199:Convert 16 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/dwi/sub-001_dir-AP_dwi_heudiconv480 (122x122x66x16)
INFO: stdout 2026-10-08T17:46:14.038199:Convert 16 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/dwi/sub-001_dir-AP_dwi_heudiconv480 (122x122x66x16)
261008-17:46:14,295 nipype.interface INFO:
stdout 2026-10-08T17:46:14.295517:Compress: "/usr/bin/pigz" -b 960 -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/dwi/sub-001_dir-AP_dwi_heudiconv480.nii"
INFO: stdout 2026-10-08T17:46:14.295517:Compress: "/usr/bin/pigz" -b 960 -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/dwi/sub-001_dir-AP_dwi_heudiconv480.nii"
261008-17:46:14,295 nipype.interface INFO:
stdout 2026-10-08T17:46:14.295517:Conversion required 0.296850 seconds (0.066674 for core code).
INFO: stdout 2026-10-08T17:46:14.295517:Conversion required 0.296850 seconds (0.066674 for core code).
261008-17:46:14,314 nipype.workflow INFO:
[Node] Finished "convert", elapsed time 0.345287s.
INFO: [Node] Finished "convert", elapsed time 0.345287s.
261008-17:46:31,90 nipype.workflow INFO:
[Node] Setting-up "embedder" in "/tmp/embedmeta46v_pn01/embedder".
INFO: [Node] Setting-up "embedder" in "/tmp/embedmeta46v_pn01/embedder".
261008-17:46:31,94 nipype.workflow INFO:
[Node] Executing "embedder" <nipype.interfaces.utility.wrappers.Function>
INFO: [Node] Executing "embedder" <nipype.interfaces.utility.wrappers.Function>
261008-17:46:31,707 nipype.workflow INFO:
[Node] Finished "embedder", elapsed time 0.612354s.
INFO: [Node] Finished "embedder", elapsed time 0.612354s.
INFO: Post-treating /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/dwi/sub-001_dir-AP_dwi.json file
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_dir-PA_epi (132 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap . Converter: dcm2niix . Output types: ('nii.gz', 'dicom')
261008-17:46:31,723 nipype.workflow INFO:
[Node] Setting-up "convert" in "/tmp/dcm2niixmzzck6t0/convert".
INFO: [Node] Setting-up "convert" in "/tmp/dcm2niixmzzck6t0/convert".
261008-17:46:31,785 nipype.workflow INFO:
[Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
INFO: [Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
261008-17:46:31,859 nipype.interface INFO:
stdout 2026-10-08T17:46:31.859393:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
INFO: stdout 2026-10-08T17:46:31.859393:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
261008-17:46:31,859 nipype.interface INFO:
stdout 2026-10-08T17:46:31.859393:Found 132 DICOM file(s)
INFO: stdout 2026-10-08T17:46:31.859393:Found 132 DICOM file(s)
261008-17:46:31,859 nipype.interface INFO:
stdout 2026-10-08T17:46:31.859393:Convert 132 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_dir-PA_epi_heudiconv047 (122x122x66x2)
INFO: stdout 2026-10-08T17:46:31.859393:Convert 132 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_dir-PA_epi_heudiconv047 (122x122x66x2)
261008-17:46:31,957 nipype.interface INFO:
stdout 2026-10-08T17:46:31.957013:Compress: "/usr/bin/pigz" -b 960 -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_dir-PA_epi_heudiconv047.nii"
INFO: stdout 2026-10-08T17:46:31.957013:Compress: "/usr/bin/pigz" -b 960 -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_dir-PA_epi_heudiconv047.nii"
261008-17:46:31,957 nipype.interface INFO:
stdout 2026-10-08T17:46:31.957013:Conversion required 0.140474 seconds (0.046599 for core code).
INFO: stdout 2026-10-08T17:46:31.957013:Conversion required 0.140474 seconds (0.046599 for core code).
261008-17:46:31,974 nipype.workflow INFO:
[Node] Finished "convert", elapsed time 0.188098s.
INFO: [Node] Finished "convert", elapsed time 0.188098s.
261008-17:46:34,282 nipype.workflow INFO:
[Node] Setting-up "embedder" in "/tmp/embedmeta6mplor3k/embedder".
INFO: [Node] Setting-up "embedder" in "/tmp/embedmeta6mplor3k/embedder".
261008-17:46:34,293 nipype.workflow INFO:
[Node] Executing "embedder" <nipype.interfaces.utility.wrappers.Function>
INFO: [Node] Executing "embedder" <nipype.interfaces.utility.wrappers.Function>
261008-17:46:37,416 nipype.workflow INFO:
[Node] Finished "embedder", elapsed time 3.122266s.
INFO: [Node] Finished "embedder", elapsed time 3.122266s.
INFO: Post-treating /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/fmap/sub-001_dir-PA_epi.json file
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/func/sub-001_task-rest_bold (4 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/func . Converter: dcm2niix . Output types: ('nii.gz', 'dicom')
261008-17:46:37,433 nipype.workflow INFO:
[Node] Setting-up "convert" in "/tmp/dcm2niix9_h2nj_1/convert".
INFO: [Node] Setting-up "convert" in "/tmp/dcm2niix9_h2nj_1/convert".
261008-17:46:37,437 nipype.workflow INFO:
[Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
INFO: [Node] Executing "convert" <nipype.interfaces.dcm2nii.Dcm2niix>
261008-17:46:37,474 nipype.interface INFO:
stdout 2026-10-08T17:46:37.474789:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
INFO: stdout 2026-10-08T17:46:37.474789:Chris Rorden's dcm2niiX version v1.0.20220720 (JP2:OpenJPEG) (JP-LS:CharLS) GCC10.2.1 x86-64 (64-bit Linux)
261008-17:46:37,475 nipype.interface INFO:
stdout 2026-10-08T17:46:37.474789:Found 4 DICOM file(s)
INFO: stdout 2026-10-08T17:46:37.474789:Found 4 DICOM file(s)
261008-17:46:37,475 nipype.interface INFO:
stdout 2026-10-08T17:46:37.474789:Convert 4 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/func/sub-001_task-rest_bold_heudiconv857 (64x64x44x4)
INFO: stdout 2026-10-08T17:46:37.474789:Convert 4 DICOM as /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/func/sub-001_task-rest_bold_heudiconv857 (64x64x44x4)
261008-17:46:37,551 nipype.interface INFO:
stdout 2026-10-08T17:46:37.551427:Compress: "/usr/bin/pigz" -b 960 -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/func/sub-001_task-rest_bold_heudiconv857.nii"
INFO: stdout 2026-10-08T17:46:37.551427:Compress: "/usr/bin/pigz" -b 960 -n -f -6 "/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/func/sub-001_task-rest_bold_heudiconv857.nii"
261008-17:46:37,551 nipype.interface INFO:
stdout 2026-10-08T17:46:37.551427:Conversion required 0.083277 seconds (0.008077 for core code).
INFO: stdout 2026-10-08T17:46:37.551427:Conversion required 0.083277 seconds (0.008077 for core code).
261008-17:46:37,572 nipype.workflow INFO:
[Node] Finished "convert", elapsed time 0.134802s.
INFO: [Node] Finished "convert", elapsed time 0.134802s.
261008-17:46:37,798 nipype.workflow INFO:
[Node] Setting-up "embedder" in "/tmp/embedmeta71z99ih9/embedder".
INFO: [Node] Setting-up "embedder" in "/tmp/embedmeta71z99ih9/embedder".
261008-17:46:37,801 nipype.workflow INFO:
[Node] Executing "embedder" <nipype.interfaces.utility.wrappers.Function>
INFO: [Node] Executing "embedder" <nipype.interfaces.utility.wrappers.Function>
261008-17:46:37,917 nipype.workflow INFO:
[Node] Finished "embedder", elapsed time 0.115823s.
INFO: [Node] Finished "embedder", elapsed time 0.115823s.
INFO: Post-treating /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/func/sub-001_task-rest_bold.json file
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_scout__dup-01 (128 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat . Converter: dcm2niix . Output types: ('dicom',)
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_scout__dup-02 (128 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat . Converter: dcm2niix . Output types: ('dicom',)
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_scout__dup-03 (5 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat . Converter: dcm2niix . Output types: ('dicom',)
INFO: Converting /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat/sub-001_scout__dup-04 (3 DICOMs) -> /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001/anat . Converter: dcm2niix . Output types: ('dicom',)
INFO: Adding "IntendedFor" to the fieldmaps in /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben/sub-001.
INFO: Populating template files under /home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben
INFO: PROCESSING DONE: {'subject': '001', 'outdir': '/home/jovyan/workspace/books/examples/workflows/heudiconv_reproin_bids/Patterson/Coben', 'session': None}
2.3. Using bidscoin (automated workflow)¶
BIDScoin requires the source data repository to be organized according to a subject/[session]/data structure where data folder can be structured in DICOM series layout, DICOMDIR layout, flat DICOM layout. Refer to this doc for more details.
To perform BIDS conversion, run:
(1a)
bidsmappercommandonce
bidsmapperfinishes, it automatically launches (1b) thebidseditor. Note: The--automatedflag skips the manual editing step with bidseditor(2)
bidscoinercommand

import module
await module.load('bidscoin/4.3.3')%%bash
mkdir -p bidscoin_bids
bidsmapper ./heudiconv-reproin-example/REPROIN/dicom ./bidscoin_bids --subprefix '00' --sesprefix 'Patterson_Coben' --automated # Scans your data and creates a study bidsmap non-interactively
bidscoiner ./heudiconv-reproin-example/REPROIN/dicom ./bidscoin_bids # Converts your data to BIDS using the study bidsmapINFO |
INFO | -------------- START BIDSmapper ------------
INFO | >>> bidsmapper sourcefolder=/home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom bidsfolder=/home/jovyan/workspace/books/examples/workflows/bidscoin_bids bidsmap=bidsmap.yaml template=/home/jovyan/.bidscoin/4.3.3+qt5/templates/bidsmap_dccn.yaml plugins=[] subprefix=00 sesprefix=Patterson_Coben store=False force=False
INFO | No existing bidsmap file found: /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/code/bidscoin/bidsmap.yaml
INFO | Reading: /home/jovyan/.bidscoin/4.3.3+qt5/templates/bidsmap_dccn.yaml
INFO | generated new fontManager
INFO | Checking the bidsmap run-items:
SUCCESS | All datatypes and options in the template bidsmap are valid
INFO | Mapping: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1 (subject 1/1)
VERBOSE | Executing plugin: dcm2niix2bids -> /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1
INFO | Discovered 'exclude' DICOM sample: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/Localizers_4/IM-0012-0001-0001.dcm
INFO | Discovered 'anat' DICOM sample: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/anatT1w_acqMPRAGE_6/IM-0001-0001.dcm
INFO | Discovered 'dwi' DICOM sample: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/dwi_dirAP_9/IM-0004-0001.dcm
INFO | Discovered 'fmap' DICOM sample: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/fmap_acq4mm_7/IM-0002-0001-0001.dcm
INFO | Discovered 'fmap' DICOM sample: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/fmap_acq4mm_8/IM-0003-0001.dcm
INFO | Discovered 'fmap' DICOM sample: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/fmap_dirPA_15/IM-0010-0001.dcm
INFO | Discovered 'func' DICOM sample: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/func_taskrest_16/IM-0011-0001.dcm
INFO | Checking the bidsmap run-items:
SUCCESS | All run-items in the bidsmap are valid
INFO | bids-validator 1.14.6 test results (* = in .bidsignore):
INFO | False: exclude/sub-DICOM_task-anatscoutMPRcor_acq-anatscout_echo-1_GR.*
SUCCESS | All generated bidsnames are BIDS-valid
INFO | Writing bidsmap to: /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/code/bidscoin/bidsmap.yaml
INFO | -------------- FINISHED! -------------------
INFO |
SUCCESS | No BIDScoin errors or warnings were reported
INFO |
INFO | For the complete log see: /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/code/bidscoin/bidsmapper.log
NB: That folder may contain privacy sensitive information, e.g. pathnames in logfiles and provenance data samples
INFO |
INFO | -------------- START BIDScoiner 4.3.3+qt5: BIDS 1.9.0 ------------
INFO | >>> bidscoiner sourcefolder=/home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom bidsfolder=/home/jovyan/workspace/books/examples/workflows/bidscoin_bids participant=None force=False bidsmap=bidsmap.yaml
INFO | Creating dataset description file: /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/dataset_description.json
INFO | Creating a template README file (adjust it to your needs): /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/README
INFO | Reading: /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/code/bidscoin/bidsmap.yaml
INFO | Checking the bidsmap run-items:
SUCCESS | All run-items in the bidsmap are valid
INFO | ------------------- Subject 1/1 -------------------
INFO | >>> Coining datasources in: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1
VERBOSE | Executing plugin: dcm2niix2bids
INFO | --> Leaving out: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/Localizers_4
INFO | --> Coining: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/anatT1w_acqMPRAGE_6
VERBOSE | Command:
dcm2niix -b y -z y -i n -l n -f "sub-1_ses-1_acq-anatT1wacqMPRAGE_T1w" -o "/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/anat" "/home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/anatT1w_acqMPRAGE_6"
VERBOSE | Output:
Chris Rorden's dcm2niiX version v1.0.20240202 (JP2:OpenJPEG) (JP-LS:CharLS) GCC12.2.0 x86-64 (64-bit Linux)
Found 240 DICOM file(s)
Convert 240 DICOM as /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/anat/sub-1_ses-1_acq-anatT1wacqMPRAGE_T1w (224x224x240x1)
Conversion required 1.161547 seconds (1.161039 for core code).
INFO | --> Coining: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/dwi_dirAP_9
VERBOSE | Command:
dcm2niix -b y -z y -i n -l n -f "sub-1_ses-1_acq-dwidirAP_dir-AP_dwi" -o "/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/dwi" "/home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/dwi_dirAP_9"
VERBOSE | Output:
Chris Rorden's dcm2niiX version v1.0.20240202 (JP2:OpenJPEG) (JP-LS:CharLS) GCC12.2.0 x86-64 (64-bit Linux)
Found 16 DICOM file(s)
Convert 16 DICOM as /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/dwi/sub-1_ses-1_acq-dwidirAP_dir-AP_dwi (122x122x66x16)
Conversion required 1.258999 seconds (1.257482 for core code).
INFO | --> Coining: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/fmap_acq4mm_7
VERBOSE | Command:
dcm2niix -b y -z y -i n -l n -f "sub-1_ses-1_acq-fmapacq4mm_magnitude1" -o "/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap" "/home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/fmap_acq4mm_7"
VERBOSE | Output:
Chris Rorden's dcm2niiX version v1.0.20240202 (JP2:OpenJPEG) (JP-LS:CharLS) GCC12.2.0 x86-64 (64-bit Linux)
Found 88 DICOM file(s)
Slices not stacked: echo varies (TE 7.38, 4.92; echo 2, 1). Use 'merge 2D slices' option to force stacking
Convert 44 DICOM as /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_magnitude1_e2 (64x64x44x1)
Convert 44 DICOM as /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_magnitude1_e1 (64x64x44x1)
Conversion required 0.046456 seconds (0.046452 for core code).
VERBOSE | Found dcm2niix ['e1'] postfixes, renaming
/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_magnitude1_e1.nii.gz ->
/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_magnitude1.nii.gz
VERBOSE | Found dcm2niix ['e2'] postfixes, renaming
/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_magnitude1_e2.nii.gz ->
/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_magnitude2.nii.gz
INFO | --> Coining: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/fmap_acq4mm_8
VERBOSE | Command:
dcm2niix -b y -z y -i n -l n -f "sub-1_ses-1_acq-fmapacq4mm_phasediff" -o "/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap" "/home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/fmap_acq4mm_8"
VERBOSE | Output:
Chris Rorden's dcm2niiX version v1.0.20240202 (JP2:OpenJPEG) (JP-LS:CharLS) GCC12.2.0 x86-64 (64-bit Linux)
Found 44 DICOM file(s)
Convert 44 DICOM as /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_phasediff_e2_ph (64x64x44x1)
Conversion required 0.024823 seconds (0.024783 for core code).
VERBOSE | Found dcm2niix ['e2', 'ph'] postfixes, renaming
/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_phasediff_e2_ph.nii.gz ->
/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_phasediff.nii.gz
INFO | --> Coining: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/fmap_dirPA_15
VERBOSE | Command:
dcm2niix -b y -z y -i n -l n -f "sub-1_ses-1_acq-fmapdirPA_fieldmap" -o "/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap" "/home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/fmap_dirPA_15"
VERBOSE | Output:
Chris Rorden's dcm2niiX version v1.0.20240202 (JP2:OpenJPEG) (JP-LS:CharLS) GCC12.2.0 x86-64 (64-bit Linux)
Found 132 DICOM file(s)
Convert 132 DICOM as /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapdirPA_fieldmap (122x122x66x2)
Conversion required 0.191700 seconds (0.190777 for core code).
INFO | --> Coining: /home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/func_taskrest_16
VERBOSE | Command:
dcm2niix -b y -z y -i n -l n -f "sub-1_ses-1_task-functaskrest_dir-AP_bold" -o "/home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/func" "/home/jovyan/workspace/books/examples/workflows/heudiconv-reproin-example/REPROIN/dicom/001/Patterson_Coben - 1/func_taskrest_16"
VERBOSE | Output:
Chris Rorden's dcm2niiX version v1.0.20240202 (JP2:OpenJPEG) (JP-LS:CharLS) GCC12.2.0 x86-64 (64-bit Linux)
Found 4 DICOM file(s)
Convert 4 DICOM as /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/func/sub-1_ses-1_task-functaskrest_dir-AP_bold (64x64x44x4)
Conversion required 0.052113 seconds (0.051775 for core code).
VERBOSE | Writing acquisition time data to: /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/sub-1_ses-1_scans.tsv
VERBOSE | Writing sub-1 subject data to: /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/participants.tsv
VERBOSE | Writing subject meta data to: /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/participants.json
WARNING | Empty IntendedFor/B0FieldSource/B0FieldIdentifier fieldmap values in /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_magnitude1.json (i.e. the fieldmap may not be used)
WARNING | Empty IntendedFor/B0FieldSource/B0FieldIdentifier fieldmap values in /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_magnitude2.json (i.e. the fieldmap may not be used)
WARNING | Empty IntendedFor/B0FieldSource/B0FieldIdentifier fieldmap values in /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_phasediff.json (i.e. the fieldmap may not be used)
WARNING | Empty IntendedFor/B0FieldSource/B0FieldIdentifier fieldmap values in /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapdirPA_fieldmap.json (i.e. the fieldmap may not be used)
INFO | -------------- FINISHED! ------------
INFO |
INFO | The following BIDScoin errors and warnings were reported:
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
2026-10-08 17:47:31 - WARNING | Empty IntendedFor/B0FieldSource/B0FieldIdentifier fieldmap values in /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_magnitude1.json (i.e. the fieldmap may not be used)
2026-10-08 17:47:31 - WARNING | Empty IntendedFor/B0FieldSource/B0FieldIdentifier fieldmap values in /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_magnitude2.json (i.e. the fieldmap may not be used)
2026-10-08 17:47:31 - WARNING | Empty IntendedFor/B0FieldSource/B0FieldIdentifier fieldmap values in /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapacq4mm_phasediff.json (i.e. the fieldmap may not be used)
2026-10-08 17:47:31 - WARNING | Empty IntendedFor/B0FieldSource/B0FieldIdentifier fieldmap values in /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/sub-1/ses-1/fmap/sub-1_ses-1_acq-fmapdirPA_fieldmap.json (i.e. the fieldmap may not be used)
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
INFO | For the complete log see: /home/jovyan/workspace/books/examples/workflows/bidscoin_bids/code/bidscoin/bidscoiner.log
NB: That folder may contain privacy sensitive information, e.g. pathnames in logfiles and provenance data samples
Creating BIDScoin configuration:
-> /home/jovyan/.bidscoin/4.3.3+qt5/config.toml
-> /home/jovyan/.bidscoin/4.3.3+qt5/templates/bidsmap_dccn.yaml
-> /home/jovyan/.bidscoin/4.3.3+qt5/templates/bidsmap_bids2bids.yaml
-> /home/jovyan/.bidscoin/4.3.3+qt5/templates/bidsmap_sst.yaml
-> /home/jovyan/.bidscoin/4.3.3+qt5/templates/schema.json
!tree ./bidscoin_bids/./bidscoin_bids/
├── README
├── code
│ └── bidscoin
│ ├── bidscoiner.errors
│ ├── bidscoiner.log
│ ├── bidscoiner.tsv
│ ├── bidsmap.yaml
│ ├── bidsmapper.errors
│ └── bidsmapper.log
├── dataset_description.json
├── participants.json
├── participants.tsv
└── sub-1
└── ses-1
├── anat
│ ├── sub-1_ses-1_acq-anatT1wacqMPRAGE_T1w.json
│ └── sub-1_ses-1_acq-anatT1wacqMPRAGE_T1w.nii.gz
├── dwi
│ ├── sub-1_ses-1_acq-dwidirAP_dir-AP_dwi.bval
│ ├── sub-1_ses-1_acq-dwidirAP_dir-AP_dwi.bvec
│ ├── sub-1_ses-1_acq-dwidirAP_dir-AP_dwi.json
│ └── sub-1_ses-1_acq-dwidirAP_dir-AP_dwi.nii.gz
├── fmap
│ ├── sub-1_ses-1_acq-fmapacq4mm_magnitude1.json
│ ├── sub-1_ses-1_acq-fmapacq4mm_magnitude1.nii.gz
│ ├── sub-1_ses-1_acq-fmapacq4mm_magnitude2.json
│ ├── sub-1_ses-1_acq-fmapacq4mm_magnitude2.nii.gz
│ ├── sub-1_ses-1_acq-fmapacq4mm_phasediff.json
│ ├── sub-1_ses-1_acq-fmapacq4mm_phasediff.nii.gz
│ ├── sub-1_ses-1_acq-fmapdirPA_fieldmap.bval
│ ├── sub-1_ses-1_acq-fmapdirPA_fieldmap.bvec
│ ├── sub-1_ses-1_acq-fmapdirPA_fieldmap.json
│ └── sub-1_ses-1_acq-fmapdirPA_fieldmap.nii.gz
├── func
│ ├── sub-1_ses-1_task-functaskrest_dir-AP_bold.json
│ └── sub-1_ses-1_task-functaskrest_dir-AP_bold.nii.gz
└── sub-1_ses-1_scans.tsv
9 directories, 29 files
Dependencies in Jupyter/Python¶
Using the package watermark to document system environment and software versions used in this notebook, alongside the Neurodesktop version extracted from the
JUPYTER_IMAGEorNEURODESKTOP_VERSIONenvironment variables.
import os
%load_ext watermark
%watermark
%watermark --iversions
neurodesktop_version = (
os.environ.get('JUPYTER_IMAGE', '').split(':')[-1] or
os.environ.get('NEURODESKTOP_VERSION', 'unknown')
)
print(f"Neurodesktop version: {neurodesktop_version}")Last updated: 2026-10-08T17:47:32.443071+00:00
Python implementation: CPython
Python version : 3.13.15
IPython version : 9.17.1
Compiler : GCC 15.3.0
OS : Linux
Release : 6.8.0-111-generic
Machine : x86_64
Processor : x86_64
CPU cores : 16
Architecture: 64bit
Neurodesktop version: 2026-10-05
- Li, X., Morgan, P. S., Ashburner, J., Smith, J., & Rorden, C. (2016). The first step for neuroimaging data analysis: DICOM to NIfTI conversion. Journal of Neuroscience Methods, 264, 47–56. 10.1016/j.jneumeth.2016.03.001
- Zwiers, M. P., Moia, S., & Oostenveld, R. (2022). BIDScoin: A User-Friendly Application to Convert Source Data to Brain Imaging Data Structure. Frontiers in Neuroinformatics, 15. 10.3389/fninf.2021.770608
- Yaroslav O. Halchenko, Mathias Goncalves, Satrajit Ghosh, Pablo Velasco, Matteo Visconti di Oleggio Castello, Taylor Salo, John T. Wodder II, Michael Hanke, Patrick Sadil, Krzysztof Jacek Gorgolewski, Horea-Ioan Ioanas, Chris Rorden, Timothy J. Hendrickson, Michael Dayan, Sean Dae Houlihan, James Kent, Ted Strauss, John Lee, Isaac To, … David N. Kennedy. (2024). HeuDiConv — flexible DICOM conversion into structured directory layouts. Zenodo. 10.5281/ZENODO.13994097