bids_event.h File Reference

Reader/writer for the BIDS _events.tsv sidecar — discrete annotations on the time axis of a recording. More...

#include "bids_global.h"
#include <QString>
#include <QList>

Include dependency graph for bids_event.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	BIDSLIB::BidsEvent
	Single event annotation, typically parsed from or written to *_events.tsv. More...

Namespaces
namespace	BIDSLIB
	BIDS dataset reading, writing, path construction, and sidecar metadata handling for iEEG/EEG/MEG.

Detailed Description

Reader/writer for the BIDS _events.tsv sidecar — discrete annotations on the time axis of a recording.

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2026 MNE-CPP Authors

Author

Christoph Dinh chris.nosp@m.toph.nosp@m..dinh.nosp@m.@mne.nosp@m.-cpp..nosp@m.org

Since

2.1.0

Date

March 2026

BIDS events live in a _events.tsv sibling of every electrophysiology or functional acquisition with REQUIRED columns onset and duration (seconds) and a recommended trial_type label; mne-cpp additionally tracks the original 0-based sample index and the numeric trigger value so the record can round-trip back into FIFF stim-channel land without re-deriving them. BidsEvent is the per-row value object and the static BidsEvent::readTsv / BidsEvent::writeTsv functions perform the TSV round-trip via BidsTsv. Missing / n/a fields default to zero / empty so partially-populated event files still round-trip.

Spec: https://bids-specification.readthedocs.io/en/stable/modality-agnostic-files.html#tasks

Definition in file bids_event.h.