Skip to content

Add an optional string field /nirs(i)/data(j)/name#178

Open
emiddell wants to merge 2 commits into
masterfrom
add_data_name_field
Open

Add an optional string field /nirs(i)/data(j)/name#178
emiddell wants to merge 2 commits into
masterfrom
add_data_name_field

Conversation

@emiddell

@emiddell emiddell commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

This PR contains the changes proposed in #177 .

@samuelpowell samuelpowell left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds an optional /nirs(i)/data(j)/name string field to the SNIRF specification to allow distinguishing multiple data(j) time series within a single /nirs(i) group when measurement-list metadata alone is insufficient (per #177).

Changes:

  • Document /nirs(i)/data(j)/name as an optional, free-form string field in the SNIRF specification and add it to the table of contents.
  • Add an “in development” changelog entry noting the new name field.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
snirf_specification.md Adds the new optional data(j)/name dataset definition and links it from the TOC.
CHANGELOG.md Records the new field addition under the in-development section.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread snirf_specification.md
* **Type**: string
* **Location**: `/nirs(i)/data(j)/name`

This is an optional, free-form string describing the j<sup>th</sup> data time course. One use of this parameter is to distinguish processed time courses which are indistinguishable by `measurementList(k).dataType`, `measurementList(k).dataTypeLabel` and `measurementList(k).dataTypeIndex` (like for example changes in optical density which were filtered by different artifact-rejection methods).
Comment thread CHANGELOG.md
Comment on lines +5 to +7
### In development
* Add `nirs(i)/data(j)/measurementLists` as an alternative to the indexed-Group measurementList `nirs(i)/data(j)/measurementList(k)`.
* Add `nirs(i)/data(j)/name` as an optional, free-form string field to label time series (#177)
Comment thread CHANGELOG.md
### `2.0` In development
### In development
* Add `nirs(i)/data(j)/measurementLists` as an alternative to the indexed-Group measurementList `nirs(i)/data(j)/measurementList(k)`.
* Add `nirs(i)/data(j)/name` as an optional, free-form string field to label time series (#177)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants