[ENH] BEP030: Functional Near-Infrared Spectroscopy

mkdocs.yml

@@ -49,6 +49,7 @@ nav:
         - Genetic Descriptor: 04-modality-specific-files/08-genetic-descriptor.md
         - Positron Emission Tomography: 04-modality-specific-files/09-positron-emission-tomography.md
         - Microscopy: 04-modality-specific-files/10-microscopy.md
+        - Functional Near-Infrared Spectroscopy: 04-modality-specific-files/11-functional-near-infrared-spectroscopy.md
       - Derivatives:
         - BIDS Derivatives: 05-derivatives/01-introduction.md
         - Common data types and metadata: 05-derivatives/02-common-data-types.md

src/schema/meta/context.yaml

@@ -181,7 +181,15 @@ context:
             n_cols:
               description: 'Number of columns in bvec file'
               type: integer
-
+        nirs:
+          description: 'contents of _nirs.json used by checks for channels.tsv'
+          type: object
+        channels:
+          type: boolean
+          description: 'boolean if _channels.tsv exists'
+        coordsystem:
+          type: boolean
+          description: 'boolean if _coordsystem.json exists'
     # The following properties are populated if the current file is of an appropriate type
     columns:
       description: 'TSV columns, indexed by column header, values are arrays with column contents'

src/schema/objects/columns.yaml

@@ -52,6 +52,24 @@ color:
     Hexadecimal. Label color for visualization.
   type: string
   unit: hexadecimal
+detector__channels:
+  name: detector
+  display_name: Detector Name
+  description: |
+    Name of the detector as specified in the `*_optodes.tsv` file.
+    `n/a` for channels that do not contain fNIRS signals (for example, acceleration).
+  anyOf:
+    - type: string
+    - type: string
+      enum:
+        - n/a
+detector_type:
+  name: detector_type
+  display_name: Detector Type
+  description: |
+    The type of detector. Only to be used if the field `DetectorType` in `*_nirs.json` is set to `mixed`.
+  anyOf:
+    - type: string
 derived_from:
   name: derived_from
   display_name: Derived from
@@ -66,6 +84,12 @@ description:
   description: |
     Brief free-text description of the channel, or other information of interest.
   type: string
+description__optode:
+  name: description
+  display_name: Description
+  description: |
+    Free-form text description of the optode, or other information of interest.
+  type: string
 dimension:
   name: dimension
   display_name: Dimension
@@ -240,6 +264,12 @@ name__electrodes:
   description: |
     Name of the electrode contact point.
   type: string
+name__optodes:
+  name: name
+  display_name: Optode name
+  description: |
+    Name of the optode, must be unique.
+  type: string
 # name column for dseg.tsv files
 name__segmentations:
   name: name
@@ -278,6 +308,16 @@ onset:
     acquired data point.
   type: number
   unit: s
+orientation_component:
+  name: orientation_component
+  display_name: Orientation Component
+  description: |
+    Description of the orientation of the `ACCEL`, `GYRO`, `MAGN` `type`.
+  type: string
+  enum:
+    - x
+    - y
+    - z
 pathology:
   name: pathology
   display_name: Pathology
@@ -420,6 +460,14 @@ sex:
     - OTHER
     - Other
     - n/a
+short_channel:
+  name: short_channel
+  display_name: Short Channel
+  description: |
+    Is the channel designated as short.
+    The total number of channels listed as short channels
+    SHOULD be stored in `ShortChannelCount` in `*_fnirs.json`.
+  type: boolean
 size:
   name: size
   display_name: Electrode size
@@ -440,6 +488,24 @@ software_filters:
     - type: string
       enum:
         - n/a
+source__channels:
+  name: source
+  display_name: Source name
+  description: |
+    Name of the source as specified in the `*_optodes.tsv` file.
+    `n/a` for channels that do not contain fNIRS signals (for example, acceleration).
+  anyOf:
+    - type: string
+    - type: string
+      enum:
+        - n/a
+source__optodes:
+  name: source_type
+  display_name: Source type
+  description: |
+    The type of source. Only to be used if the field `SourceType` in `*_nirs.json` is set to `mixed`.
+  anyOf:
+    - type: string
 species:
   name: species
   display_name: Species
@@ -614,13 +680,69 @@ type__ieeg_channels:
     - DAC
     - REF
     - OTHER
+type__nirs_channels:
+  name: type
+  display_name: Channel type
+  description: |
+    Type of channel; MUST use the channel types listed below.
+    Note that the type MUST be in upper-case.
+  type: string
+  enum:
+    - NIRSCWAMPLITUDE
+    - NIRSCWFLUORESCENSEAMPLITUDE
+    - NIRSCWOPTICALDENSITY
+    - NIRSCWHBO
+    - NIRSCWHBR
+    - NIRSCWMUA
+    - MEGMAG
+    - MEGGRADAXIAL
+    - MEGGRADPLANAR
+    - MEGREFMAG
+    - MEGREFGRADAXIAL
+    - MEGREFGRADPLANAR
+    - MEGOTHER
+    - EEG
+    - ECOG
+    - SEEG
+    - DBS
+    - VEOG
+    - HEOG
+    - EOG
+    - ECG
+    - EMG
+    - TRIG
+    - AUDIO
+    - PD
+    - EYEGAZE
+    - PUPIL
+    - MISC
+    - SYSCLOCK
+    - ADC
+    - DAC
+    - HLU
+    - FITERR
+    - ACCEL
+    - GYRO
+    - MAGN
+    - MISC
+    - OTHER
 # type column for electrodes.tsv files
 type__electrodes:
   name: type
   display_name: Electrode type
   description: |
     Type of the electrode (for example, cup, ring, clip-on, wire, needle).
   type: string
