Skip to content

Marker files, import and BIDS

Where your markers are kept

You never have to save your markers: every change (adding, editing, removing, loading) is written at once, in a .mrk file stored next to the recording. It has the name of the recording followed by .mrk:

D:\Data\subject01\
├── eeg_marking.vhdr
├── eeg_marking.eeg
├── eeg_marking.vmrk
└── eeg_marking.vhdr.mrk      your markers

When you open the recording again, the markers are read from this file. The recording itself, and the markers it carries (here the .vmrk file), are never modified. The format of the file is a simple text format, so you can open it in any text editor.

Note

The same folder holds the other files AnyWave writes for a recording: the montage (.mtg), the bad channels (.bad), the filters (.flt) and the display settings (.display).

Load a marker file

To add the markers of a .mrk file to the recording (made by a colleague, by a script, or from another recording), click Load markers in the marker list, or choose File > Import marker file.

The question asked before loading a marker file

AnyWave first asks what to do with the markers you already have:

  • Import replaces them: all the current markers are removed, and only the ones of the file remain.
  • Append keeps them and adds the ones of the file.
  • Cancel stops here.

Then you pick the .mrk file. If it holds no marker that AnyWave can read, you get the message The marker file is empty or invalid, and nothing changes (see the rules of the format if the file should have worked). If some of the markers of the file were already in the recording, AnyWave removes the duplicates and tells you how many.

Save markers to a file

  • Save markers (under the list) writes all the markers to the .mrk file you choose. Use it to keep a copy, or to give your markers to someone.
  • To save only some of them, select their rows in the list, right-click and choose Export > Save markers to .mrk file.

Markers in a BIDS database

When a recording is opened from a BIDS database, your markers are kept in your own folder of the database, with the montage and the other settings:

derivatives/anywave/<your user name>/sub-003/eeg/sub-003_task-rest_run-01_eeg.vhdr.mrk

Each user has a folder of their own: your markers never overwrite a colleague's.

First opening

The first time you open a recording, the events of its events.tsv become your markers. From then on, your .mrk file is the one that is read, and events.tsv is not read again: the events do not pile up.

Share markers with the other users

Push to common and Pull from common (under the marker list, enabled while a recording of a database is open) share markers between the users of the database. The shared copy is in derivatives/anywave/common/.

  • Push to common asks Send current markers to the common file? and merges your markers into the common ones, removing the duplicates.
  • Pull from common asks Get common markers and merge them? and merges the common markers into yours, removing the duplicates.

The same commands are in the context menu of a recording in the BIDS panel.

Adding a recording to a database

When you add a recording to a database, AnyWave keeps a copy of all the markers it found for it (the ones of the recording and the ones of its .mrk file) as <recording>_original.mrk in your derivatives folder.

Markers and processes

Processes can read the markers (for instance to work on every Spike-wave) and send new ones: a detector adds the markers it found to your list. You launch a process on some markers from the context menu of the marker list (Launch process). The plugins written in MATLAB or Python get and send markers with the same data: label, value, position, duration, color and targets.