nipy / heudiconv

Flexible DICOM conversion into structured directory layouts
https://heudiconv.readthedocs.io
Other
232 stars 125 forks source link

Adding quality control info of scans in BIDS folder #278

Open maryammokhberi opened 5 years ago

maryammokhberi commented 5 years ago

Hi all,

I am reaching out from Rotman Research Institute, Toronto, to ask a question about heudiconv. It has been a while that I am working with this converter to convert our dataset of several thousand subjects into BIDS format.

Here in our lab, we generate manual QC reports (e.g usability of the files and short description notes) for the scans and would like to include them in the converted BIDS folders too. I had a quick chat with Chris back at INCF about the way we can incorporate QC reports in BIDS, and he suggested adding a few more columns to the sub-{subject}_ses-{session}_scans.tsv file and include QC data there. I think it is a genuine solution and probably is not hard to implement.

But the problem is that all our data is on a remote server, and the only feasible way for us to run heudiconv on them is to pull it from docker.

So my [kind of naive] question is here: If I fork this repository and add QC feature to the code, Is there a way to pull it from docker? Or I can just pull the latest established version of the base branch from docker?

If you have any comment or any other idea about this issue I would be very glad to hear.

Thanks, Maryam

mgxd commented 5 years ago

Hi @maryammokhberi

You can achieve this by: 1) git clone on your fork 2) making the necessary changes within heudiconv/ 3) test and verify 4) create dockerid if you haven't already (https://hub.docker.com/) to push allow pushing to dockerhub 4) docker build a new image using our Dockerfile - ex: docker build --rm -t <DOCKERID>/heudiconv:enh-qc /path/to/dockerfile/directory 5) docker push the created image

After this, you should be able to pull your image.

We welcome Pull Requests adding new features to heudiconv, so feel free to open a PR along the way too!