Skip to content

Commit 5946059

Browse files
Address PR review: abbreviations, API key, counts
Define HBN on first use; keep common neuro abbreviations (EEG/EMG/MEG/fMRI) as-is per review; add the 10.82901/NEMAR DOI prefix; fix 'token cached' -> 'API key cached'; correct mock report to 'Errors fixed: 2'; resync bundle week-09.json. Bundle deck re-validates 0/0.
1 parent 6a44344 commit 5946059

4 files changed

Lines changed: 7 additions & 7 deletions

File tree

courses/agentic-research/week-09.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Overview
44

5-
A finished analysis is not a finished contribution. The data behind it has to be reproducible, shareable, and citable, or the work dies with the paper. Two standards carry the weight: the Brain Imaging Data Structure (BIDS) answers where everything lives (structure), and Hierarchical Event Descriptors (HED) answer what every event meant (semantics). The single most useful idea this week: the bar for a complete annotation is concrete and falsifiable. **A language model should be able to reconstruct the stimulus, or the experiment, from the annotation alone.** That is not a metaphor; it is exactly the test demonstrated in the HBN-EEG paper (Shirazi et al., 2024, Figure 9), where Claude Sonnet 3.5 regenerated the Surround Suppression stimulus from its HED description with no image.
5+
A finished analysis is not a finished contribution. The data behind it has to be reproducible, shareable, and citable, or the work dies with the paper. Two standards carry the weight: the Brain Imaging Data Structure (BIDS) answers where everything lives (structure), and Hierarchical Event Descriptors (HED) answer what every event meant (semantics). The single most useful idea this week: the bar for a complete annotation is concrete and falsifiable. **A language model should be able to reconstruct the stimulus, or the experiment, from the annotation alone.** That is not a metaphor; it is exactly the test demonstrated in the Healthy Brain Network EEG (HBN-EEG) paper (Shirazi et al., 2024, Figure 9), where Claude Sonnet 3.5 regenerated the Surround Suppression stimulus from its HED description with no image.
66

77
The dataset throughout is HBN-EEG, the very data the course has analyzed since Week 3. It is itself a BIDS + HED dataset published on both OpenNeuro and NEMAR with exactly the tools this session teaches: the loop closes, the data you analyzed is the worked example for how to share data.
88

@@ -154,7 +154,7 @@ The agent runs the BIDS validator, categorizes findings, applies fixes with conf
154154
```text
155155
## BIDS Validation Report
156156
Subjects: 12 Modalities: eeg
157-
Errors fixed: 3
157+
Errors fixed: 2
158158
[FIXED] missing dataset_description.json
159159
[FIXED] _eeg.json missing PowerLineFrequency -> 60
160160
Remaining warnings: 2
@@ -184,7 +184,7 @@ nemar dataset validate ./my-dataset
184184
The full path, and the collaboration model:
185185

186186
```bash
187-
nemar auth login # one-time, token cached
187+
nemar auth login # one-time, API key cached
188188
nemar dataset validate ./my-dataset # BIDS check, must pass
189189
nemar dataset upload ./my-dataset # creates a private GitHub repo
190190
nemar dataset publish request nm000XXX # admin approves -> public + DOI
@@ -196,7 +196,7 @@ nemar dataset publish request nm000XXX # admin approves -> public + DOI
196196

197197
![DOI minting and ORCID auto-linking: authors to ORCID iDs to DataCite DOI to each author's ORCID record](../../slides/agentic-research/week-09/assets/icons/doi-orcid.svg){ .figure-diagram }
198198

199-
On publish, `nemar-cli` mints a **concept DOI** (one stable citation across all versions) plus per-version DOIs, via EZID writing DataCite kernel-4 metadata, and **auto-links every author's ORCID iD**. The dataset then appears on each author's ORCID record automatically. OpenNeuro does not link authors to ORCID on the DOI yet.
199+
On publish, `nemar-cli` mints a **concept DOI** (one stable citation across all versions) plus per-version DOIs, via EZID writing DataCite kernel-4 metadata (the DOIs carry the `10.82901/NEMAR.<id>` prefix), and **auto-links every author's ORCID iD**. The dataset then appears on each author's ORCID record automatically. OpenNeuro does not link authors to ORCID on the DOI yet.
200200

201201
### 13. The Metadata Gap: Proof on a Real Dataset
202202

courses/slides/agentic-research/week-09/assets/icons/bids-validator-agent.svg

Lines changed: 1 addition & 1 deletion
Loading

courses/slides/agentic-research/week-09/assets/icons/nemar-upload-publish.svg

Lines changed: 1 addition & 1 deletion
Loading

courses/slides/agentic-research/week-09/week-09.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -287,7 +287,7 @@
287287
{
288288
"type": "callout",
289289
"calloutType": "important",
290-
"content": "HBN-EEG, Figure 9: Claude redrew the Surround Suppression stimulus from the **HED annotation alone.** If a model can rebuild your stimulus from the annotation, it is complete; if it can't, you left something out. *(Shirazi et al., 2024)*",
290+
"content": "HBN-EEG (Healthy Brain Network EEG), Figure 9: Claude redrew the Surround Suppression stimulus from the **HED annotation alone.** If a model can rebuild your stimulus from the annotation, it is complete; if it can't, you left something out. *(Shirazi et al., 2024)*",
291291
"animation": { "fragment": true, "type": "slide-up", "index": 0 },
292292
"position": { "area": "footer" }
293293
}

0 commit comments

Comments
 (0)