diff --git a/src/modality-specific-files/physiological-recordings.md b/src/modality-specific-files/physiological-recordings.md index 4bc864c42d..262f65146f 100644 --- a/src/modality-specific-files/physiological-recordings.md +++ b/src/modality-specific-files/physiological-recordings.md @@ -9,39 +9,147 @@ - [`7t_trt`](https://github.com/bids-standard/bids-examples/tree/master/7t_trt) - [`ds210`](https://github.com/bids-standard/bids-examples/tree/master/ds210) + +!!! warning " 'Unprocessed/Processed physiological data' vs 'Raw/Derivatives BIDS data'" + + Physiological monitoring is now advanced enough to offer a plethora of different data modalities, + some of which are directly measured unprocessed data, and some of which are processed metrics computed using direct recordings. + To complicate the matter, certain devices allow analog signal processing operations. + + Examples of unprocessed physiological fluctuations include respiration, cardiac pulse, or eye-tracking, while examples of processed data are heart rate or pulse rate. + Some modalities could be both, e.g. blood pressure measured directly (unprocessed) vs derived from PPG signals (processed). + + In this specification, any data retrieved directly from a device is considered a raw signal, even if analogical signal processing is performed onto it, or it is the result of an algorithmic estimation. + Any data computed offline is considered derivative, and should follow derivatives specifications. + + + +The rest of this specification is organized as follows: +1. General specifications for physiological recordings, including the organization of multiple physiological recordings and the handling of physiological recordings stored alongside concurrent modalities. +2. [Continuous physiological recordings](#continuous-physiological-recordings), including [events corresponding to physiological recordings](#physiology-events). +3. [Specific physiological signal types](#specific-physiological-signal-types), such as [eye-tracking](#eye-tracking). + +This specification section covers three types of physiological recordings: +- [continuous](#continuous-physiological-recordings): regularly sampled over time at a fixed frequency; +- semi-continuous: irregularly sampled, either with variable sampling frequency or in bursts of fixed sampling frequency; +- asynchronous physiological events: sparse recordings, such as labels or events. + ## General specifications -Continuous (that is, regularly sampled over time at a fixed frequency) -physiological recordings such as cardiac and respiratory signals, and -asynchronous events corresponding to those signals MAY be specified using -[compressed tabular files](../common-principles.md#compressed-tabular-files) -([TSV.GZ file](../glossary.md#tsvgz-extensions)). -TSV.GZ files MUST be accompanied by a JSON file with the same name as their -corresponding tabular file but with a `.json` extension. +When recording physiological data, we RECOMMEND to always record and +save the data with the least amount of (online) processing possible applied to it, would that be analogical or digital. +If metrics based on directly measured physiological fluctuations are computed +in real time and stored by recording devices, we RECOMMEND to specify +the nature of this metrics and to _also_ store the original physiological fluctuations when possible. -{{ MACROS___make_filename_template( - "raw", - placeholders=True, - show_entities=["recording"], - suffixes=["physio", "physioevents"] - ) -}} +All physiological signals MAY be stored in their own data type folder `physio`, in which case they MUST follow the specifications reported below in [Enriched physiological data](###enriched-physiological-data). For backward compatibility, physiological signals recorded concurrently with other modalities (e.g. MRI, EEG, behavioural data, ...) MAY be stored either in their own data type folder, following the same specifications as independent data, or in the same data type folder as their concurrent modality data, in which case they MAY follow either generic or enriched specifications. -The [`recording-