-
Notifications
You must be signed in to change notification settings - Fork 34
NIRS Meta Data
Sean Mullen edited this page Dec 29, 2020
·
8 revisions
If a stream has the content-type NIRS, we recommend that meta-data about the stream adheres to the structure and naming laid out below. While all meta-data is optional, we recommend that any stream should describe at least those tags marked with an * below (and their parent containers) .
<channels> # per-channel meta-data
<channel> # description of one channel (one per channel in the time series)
<label> # unique channel label; an example naming scheme that references
# the source, detector and wavelength is: Src23-Dct6:750
<type> # type of data measured in this channel
# Typically Intensity, assumed if unspecified
# some devices may yield different or additional data types, e.g.:
# ** dOD: (delta) optical density
# ** HbO, HbR: oxyhemoglobin, deoxyhemoglobin concentration
# ** HbT: Total hemoglobin concentration
# ** H2O, Lipid, CCO: water / lipid / Cytochrome c oxidase concentration
# ** mua, musp: absorption coefficient, scattering coefficient
# ** BFi: blood flow index
<measure> # the name of the quantity being measured in this channel, where applicable
# (depends on NIRS technology used), e.g.:
# ** Amplitude
# ** Phase (FD-NIRS)
# ** ACAmplitude (FD-NIRS)
# ** FluorescenceAmplitude
# ** FluorescencePhase (FD-NIRS)
<unit> # measurement unit for this channel, e.g.: lumens, micromolars, nanovolts
<source>* # unique identifier of the source; should match a <probe><label>
<detector>* # unique identifier of the detector; should match a <probe><label>
<wavelen>* # nominal (excitation) wavelength, in nanometers
# matches a <probe><wavelens><wavelen> if latter is specified
<wavelen_measured> # the actual (excitation) wavelength if measured, in nanometers
<fluorescence> # information related to fluorescence
<wavelen> # nominal fluorescence emission wavelength, in nanometers
# matches a <probe><fluorescence><wavelens><wavelen> if latter is specified
<wavelen_measured> # actual fluorescence emission wavelength, if measured, in nanometers
</fluorescence>
<illumination> # illumination pattern used, matches an <illumination><label> if latter is specified
<fd> # information specific to Frequency Domain (FD) NIRS
<frequency> # channel frequency, in Hz (FD-NIRS)
# matches a frequency in <probe><fd><frequencies> if latter is specified
</fd>
<td> # information specific to Time Domain (TD-Gated or TD-Moments) NIRS
<delay> # time delay, in picoseconds (for TD-Gated NIRS)
# matches a time delay in <probe><td><time_delays> if latter is specified
<width> # time delay bin width, in picoseconds (for TD-Gated NIRS)
# matches a bin width in <probe><td><time_delays> if latter is specified
<order> # moment order, as an integer representing an ordinal (for TD-Moments NIRS)
# matches an order moment in <probe><td><time_delays> if latter is specified
</td>
<dcs> # information specific to Diffuse Correlation Spectroscopy (DCS)
<delay> # time delay for DCS measurements, in picoseconds
# matches a time delay in <probe><dcs><time_delays> if latter is specified
<width> # time delay bin width for DCS measurements, in picoseconds
# matches a time delay in <probe><dcs><time_delays> if latter is specified
</dcs>
</channel>
</channels>
<probes> # per-probe meta-data
<probe> # description of a single probe, repeated for each probe/optode
<modality> # NIRS modality, e.g.:
# ** CW: Continuous Wave
# ** FD: Frequency Domain
# ** TD-G: Time Domain Gated
# ** TD-M: Time Domain Moments
# ** DCS: Diffuse Correlation Spectroscopy
# if unspecified, CW is assumed
<function>* # probe type based on its function:
# ** Source
# ** Detector
<label>* # source/detector label (e.g., a number)
# referenced in <channel><source> or <channel><detector>
<location>* # measured location, in the same coordinate system as the <fiducials> if specified
# may be repeated if both 3D and 2D positions are specified
# for 2D positions, the missing axis (<Z>) should be omitted
<X> # coordinate axis pointing from the center of the head to the right, in millimeters
<Y> # coordinate axis pointing from the center of the head to the front, in millimeters
<Z> # coordinate axis pointing from the center of the head to the top, in millimeters
</location>
<source> # information specific to source probes; can include vendor-specific child tags
<power> # power for a given probe, in milliwatts
</source>
<detector> # information specific to detector probes; can include vendor-specific child tags
<gain> # power gain of a given detector, in decibels
</detector>
<wavelens> # list of wavelengths transmitted for this probe
<wavelen> # wavelength in nanometers, repeated for each wavelength
</wavelens>
<fluorescence> # information related to fluorescence
<wavelens> # list of fluorescence emission wavelengths
<wavelen> # fluorescence emission wavelength, in nanometers; repeated for each wavelength
</wavelens>
</fluorescence>
<fd> # information specific to Frequency-Domain NIRS (FD-NIRS)
<frequencies> # list of modulation or detection frequencies
<frequency> # a frequency modulated or detected by this probe, in Hz
</frequencies>
</fd>
<td> # information specific to Time-Domain NIRS (TD-Gated NIRS or TD-Moments NIRS)
<time_delays> # holds time delays, widths and moment orders
<time_delay> # description of a single time delay, may be repeated
<delay> # a time delay, in picoseconds
<width> # a time bin width, in picoseconds
<order> # a moment order of the temporal point spread function; an integer (for TD-Moments)
</time_delay>
</time_delays>
</td>
<dcs> # information specific to Diffuse Correlation Spectroscopy (DCS)
<time_delays> # holds time delays, widths and moment orders
<time_delay> # description of a single time delay, may be repeated
<delay> # a time delay, in picoseconds
<width> # a time bin width, in picoseconds
</time_delay>
</time_delays>
</dcs>
<hardware> # references the name of a probe hardware defined in <hardwares>, if specified
<module> # references the name of a module/group defined in <modules>, if specified
</probe>
</probes>
<hardwares> # information about optode/probe hardware
<hardware> # describes one type of probe hardware;
# repeated for each type of source or detector hardware used on this device
# includes other vendor-specific tags as needed (e.g., spring type, light guide length)
<label> # unique name of the hardware; referenced in <probe><hardware>
<function> # the function of the probe:
# ** Source
# ** Detector
<manufacturer> # manufacturer of the probe
<model> # model of the probe
<type> # type of source or detector hardware, e.g.:
# for sources: Laser, LED
# for detectors: SiPD, APD
<surface> # type of the contact surface (e.g., Plate, Pins, Bristle, Pad, Dual-Tip, Multi-Tip)
<mount> # type of probe mount used (e.g., Spring-Loaded, Dock)
</hardware>
</hardwares>
<modules> # a list of modules/groups of probes
<module> # information describing a module/group of probes
# (may correspond to, e.g., docks, amplifiers, sensor bundles)
# may include other vendor-specific tags as needed
<label> # the name of the module
</module>
</modules>
<illuminations> # information about device illumination patterns
<illumination> # describes an illumination pattern; may be repeated
<label> # unique name of an illumination pattern (e.g., bilateral, a number, etc.)
<num_steps> # total number of steps (time bins) that a sample (illumination cycle) is divided into
<duration> # the duration of each step in the pattern, in microseconds
<pulse> # duration of source pulse or oscillation, in picoseconds,
# if different from the duration (e.g., for TD-NIRS)
<sources> # a list of sources firing simultaneously in this pattern
<source> # a source included in this pattern
<label> # the name of the source, should match a <probe><label>
<step> # the sequential step number when this source is fired, an integer (1-base)
</source>
</sources>
</illumination>
</illuminations>
<fiducials> # locations of fiducials/landmarks
<origin> # coordinate system used to define the origin for fiducials or probes, e.g.:
# ** MNI (assumed if unspecified), Talairach, CTF
<fiducial> # information about a single fiducial/landmark, repeated for each fiducial
<label> # name of the location, e.g.:
# ** Nasion, Inion
# ** Cz
# ** LPF, RPF
<location> # measured location, in same coordinate system as probe locations
# for 2D positions, the missing axis (<Z>) should be omitted
<X> # axis pointing from the center of the head (origin) to the right, in millimeters
<Y> # axis pointing from the center of the head (origin) to the front, in millimeters
<Z> # axis pointing from the center of the head (origin) to the top, in millimeters
</location>
</fiducial>
</fiducials>
<cap> # information about the NIRS cap
# may include additional vendor-specific tags describing the features of the cap
<manufacturer> # manufacturer of the cap
<name> # unique name/descriptor of the cap (e.g., serial number)
<size> # cap size as the head circumference, in centimeters (e.g., 54, 56, 58)
<label_scheme> # the labelling scheme used for montages (e.g., 10-20)
</cap>
<acquisition> # information about the signal acquisition device (amplifier/hub)
<manufacturer> # manufacturer of the amplifier
<model> # model of the amplifier
<serial> # serial number of the amplifier
<precision> # the theoretical number of bits of precision delivered by the amplifier
# (typical values are 8, 16, 24, 32)
<compensated_lag> # amount of hardware/system lag that has been implicitly compensated for
# in the stream's time stamps, in seconds
<settings> # vendor-specific settings of the amplifier
<setting> # a vendor-specific setting, may be repeated
<label> # name of the setting
<value> # value of the setting
</setting>
</settings>
</acquisition>