Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[ENH] microelectrode electrophysiology specification (BEP032) #1705

Open
wants to merge 21 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
7ec5d5e
Add first BEP032 objects
JuliaSprenger Nov 9, 2022
2f393ca
Add ephys modality, start adding _channels but ran into a question on…
yarikoptic Feb 14, 2024
648781a
Add _acq- to ephys, add _channels and _coords
yarikoptic Mar 6, 2024
d3c9996
Draft for probes TSV file
TheChymera Mar 6, 2024
08c92cd
Fix preferably typo
yarikoptic Mar 15, 2024
e2030ac
Comment out not yet defined iephys and add ephys to datatypes where i…
TheChymera Apr 17, 2024
53f1087
Added probes file
TheChymera Apr 17, 2024
fa648fe
Describe modality/datatype as "Microelectrode Electrophysiology"
yarikoptic Apr 18, 2024
eef67df
Remove iephys entirely since I think it was just inspired by DANDI la…
yarikoptic Apr 18, 2024
27547f9
Initial content for ephys document and initial filename template tree
yarikoptic Apr 18, 2024
a6ae5e2
Merge remote-tracking branch 'upstream/master' into bep032
Remi-Gau Apr 19, 2024
9a20e4b
pacify pre-commit
Remi-Gau Apr 19, 2024
7609276
add to TOC
Remi-Gau Apr 19, 2024
9be41f9
semantic line break and fix
Remi-Gau Apr 19, 2024
983975a
Addressed minor left over lint complains
yarikoptic Apr 19, 2024
1afdc40
Add "Microelectrode" specialization for Electrophysiology in the cont…
yarikoptic Apr 19, 2024
6b39d64
Fix up for bad latin and adjust wording a bit
yarikoptic Apr 19, 2024
f08b163
Replace fancy unicode “ with simple " .
yarikoptic Apr 19, 2024
73012b3
Use redirected to www.datalad.org and www.nwb.org website URLs and fe…
yarikoptic Apr 19, 2024
a46e439
BEP032: ephys -> microephys with {icephys, ecephys} modalities/suffix…
yarikoptic Jun 5, 2024
05e9611
Clarify wording and do mention `microephys` as shorthand for Microele…
yarikoptic Oct 16, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions src/schema/objects/entities.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -331,12 +331,12 @@ split:
display_name: Split
description: |
In the case of long data recordings that exceed a file size of 2Gb,
`.fif` files are conventionally split into multiple parts.
Each of these files has an internal pointer to the next file.
`.fif`, `.nwb`, `.nix` files are conventionally split into multiple parts.
Each of the `.fif` files has an internal pointer to the next file.
This is important when renaming these split recordings to the BIDS convention.

Instead of a simple renaming, files should be read in and saved under their
new names with dedicated tools like [MNE-Python](https://mne.tools/),
new names with dedicated tools like [MNE-Python](https://mne.tools/) for `.fif`,
which will ensure that not only the filenames, but also the internal file pointers, will be updated.

It is RECOMMENDED that `.fif` files with multiple parts use the `split-<index>` entity to indicate each part.
Expand Down
5 changes: 5 additions & 0 deletions src/schema/objects/extensions.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -189,6 +189,11 @@ niigz:
display_name: Compressed NIfTI
description: |
A compressed Neuroimaging Informatics Technology Initiative (NIfTI) data file.
nix:
value: .nix
display_name: Neuroscience Information Exchange Format
description: |
A [Neuroscience Information Exchange](https://nixio.readthedocs.io) file.
nwb:
value: .nwb
display_name: Neurodata Without Borders Format
Expand Down
3 changes: 3 additions & 0 deletions src/schema/objects/modalities.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -35,3 +35,6 @@ motion:
nirs:
display_name: Near-Infrared Spectroscopy
description: Data acquired with NIRS.
ephys:
display_name: Electrophysiology
yarikoptic marked this conversation as resolved.
Show resolved Hide resolved
description: Data acquired using microelectrodes.
10 changes: 10 additions & 0 deletions src/schema/objects/suffixes.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -571,6 +571,11 @@ electrodes:
display_name: Electrodes
description: |
File that gives the location of (i)EEG electrodes.
ephys:
value: ephys
display_name: Electrophysiology
yarikoptic marked this conversation as resolved.
Show resolved Hide resolved
description: |
Extra- or intracellular microelectrode recording data.
epi:
value: epi
display_name: EPI
Expand Down Expand Up @@ -727,6 +732,11 @@ physio:
display_name: Physiological recording
description: |
Physiological recordings such as cardiac and respiratory signals.
probe:
value: probe
display_name: A recording probe
description: |
A probe with one or more recording contacts.
probseg:
value: probseg
display_name: Probabilistic Segmentation
Expand Down
10 changes: 10 additions & 0 deletions src/schema/rules/files/raw/channels.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,16 @@ channels:
acquisition: optional
run: optional

# ephys has one removed
# TODO: see if to be added for consistency etc.
channels__ephys:
$ref: rules.files.raw.channels.channels
datatypes:
- meg
entities:
$ref: rules.files.raw.channels.channels.entities
acquisition:

yarikoptic marked this conversation as resolved.
Show resolved Hide resolved
# MEG has an additional entity available
channels__meg:
$ref: rules.files.raw.channels.channels
Expand Down
18 changes: 18 additions & 0 deletions src/schema/rules/files/raw/ephys.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
ephys:
suffixes:
- ephys
extensions:
- .nwb
# possible future: serialization in .zarr format to accompany .ome.zarr
# - .nwb.zarr
- .nix
datatypes:
- ephys
entities:
subject: required
session: optional
sample: optional
task: optional
run: optional
split: optional
yarikoptic marked this conversation as resolved.
Show resolved Hide resolved
Loading