EMGPlacementScheme -> EMGPlacement

Author: drammock

src/modality-specific-files/electromyography.md

@@ -173,7 +173,7 @@ A guide for using macros can be found at
 {
   "EMGChannelCount":4,
   "EMGGround":"TODO",
-  "EMGPlacementScheme":"TODO",
+  "EMGPlacement":"midpoint between cubital fossa and radial styloid process",
   "EMGReference":"TODO",
   "HardwareFilters":{"Highpass RC filter": {"Half amplitude cutoff (Hz)": 0.0159, "Roll-off": "6dBOctave"}},
   "InstitutionAddress":"300 Pasteur Dr, Stanford, CA 94305",
@@ -304,8 +304,8 @@ In such cases, `EMGCoordinateSystem` SHOULD be specified as `Other` and the
 coordinate system (for example, "origin at the center of the grid" or "origin at the
 center of the electrode in the lower-left corner of the grid, when oriented with the
 leads downward").
-In such cases, the description in the `EMGPlacementScheme` field of `*_emg.json` MAY
-refer to the origin of that 2D coordinate system in describing the placement of the grid.
+In such cases, the description in the `EMGPlacement` field of `*_emg.json` MAY refer to
+the origin of that 2D coordinate system in describing the placement of the grid.
 
 The order of the required columns in the `*_electrodes.tsv` file MUST be as listed below.
 

src/schema/objects/metadata.yaml

@@ -956,15 +956,19 @@ EMGGround:
     Description of the location of the ground electrode
     (for example, `"placed on right styloid process"`).
   type: string
-# TODO do we want `EMGPlacementScheme`? It seems to make sense for things like SENIAM
-# but not when a defined coordinate system is used. That seems to suggest a rule that
-# the dataset must EITHER define EMGPlacementScheme OR define EMGCoordinateSystem, but
-# presumably not both?
-EMGPlacementScheme:
-  name: EMGPlacementScheme
-  display_name: EMG Placement Scheme
-  description: |
-    The name of a standardized placement system (for example, `"SENIAM 8"`).
+EMGPlacement:
+  name: EMGPlacement
+  display_name: EMG Placement Procedure
+  description: |
+    The name of a standardized electrode placement procedure (for example, `"SENIAM 8"`)
+    or a description of the procedure used.
+    Descriptions SHOULD reflect the process used by the researcher(s) when placing electrodes,
+    and SHOULD NOT simply give the name of the targeted muscle (use `TargetMuscle` for that).
+    For example, EMG electrode sites may be chosen by visual reference to target muscles,
+    by palpation of the skin to locate target muscles, by functional localization
+    (temporary electrode placement at several sites during prescribed behavior,
+    until a site yielding strong EMG signal is found), or by measured distances
+    (either absolute or proportional) relative to skeletal landmarks.
   type: string
 # TODO: so far this is just copy/paste from EEGReference
 EMGReference:

src/schema/rules/sidecars/emg.yaml

@@ -47,6 +47,7 @@ EMGRequired:
     - datatype == "emg"
     - suffix == "emg"
   fields:
+    EMGPlacement: required
     EMGReference: required
     SamplingFrequency:
       level: required
@@ -69,7 +70,6 @@ EMGRecommended:
     RecordingType: recommended
     EpochLength: recommended
     EMGGround: recommended
-    EMGPlacementScheme: recommended
     HardwareFilters: recommended
     SubjectArtefactDescription: recommended