Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ENH: add HeudiconvVersion to sidecar .json files #529

Merged
merged 1 commit into from
Oct 28, 2021

Conversation

yarikoptic
Copy link
Member

Unfortunately there is no convention yet in BIDS on storing such information in
a standardized way.

bids-standard/bids-specification#440
proposes to add GeneratedBy (within dataset_description.json)
which could provide detailed high level information which should then be
consistent through out dataset (so we would need to add safeguards)

bids-standard/bids-specification#487
is WiP to introduce PROV into BIDS standard, which would allow to establish
_prov.json with all needed gory details.

For now, since fields in side car .json files are not strictly regulated,
I think it would be benefitial to user to have heudiconv version stored there
along with other "Version" fields, such as

$> grep -e Version -e dcm2ni fmap/sub-phantom1sid1_ses-localizer_acq-3mm_phasediff.json
  "ConversionSoftware": "dcm2niix",
  "ConversionSoftwareVersion": "v1.0.20211006",
  "SoftwareVersions": "syngo MR E11",

and although strictly speaking Heudiconv is a "conversion software", since
dcm2niix decided to use that pair, I have decided to leave it alone and just
come up with yet another descriptive key

"HeudiconvVersion": "0.10.0",

Unfortunately there is no convention yet in BIDS on storing such information in
a standardized way.

bids-standard/bids-specification#440
 proposes to add GeneratedBy (within dataset_description.json)
 which could provide detailed high level information which should then be
 consistent through out dataset (so we would need to add safeguards)

bids-standard/bids-specification#487
 is WiP to introduce PROV into BIDS standard, which would allow to establish
 _prov.json with all needed gory details.

For now, since fields in side car .json files are not strictly regulated,
I think it would be benefitial to user to have heudiconv version stored there
along with other "Version" fields, such as

	$> grep -e Version -e dcm2ni fmap/sub-phantom1sid1_ses-localizer_acq-3mm_phasediff.json
	  "ConversionSoftware": "dcm2niix",
	  "ConversionSoftwareVersion": "v1.0.20211006",
	  "SoftwareVersions": "syngo MR E11",

and although strictly speaking Heudiconv is a "conversion software", since
dcm2niix decided to use that pair, I have decided to leave it alone and just
come up with yet another descriptive key

  "HeudiconvVersion": "0.10.0",
@codecov
Copy link

codecov bot commented Oct 11, 2021

Codecov Report

Merging #529 (ee0dcb0) into master (460a818) will increase coverage by 0.08%.
The diff coverage is 100.00%.

Impacted file tree graph

@@            Coverage Diff             @@
##           master     #529      +/-   ##
==========================================
+ Coverage   77.48%   77.56%   +0.08%     
==========================================
  Files          41       41              
  Lines        3135     3147      +12     
==========================================
+ Hits         2429     2441      +12     
  Misses        706      706              
Impacted Files Coverage Δ
heudiconv/bids.py 84.61% <100.00%> (+0.30%) ⬆️
heudiconv/tests/test_heuristics.py 100.00% <100.00%> (ø)

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 460a818...ee0dcb0. Read the comment docs.

@yarikoptic yarikoptic requested review from mgxd and satra October 11, 2021 21:39
@yarikoptic
Copy link
Member Author

if no comments/objections are voiced, I will merge in 2 days.

@yarikoptic yarikoptic merged commit 2695ecf into nipy:master Oct 28, 2021
@yarikoptic yarikoptic deleted the enh-version branch April 20, 2022 16:27
@yarikoptic yarikoptic added the patch Increment the patch version when merged label Apr 20, 2022
@github-actions
Copy link

🚀 PR was released in v0.11.0 🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
patch Increment the patch version when merged released
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant