Merge branch 'master' into bep032-review

Author: CodyCBakerPhD

.pre-commit-config.yaml

@@ -33,7 +33,7 @@ repos:
         entry: env PRETTIER_LEGACY_CLI=1 prettier # temporary fix for https://github.com/prettier/prettier/issues/15742
         files: src/schema/.*/.*\.yaml
   - repo: https://github.com/adrienverge/yamllint
-    rev: v1.37.1
+    rev: v1.38.0
     hooks:
       - id: yamllint
         args: [-f=standard, -c=.yamllint.yml]

src/common-principles.md

@@ -85,7 +85,7 @@ saved under a particular filename specified in the standard. This standard
 aspires to describe a majority of datasets, but acknowledges that there will be
 cases that do not fit. In such cases one can include additional files and
 subdirectories to the existing directory structure following common sense. For example
-one may want to include eye tracking data in a vendor specific format that is
+one may want to include eye-tracking data in a vendor specific format that is
 not covered by this standard. The most sensible place to put it is next to the
 continuous recording file with the same naming scheme but different extensions.
 The solutions will change from case to case and publicly available datasets will

src/modality-agnostic-files/events.md

@@ -264,6 +264,22 @@ and a guide for using macros can be found at
 -->
 {{ MACROS___make_subobject_table("metadata.StimulusPresentation") }}
 
+!!! warning "Important"
+
+    Some metadata of the `StimulusPresentation` object become REQUIRED with the presence of
+    "gaze-on-screen"
+    [eye-tracking data](../modality-specific-files/physiological-recordings.md#eye-tracking),
+    as identified by the `"SampleCoordinateSystem"` metadata.
+
+    The following fields pertaining to `<matches>_events.json` of tasks that were acquired
+    with the simultaneous recording of eye-tracking escalate to REQUIRED as they are considered
+    essential in eye-tracking data analysis:
+
+    -   `StimulusPresentation.ScreenDistance`,
+    -   `StimulusPresentation.ScreenOrigin`,
+    -   `StimulusPresentation.ScreenResolution`,
+    -   `StimulusPresentation.ScreenSize`.
+
 The operating system description SHOULD include the following attributes:
 
 -   type (for example, Windows, macOS, Linux)

src/modality-specific-files/magnetic-resonance-imaging-data.md

@@ -902,6 +902,16 @@ A guide for using macros can be found at
 
 ### Other RECOMMENDED metadata
 
+<!-- This block generates a metadata table.
+These tables are defined in
+  src/schema/rules/sidecars
+The definitions of the fields specified in these tables may be found in
+  src/schema/objects/metadata.yaml
+A guide for using macros can be found at
+ https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
+-->
+{{ MACROS___make_sidecar_table("dwi.MRIDiffusionOtherMetadata") }}
+
 The `PhaseEncodingDirection` and `TotalReadoutTime` metadata
 fields are RECOMMENDED to enable the correction of geometrical distortions
 with [fieldmap information](#fieldmap-data).