Skip to content

Factual fixes: BIDS 1.11 (eye tracking, EMG), BEP032 status, NeuroBlueprint, EMBER grant - #8

Open
yarikoptic-gitmate wants to merge 1 commit into
mainfrom
con/factual-fixes
Open

yarikoptic-gitmate wants to merge 1 commit into
mainfrom
con/factual-fixes

Conversation

@yarikoptic-gitmate

Copy link
Copy Markdown
Collaborator

This is the first of several small PRs from CON (Yaroslav Halchenko's group). This one only corrects facts and wording; it adds no new arguments. The main fix: BIDS v1.11.0 (2026-02-04) added eye tracking (BEP020) and EMG (BEP042), but the draft still listed both as pending. I checked every BIDS statement against src/CHANGES.md and the schema rules at bids-specification d42dc87 (2026-10-14).

Changes

Where Change
Table 3, eye tracking (draft/12_figures_tables.md:119) BIDS "ext. (BEP020)" → "✓ (since BIDS 1.11)", with the note "BIDS support not yet in the BBQS guideline"
Table 3, EMG and gaps rows EMG now has its own row with BIDS ✓ (since 1.11). The NWB "—" is carried over unchanged from the old gaps row. The gaps row's BIDS "— / ext." becomes "—": the "ext." was added together with the BEP042 sentence, so it referred to EMG
§8 (draft/08_gaps_bridges.md) EMG has been in BIDS since 1.11 but is not yet in the guideline. Bridge 1 now says NWB inside BIDS is allowed for iEEG and proposed for microelectrode recordings (BEP032)
§6, §7 R2 The BIDS modality list adds EMG and eye tracking. BEP032 is not in any release, including v1.11.2, the latest. The text now reads: "BIDS already allows NWB files for iEEG, and … BEP032 would extend this to microelectrode recordings". In the schema, .nwb is accepted only under rules/files/raw/ieeg.yaml. R2: BEP032 "will make this easier once released"
§2 (draft/02_map.md:38-40) NeuroBlueprint comes from the Neuroinformatics Unit at the Sainsbury Wellcome Centre, not from an archive; adds a reference row
Funding, references EMBER is also funded by NIMH R24MH136632, as listed in the STAMPED paper's funding statement
§5, §7 opening Fixes a typo and splits one long sentence
plan/TODO.md C15, C24, C37; knowledge_graph/data/curated_edges.yaml:35 Status updated. The BIDS–NWB edge evidence no longer implies BEP032 is part of BIDS; this changes evidence text only, not the graph

Checks

  • make check reports 37 markers and 37 rows. Its only warning is about the gitignored knowledge_graph/output/stats.md, as on main.
  • The pandoc stage of make pdf succeeds. XeLaTeX was not available locally, so the Review PDF workflow on this PR is the first full PDF build.
  • Before opening this PR, three independent reviewers checked it: facts, consistency with CON's public positions, and the draft's editorial conventions. Their findings are already applied.

For you to decide (not changed here)

  • NWB cell for EMG in Table 3. It keeps "—" from the old gaps row. You may prefer "✓ (TimeSeries)", as for wearable sensors.
  • Intracellular ephys row. If BEP032 also covers intracellular recordings, its BIDS cell should read "ext. (BEP032)".
  • analysis/behavior_coverage.csv:11 and Fig. 4c. They still code eye movements in BIDS as "in progress", because the BBQS guideline cites BEP020. The coding follows the guideline, so the WG would update the guideline first.
  • EMBER's NIDA grant prefix. The draft has "2R24DA064430", while the RRID record SCR_026700 lists "R24DA064430". Worth a check on NIH RePORTER.

Generated by Claude Code

…EMBER grant

- BIDS v1.11.0 (2026-02-04) added eye tracking (BEP020) and EMG (BEP042).
  Update Section 6, Section 8, Table 3 (eye tracking and a separate EMG row;
  the gaps row loses EMG and its "ext."), and claims C24 and C37.
- BEP032 is in no released BIDS version (latest release v1.11.2): BIDS allows
  NWB only for iEEG today, and BEP032 "would extend this". Sections 6, 7, 8,
  claim C15, and the BIDS-NWB edge evidence in the knowledge graph.
- NeuroBlueprint comes from the SWC Neuroinformatics Unit, not an archive
  (Section 2); add a reference row.
- EMBER is also funded by NIMH R24MH136632 (Funding, references).
- Typo in Section 5; split a long sentence in the Section 7 opening.

Checked against bids-specification src/CHANGES.md at d42dc87 (2026-10-14).
Reviewed before submission by three independent reviewers (facts, CON
positions, editorial conventions).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012pUWrWppsBMJM2R3gxmUWg
@github-actions

Copy link
Copy Markdown

Review PDF for 8548dcb: paper.pdf · paper.tex (sign in to GitHub to download). Updated on each push.

@yarikoptic
yarikoptic self-requested a review October 17, 2026 02:53
Comment thread draft/08_gaps_bridges.md
Comment on lines +20 to +21
guidance. BIDS has supported EMG since version 1.11 [REF: BIDS v1.11], but the guideline does not
yet cover it [TODO-C24].

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.

@yarikoptic I think this is better addressed in the BBQS guideline document.

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.

Sure, but the point is that the bep is no longer in development and was released

https://bids-specification.readthedocs.io/en/stable/modality-specific-files/electromyography.html#emg-data

so we need to fix up the text on that

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.

Absolutely. Sorry for the confusion, I was just referring to but the guideline does not yet cover it part of the change.

| Raw behavioral video | ✓ (linked MP4 etc.) | ext. (proposals in progress) | ✓ (raw folder) | |
| Pose / motion tracking | ✓ (ndx-pose) | ✓ (Motion-BIDS) | tabular only | |
| Eye tracking | ✓ | ext. (BEP020) | tabular only | |
| Eye tracking | ✓ | ✓ (since BIDS 1.11) | tabular only | BIDS support not yet in the BBQS guideline |

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.

Same as above. I think this is best addressed by updating the Guideline.

| Structured tasks / events | ✓ (core events since NWB 2.10; ndx-structured-behavior) | ✓ (task events) | — | HED in both |
| Questionnaires / surveys | — | partial | ✓ (recommended) | |
| Social interactions, feeding, facial expressions, home-cage monitoring, VR, force plates, EMG | — | — / ext. | — | **Gaps** (Section 8) |
| EMG | — | ✓ (since BIDS 1.11) | — | Not yet in the BBQS guideline (Section 8) |

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.

Same as above. Best addressed in the Guideline.

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.

But it is already in bids so we need to fix text here too

@oruebel oruebel 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.

Did you also review figures/fig5_bbqs_stack. Based on the proposed changes here, I assume the box for BEP020 , BEP042 eye tracking, EMG should be removed and EMG and eye tracking added to the main BIDS box, correct? NWB also has pupil-tracking types so we may also want to add that to the NWB list to match. We can do those changes here or if you would like me to edit the figure, then please create an issue.

@oruebel

oruebel commented Oct 19, 2026

Copy link
Copy Markdown
Collaborator

@yarikoptic thanks for the proposed changes. Overall this looks good.

oruebel added a commit that referenced this pull request Nov 5, 2026
Fig. 5: linked SVG and svgtune walkthrough; BIDS 1.11 facts (#8), BEP044
@yarikoptic

Copy link
Copy Markdown
Collaborator

ok, as part of the fig5 metamorphosis we will include https://github.com/brain-bbqs/bbqs-standards as submodule here to get the figure but also to establish relationship between the two so we could progress them both forward harmoneously ;)

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.

4 participants