Skip to content

Commit

Permalink
Make Units.waveform_mean and Units.waveform_sd ragged (#576)
Browse files Browse the repository at this point in the history
  • Loading branch information
rly authored Apr 25, 2024
1 parent 942672b commit 3ad7aa3
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 5 deletions.
32 changes: 27 additions & 5 deletions core/nwb.misc.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -242,7 +242,13 @@ groups:
- - null
- null
- null
doc: Spike waveform mean for each spike unit.
doc: Spike waveform mean for each spike unit. The 'waveform_mean_index'
column indexes which waveforms in this column belong to a given unit, where each waveform
was recorded from a different electrode. The 'electrodes' column should be used to indicate which
electrodes are associated with each unit, and the order of the mean waveforms for a given unit
in the 'waveform_mean' dataset should be the same as the order of the electrodes referenced in
the 'electrodes' column of this table. The number of samples for each waveform mean must be the
same.
quantity: '?'
attributes:
- name: sampling_rate
Expand All @@ -254,6 +260,11 @@ groups:
value: volts
doc: Unit of measurement. This value is fixed to 'volts'.
required: false
- name: waveform_mean_index
neurodata_type_inc: VectorIndex
doc: Optional index into the 'waveform_mean' dataset to allow each unit to have a different number of mean
waveforms, one per electrode. See 'waveform_mean' for more details.
quantity: '?'
- name: waveform_sd
neurodata_type_inc: VectorData
dtype: float32
Expand All @@ -269,7 +280,13 @@ groups:
- - null
- null
- null
doc: Spike waveform standard deviation for each spike unit.
doc: Spike waveform standard deviation for each spike unit. The 'waveform_sd_index'
column indexes which waveforms in this column belong to a given unit, where each waveform
was recorded from a different electrode. The 'electrodes' column should be used to indicate which
electrodes are associated with each unit, and the order of the waveform standard deviations for a
given unit in the 'waveform_sd' dataset should be the same as the order of the electrodes referenced
in the 'electrodes' column of this table. The number of samples for each waveform standard deviation
must be the same.
quantity: '?'
attributes:
- name: sampling_rate
Expand All @@ -281,6 +298,11 @@ groups:
value: volts
doc: Unit of measurement. This value is fixed to 'volts'.
required: false
- name: waveform_sd_index
neurodata_type_inc: VectorIndex
doc: Optional index into the 'waveform_sd' dataset to allow each unit to have a different number of
waveform standard deviations, one per electrode. See 'waveform_sd' for more details.
quantity: '?'
- name: waveforms
neurodata_type_inc: VectorData
dtype: numeric
Expand All @@ -305,7 +327,7 @@ groups:
associated with a single waveform), then the 'waveforms_index' column will have values 1, 2, ..., N, where N is
the number of spike events. The number of electrodes for each spike event should be the same within a given unit.
The 'electrodes' column should be used to indicate which electrodes are associated with each unit, and the order
of the waveforms within a given unit x spike event should be in the same order as the electrodes referenced in
of the waveforms within a given unit x spike event should be the same as the order of the electrodes referenced in
the 'electrodes' column of this table. The number of samples for each waveform must be the same."
quantity: '?'
attributes:
Expand All @@ -320,10 +342,10 @@ groups:
required: false
- name: waveforms_index
neurodata_type_inc: VectorIndex
doc: Index into the waveforms dataset. One value for every spike event. See 'waveforms' for more detail.
doc: Index into the 'waveforms' dataset. One value for every spike event. See 'waveforms' for more detail.
quantity: '?'
- name: waveforms_index_index
neurodata_type_inc: VectorIndex
doc: Index into the waveforms_index dataset. One value for every unit (row in the table). See 'waveforms' for more
doc: Index into the 'waveforms_index' dataset. One value for every unit (row in the table). See 'waveforms' for more
detail.
quantity: '?'
5 changes: 5 additions & 0 deletions docs/format/source/format_release_notes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,11 @@ Release Notes
Minor changes
^^^^^^^^^^^^^
- Added support to set boundary metadata for ``SpatialSeries``. (#524)
- Added columns ``waveform_mean_index`` and ``waveform_sd_index`` to ``Units`` to make the ``waveform_mean`` and
``waveform_sd`` columns ragged. This allows for a different number of waveform means/SDs per unit which is useful
when each unit is associated with a different number of electrodes and there is a waveform mean/SD for each
electrode and unit. (#576)


2.7.0 (February 7, 2024)
------------------------
Expand Down

0 comments on commit 3ad7aa3

Please sign in to comment.