Singularity and heudiconv


Hi, I am trying to follow the (which is great) using singularity rather than docker. Each time I try to run the command using singularity, I receive the error “no match”. I am not very familiar with singularity, so I assume this is due to where singularity is stored vs the data?

singularity run /usr/pubsw/packages/heudiconv/heudiconv.simg --bind /data:/base nipy/heudiconv:latest -d /base/dicom/sub-{subject}/ses-{session}/scans//.dcm -o /base/nifti/ -f convertall -s 01 -ss 001 -c none --overwrite

Any help to get started would be very appreciated.


Hi @laurenbreithaupt,

Your command line reflects some confusion about how singularity works. On the one hand, you are trying to use a singularity image stored at /usr/pubsw/packages/heudiconv/heudiconv.simg. If this is correct and that singularity image has been correctly created with any of the multiple possible ways of building them, then you do not need the bit of your command line that looks like a docker image identifier (nipy/heudiconv:latest).

Then, you also have set the --bind argument at a wrong position.

The appropriate command line is:

singularity run -B /data:/base /usr/pubsw/packages/heudiconv/heudiconv.simg -d /base/dicom/sub-{subject}/ses-{session}/scans/ */* .dcm -o /base/nifti/ -f convertall -s 01 -ss 001 -c none --overwrite

Hi @oesteban,
Appreciate your help. When I try the command suggested, I receive a new error: heudiconv: error: unrecognized arguments: Desktop/lauren Documents/archives_below_308 matlab/startup.m .dcm


What is the exact command line you are running? It seems different from the earlier post. Did you switch to docker?


I am also trying to get heudiconv to work using Singularity. I have it working using Docker, and the following command lines:

docker run --rm -it -v /media/danella/DATA1/BEAM:/base nipy/heudiconv:latest -d /base/Dicom/sub-{subject}/ses-{session}//.dcm -o /base/Nifti_temp/ -f convertall -s 103 -ss pre -c none

docker run --rm -it -v /media/danella/DATA1/BEAM:/base nipy/heudiconv:latest -d /base/Dicom/sub-{subject}/ses-{session}//.dcm -o /base/Nifti_temp/ -f /base/Nifti/code/ -s 103 -ss pre -c dcm2niix -b

I attempted to convert this to singularity using the following code (where DATA_RAW has been defined as “base” above:

singularity run -B ${DATA_RAW}:${HOME}/data ${HOME}/heudiconv-unstable.simg -d ${HOME}/data/Dicom/sub-{subject}/ses-{session}//.dcm -o ${HOME}/data/Nifti_temp/ -f convertall -s 103 -ss pre -c none

singularity run -B ${DATA_RAW}:${HOME}/data ${HOME}/heudiconv-unstable.simg -d ${HOME}/data/Dicom/sub-{subject}/ses-{session}//.dcm -o ${HOME}/data/Nifti_temp/ -f ${HOME}/data/Nifti/code/ -s 103 -ss pre -c dcm2niix -b

The first item of code runs, and the .heudiconv directory is created. However, the second part crashes following conversion of the first run, with the following error code:

ERROR: Embedding failed: [Errno 1] Operation not permitted: ‘/home/danella/data/Nifti_temp/sub-103/ses-pre/func/sub-103_ses-pre_task-cogert1_run-001_bold.json’
INFO: Post-treating /home/danella/data/Nifti_temp/sub-103/ses-pre/func/sub-103_ses-pre_task-cogert1_run-001_bold.json file
Traceback (most recent call last):
File “/opt/miniconda-latest/bin/heudiconv”, line 11, in
load_entry_point(‘heudiconv’, ‘console_scripts’, ‘heudiconv’)()
File “/src/heudiconv/heudiconv/cli/”, line 127, in main
File “/src/heudiconv/heudiconv/cli/”, line 323, in process_args
File “/src/heudiconv/heudiconv/”, line 199, in prep_conversion
File “/src/heudiconv/heudiconv/”, line 318, in convert
File “/src/heudiconv/heudiconv/”, line 256, in treat_infofile
set_readonly(filename, False)
File “/src/heudiconv/heudiconv/”, line 389, in set_readonly
os.chmod(path, new_perms)
PermissionError: [Errno 1] Operation not permitted: ‘/home/danella/data/Nifti_temp/sub-103/ses-pre/func/sub-103_ses-pre_task-cogert1_run-001_bold.json’

I am a complete newbie when it comes to Singularity, so any assistance would be much appreciated!


This may be unhelpful, but have you tried pulling a different version of heudiconv?

I created my singularity image using singularity pull docker://nipy/heudiconv:0.5.4 (we have singularity 3 installed on our cluster), but also have it working with the debian heudiconv release:

See however my issue at: Overwriting heudiconv and sub.edit.txt


I am also at the Martinos center, and got the same singularity: No match. error. The center uses tcsh as the default shell. When I typed the same command in bash, it worked fine:

tcsh$ bash
bash$ singularity run -B /autofs/space/piper_003/users/path/to/my/files/:/base /usr/pubsw/packages/heudiconv/heudiconv.simg -d /base/dicom/{subject}/* -o /base/nifti/ -f convertall -s mysubject080 -c none

I also discovered that absolute paths don’t work; the -B is essential because it gives Singularity read access to the files. If you don’t use -B with the colon notation, the following error is printed:
INFO: Need to process 0 study sessions