+type__optodes:
+  name: type
+  display_name: Type
+  description: |
+    The type of the optode.
+  type: string
+  enum:
+    - source
+    - detector
+    - n/a
 units:
   name: units
   display_name: Units
@@ -630,6 +752,17 @@ units:
     (see [Units](SPEC_ROOT/02-common-principles.md#units)).
   type: string
   format: unit
+units__nirs:
+  name: units
+  display_name: Units
+  description: |
+    Physical unit of the value represented in this channel,
+    specified according to the SI unit symbol and possibly prefix symbol,
+    or as a derived SI unit (for example, `V`, or unitless for changes in optical densities).
+    For guidelines about units see the [Appendix](SPEC_ROOT/99-appendices/05-units.md)
+    and [Common Principles](SPEC_ROOT/02-common-principles.md#units) pages.
+  type: string
+  format: unit
 value:
   name: value
   display_name: Marker value
@@ -652,6 +785,34 @@ volume_type:
     - m0scan
     - deltam
     - cbf
+wavelength_nominal:
+  name: wavelength_nominal
+  display_name: Wavelength nominal
+  description: |
+    Specified wavelength of light in nm.
+    `n/a` for channels that do not contain raw fNIRS signals (for example, acceleration).
+    This field is equivalent to `/nirs(i)/probe/wavelengths` in the SNIRF specification.
+  anyOf:
+    - type: number
+    - type: string
+      enum:
+        - n/a
+wavelength_actual:
+  name: wavelength_actual
+  display_name: Wavelength actual
+  description: |
+    Measured wavelength of light in nm.
+    `n/a` for channels that do not contain raw NIRS signals (acceleration).
+    This field is equivalent to `measurementList.wavelengthActual` in the SNIRF specification.
+  type: number
+wavelength_emission_actual:
+  name: wavelength_emission_actual
+  display_name: Wavelength emission actual
+  description: |
+    Measured emission wavelength of light in nm.
+    `n/a` for channels that do not contain raw NIRS signals (acceleration).
+    This field is equivalent to `measurementList.wavelengthEmissionActual` in the SNIRF specification.
+  type: number
 whole_blood_radioactivity:
   name: whole_blood_radioactivity
   display_name: Whole blood radioactivity
@@ -681,3 +842,66 @@ z:
     - type: string
       enum:
         - n/a
+x__optodes:
+  name: x
+  display_name: X position
+  description: |
+    Recorded position along the x-axis.
+    `"n/a"` if not available.
+  anyOf:
+    - type: number
+    - type: string
+      enum:
+        - n/a
+y__optodes:
+  name: y
+  display_name: Y position
+  description: |
+    Recorded position along the y-axis.
+    `"n/a"` if not available.
+  anyOf:
+    - type: number
+    - type: string
+      enum:
+        - n/a
+z__optodes:
+  name: z
+  display_name: Z position
+  description: |
+    Recorded position along the z-axis.
+    `"n/a"` if not available.
+  anyOf:
+    - type: number
+    - type: string
+      enum:
+        - n/a
+x__template:
+  name: template_x
+  display_name: X template position
+  description: |
+    Assumed or ideal position along the x axis.
+  anyOf:
+    - type: number
+    - type: string
+      enum:
+        - n/a
+y__template:
+  name: template_y
+  display_name: Y template position
+  description: |
+    Assumed or ideal position along the y axis.
+  anyOf:
+    - type: number
+    - type: string
+      enum:
+        - n/a
+z__template:
+  name: template_z
+  display_name: Z template position
+  description: |
+    Assumed or ideal position along the z axis.
+  anyOf:
+    - type: number
+    - type: string
+      enum:
+        - n/a

src/schema/objects/datatypes.yaml

@@ -53,3 +53,8 @@ pet:
   display_name: Positron Emission Tomography
   description: |
     Positron emission tomography data
+nirs:
+  value: nirs
+  display_name: Functional Near-Infrared Spectroscopy
+  description:
+    Near-Infrared data organized around the SNIRF format

src/schema/objects/extensions.yaml

@@ -237,6 +237,11 @@ set:
 
     The format used by the MATLAB toolbox [EEGLAB](https://sccn.ucsd.edu/eeglab).
     Each recording consists of a `.set` file with an optional `.fdt` file.
+snirf:
+  value: .snirf
+  display_name: Shared Near Infrared Spectroscopy Format
+  description: |
+    HDF5 file organized according to the [SNIRF specification](https://github.com/fNIRS/snirf)
 sqd:
   value: .sqd
   display_name: SQD