[ENH] Add explicit wording on DICOM terms correspondence (#1450)

* Add explicit wording on DICOM terms correspondence * Extend to Based on for DICOM * Update src/common-principles.md Co-authored-by: Stefan Appelhoff <[email protected]> * Update avoiding "instructions to spec authors" language Co-authored-by: Chris Markiewicz <[email protected]> --------- Co-authored-by: Remi Gau <[email protected]> Co-authored-by: Stefan Appelhoff <[email protected]> Co-authored-by: Chris Markiewicz <[email protected]>
bids-standard · Jun 17, 2024 · d25a3fd · d25a3fd
1 parent d8397a3
commit d25a3fd
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/src/common-principles.md b/src/common-principles.md
@@ -449,6 +449,11 @@ possible. Since the NIfTI standard offers limited support for the various image
 acquisition parameters available in DICOM files, we RECOMMEND that users provide
 additional meta information extracted from DICOM files in a sidecar JSON file
 (with the same filename as the `.nii[.gz]` file, but with a `.json` extension).
+Currently defined metadata fields are listed in the [Glossary](./glossary.md).
+Where possible, DICOM Tags are adopted directly as BIDS metadata terms and
+indicated with "**Corresponds to** DICOM Tag ID1, ID2 `DICOM Tag Name`.".
+When harmonization has been deemed necessary, this is indicated in the
+BIDS term description with "**Based on** DICOM Tag ID1, ID2 `DICOM Tag Name`.".
 Extraction of BIDS compatible metadata can be performed using [dcm2niix](https://github.com/rordenlab/dcm2niix)
 and [dicm2nii](https://www.mathworks.com/matlabcentral/fileexchange/42997-xiangruili-dicm2nii)
 DICOM to NIfTI converters. The [BIDS-validator](https://github.com/bids-standard/bids-validator)