New EMG examples showcasing invasive recordings#549
Open
klotz-t wants to merge 81 commits intobids-standard:masterfrom
Open
New EMG examples showcasing invasive recordings#549klotz-t wants to merge 81 commits intobids-standard:masterfrom
klotz-t wants to merge 81 commits intobids-standard:masterfrom
Conversation
… into emg_examples
…tion_channels.tsv
Merge current main branch into invasive EMG branch
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The current EMG-BIDS specification does not include specifications for invasive EMG recordings (which are also highly relevant to the field). This pull request contains three examples of invasive EMG: concentric needle, fine wire, and combined invasive and surface EMG.
The following extensions (in _emg.json) should suffice to make EMG-BIDS capable of handling invasive EMG:
EMGType (REQUIRED): Specify the type of EMG recording. Can be eithersurface, invasive, or combined.CannulaDiameter (RECOMMENDED if invasive EMG): Diameter of the inserted needle (it is often reported in Gauge units; decide if one wants to stay with that convention or if metric units should be used (more BIDS-like))CannulaLength (RECOMMENDED if invasive EMG): Length of the inserted needle in millimeters.CannulaMaterial (RECOMMENDED if invasive EMG): Material of the needle.InsulatorMaterial (RECOMMENDED if fine wire or concentric needle electrode): Material used to insulate a pair of fine wire electrodes or the signal electrode from the shaft (reference) in a concentric needle.SterilizationMethod (RECOMMENDED if invasive EMG): Method used to sterilize the EMG-electrodes, e.g., E-beam or ethylene oxide.ElectrodeSurfaceArea (RECOMMENDED if invasive EMG, otherwise also not a bad idea to be reported): Surface area of the electrode contact in mm^2 (in the case of fine wire electrodes, only fully specified throughElectrodeDiameter(does also fit other electrode types) andElectrodeTipLength(potentially only relevant for that type of electrode))Here are a few additional considerations from validating these new examples with the BIDS validator (all of them pass):
ElectrodeManufacturerorElectrodeManufacturersModelNamethat are identified to be included in*electrodes.tsv(if needed); however, they are not specified there, so the BIDS validator only lets you pass if you put these fields in anelectrode.jsonfile.InterelectrodeDistanceis currently described to belong to*electrodes.tsv(if heterogeneous); however, formally it is defined to belong to*channels.tsv. I think it makes sense to have it in theelectrodes.tsv; at least, it should be described consistently.SoftwareFiltersis a required field; if channel-specific, there is nothing reasonable to put there (n/aalso feels not correct). Maybe there should be an optionchannel-specific(next ton/a or object). In one example, I have implemented a workaround: in the corresponding object, I set the low- and high-pass cut-offs to channel-specific (to let you pass the validator).