Skip to content

AnyWave databases (BIDS)

AnyWave can organise your recordings in a database: a regular BIDS dataset (Brain Imaging Data Structure) that AnyWave creates, fills and browses for you. Every subject has its own folder, every recording is converted to a BIDS file name the first time you add it, and everything you do afterwards (markers, montages, filters, processing results...) is kept next to the data, in a derivatives folder.

Because a database is nothing more than a BIDS dataset, you can also register a BIDS dataset that was made by another tool, and open an AnyWave database with any BIDS-aware software.

This section explains how to:

  1. create a database, register an existing one, and open it;
  2. add a subject;
  3. add EEG, iEEG (sEEG), MEG and anatomical (MRI/CT) data to a subject;
  4. browse the database and open a recording from the BIDS panel.

Quick start

  1. Edit > Preferences > AnyWave DB > Create Database... — choose a folder and a name.
  2. File > Open Database — the database opens in the BIDS panel on the right of the window.
  3. Database > Add Subject to Database... — give the subject a label (001, 002...).
  4. Database > Add File(s) to Subject... — choose the subject, the modality, the file(s), and click Import.
  5. Double-click the recording in the BIDS panel to open it.

Where to find the commands

Where What for
Edit > Preferences > AnyWave DB Create a database, register an existing one, unregister one.
File > Open Database Open one of your registered databases.
File > Open BIDS Open any BIDS folder, registered or not.
File > Recent BIDS directories Re-open a database you used recently.
Database menu Add subjects and data, plus a few tools that work on the whole database (see below).
BIDS panel (right-hand side) Browse subjects and runs, open a recording, add subjects or files, delete data.

The File menu

The Database menu

The Database menu also gives access to tools that work on a whole database. They are not described in this section:

Entry In short
Export Subjects... Copies the runs of one or more subjects of the open database into another registered database. Existing files are never overwritten.
Run a Process on Several Files... Runs a process (a plugin) on many recordings of a database in one go.
Build/Refresh Subject Index... Builds or refreshes a local index of a database, used to search it quickly.
Browse/Search Subject Index... Searches the index: which subjects have which data, filtered on the columns of participants.tsv.

What a database looks like on disk

This is the database built in the following pages, with two subjects:

MyDatabase/
├── dataset_description.json
├── participants.tsv
├── .anywave/                          AnyWave's own settings for this database (see below)
├── sub-001/
│   ├── anat/
│   │   ├── sub-001_run-01_T1w.nii
│   │   └── sub-001_run-01_T1w.json
│   ├── eeg/
│   │   ├── sub-001_task-rest_run-01_eeg.vhdr          (+ .eeg and .vmrk)
│   │   ├── sub-001_task-rest_run-01_eeg.json
│   │   ├── sub-001_task-rest_run-01_channels.tsv
│   │   └── sub-001_task-rest_run-01_events.tsv
│   └── meg/
│       ├── sub-001_task-rest_run-01_meg.fif
│       ├── sub-001_task-rest_run-01_meg.json
│       ├── sub-001_task-rest_run-01_channels.tsv
│       ├── sub-001_task-rest_run-01_coordsystem.json
│       └── sub-001_task-rest_run-01_events.tsv
├── sub-002/
│   └── ses-implant/
│       └── ieeg/
│           ├── sub-002_ses-implant_task-seizure_run-01_ieeg.vhdr   (+ .eeg and .vmrk)
│           ├── sub-002_ses-implant_task-seizure_run-01_ieeg.json
│           ├── sub-002_ses-implant_task-seizure_run-01_channels.tsv
│           ├── sub-002_ses-implant_task-seizure_run-01_events.tsv
│           └── ... run-02 ...
└── derivatives/
    └── anywave/
        ├── <your user name>/         markers (.mrk), filters (.flt), display settings (.display)...
        ├── common/                   markers, montages and bad channels shared by all users
        └── subject_index_v1.sqlite   the search index
  • participants.tsv lists the subjects (see Add a subject).
  • sub-<label>/[ses-<session>/]<modality>/ holds the recordings. The modality folders are anat, eeg, ieeg and meg.
  • derivatives/anywave/ is where AnyWave keeps everything that is not raw data. Each AnyWave user of the database gets their own folder there; the common folder is a copy that all users can share (see the BIDS panel). Results of the processes you run on a recording (ICA, spectral analysis...) are stored in derivatives as well.
  • .anywave/ contains a random value, specific to the database, used to hash patient identities. When you copy a database to another place, copy this folder too.

Note

AnyWave keeps the list of your registered databases in its own user settings, not inside the dataset. On another computer, register the database again (see Create, register or open a database).