Templates and Transfer Pack: Neuroscience Roadmap Forms
EEG module 03Templates Roadmap
Companion to the neuroscience roadmap

Templates and Transfer Pack

Use
Copy from it while working
Contents
Eleven templates plus the fixed transfer pack
Reading order
None. Nothing here is read cover to cover

Every form the roadmap and the EEG module send you to. The transfer pack at §11.11 holds fixed objects rather than descriptions of objects: do not rehearse them during instruction, and open a key only for the block you are testing.

11.1 PROGRESS.md

The file that makes re-entry after a gap possible. Update it at the end of every session, in under two minutes.

# Current state
Block: [N] [title]
Mode: Normal / Compressed / Paused / Re-entry
Slot: [which of 15]
Blocks remaining: [N] | Slots remaining: [N]

## Open right now
- [the single next action, specific enough to start cold]

## Last command that worked
[paste it]

## Blocked on
- [thing] waiting since [date] chase on [date]

## Done-when test for this block
[copy it here so it stays visible]

---
# Session log
## YYYY-MM-DD
Did:
Learned:
Next:
11.2 Maps and audits

Field map row · FIELD-MAP.md · target 20+ rows by Block 4

| Phenomenon | Level | Lens | Measurement | Design | Supported inference | Unsupported claim | Interest (H/M/L) + why |

People and access row · PEOPLE-ACCESS.md · 8 to 12 rows in Block 1

Name / group:
Institution and location:
Why the match is real (specific, not "does neuroscience"):
One recent work (title, year, one-line summary):
Bounded help I might later ask for:
Contact route:
Status: mapped / contacted [date] / replied [date] / declined / active
Notes:

Measurement matrix row · MEASUREMENT-MATRIX.md · Block 4

| Modality | What is physically measured | Spatial scale | Temporal scale | Invasiveness | Supports | Cannot support | Main artefact or confound |

Figure audit · FIGURE-AUDIT-N.md

Paper / figure:
1. Question the figure addresses:
2. Preparation and subjects (species, N, nesting):
3. Task or stimulus:
4. What was measured, in physical units:
5. Aggregation (across what, how):
6. What the figure directly shows:
7. One inference it supports:
8. One causal or generalisation claim it does NOT support:
9. What would change your reading:
11.3 Progressive question card

Three stages. Only promote what survives. Killing is progress.

# Q-[ID] status: curiosity / triaged / audit candidate / killed / parked / selected

## Stage 1 curiosity
Observation or problem:
Where it came from:
Level and domain:
Why it might matter:
What I already know:
What answering it would teach me:

## Stage 2 triage (only if promoted)
Likely population and setting:
Likely data source and its access reality:
Who benefits, or what understanding changes:
Obvious barrier (access / ethics / compute / supervision / time):
Cost of the missing learning:
Smallest test that could kill this:
Fatal risk:

## Stage 3 audit finalist (only if promoted)
Precise estimand:
Comparator:
Primary metric:
Five closest works:
One-sentence differentiator:
Independent-unit count available:
Full feasibility screen: PASS / FAIL by row
Intended-use statement: [link]
Learning contract: [link]

## If killed
Date and reason:
11.4 Dated overlap memo
# Overlap memo [question] [date]

## Question, one sentence

## Searches run
| Source | Query | Date | Records | Relevant |
|---|---|---|---|---|
| PubMed | | | | |
| IEEE Xplore | | | | |
| Scopus / WoS | | | | |
| medRxiv / bioRxiv / arXiv | | | | |
| Scholar forward citations from [anchor paper] | | | | |
| PROSPERO / OSF | | | | |
| Conference proceedings | | | | |
| Benchmark leaderboard | | | | |

## The five closest works
| Work | What it did | Data | What it did not do |
|---|---|---|---|

## Differentiator, one sentence

## Verdict
Material contribution / occupied / needs reshaping

## Refresh log
| Date | Trigger | Anything new | Effect |
|---|---|---|---|

Refresh before protocol lock and before any release decision.

11.5 Data and annotation card

One per dataset, before analysis.

# Data card [corpus] [version/release]

Source URL and access date:
Version or release identifier (exact):
Licence and permitted use:
Access route (open / registration / signed agreement / credentialed):

## Contents
Subjects (unique, not files):
Recordings:
Sampling rate:
Channels: are these electrodes or derivations? Any duplicated or reversed?
Reference:
Duration, total and per recording:

## Independence
Unit of independence:
Nesting structure:
True independent N for my estimand:

## Annotations
Who annotated:
Against what definition:
Annotation unit (event / window / record):
Agreement checking reported? What did it show?

## Known limitations

## Integrity
Hash where licence permits:
Local path and retrieval date:
11.6 Learning contract and pilot record
# Learning contract [project] [date]

One scientific concept to deepen:
  Resource: | Exercise: | Demonstrated by:
One method to learn:
  Resource: | Exercise: | Demonstrated by:
One implementation skill:
  Resource: | Exercise: | Demonstrated by:
One thing explicitly OUT of scope:

Prediction before applying the method:
What actually happened:

# Pilot decision [date]
Data used: DEVELOPMENT ONLY confirm: yes / no
Fraction piloted:
Runtime and storage feasible?
Annotation conversion visually correct on sampled events?
Comparator runs?

## Results already seen (must be disclosed at Gate B)
-

Decision: proceed / reshape / stop
11.7 EEG description form and comparison card

Description form. Use it every time, including on normal recordings. The sequence it follows is section 4 of the EEG module.

# EEG description [record ID] [date]

Technical adequacy:
State (awake / drowsy / asleep / mixed):
Posterior dominant rhythm: frequency | amplitude | symmetry | reactivity
Organisation and continuity:
Symmetry:
State changes observed:
Artefacts (type, channels, likely source):

## Findings, DESCRIBED not named
| Location | Morphology | Frequency | Persistence | Evolution? | After-going slow wave? | Background disruption? |

Uncertainty and what would resolve it:
Requires expert review? yes / no why:

NO DIAGNOSIS. NO CLINICAL RECOMMENDATION.

Matched comparison card · EEG §6

# [Variant] vs [its closest mimic]

| Field | Variant | Mimic |
|---|---|---|
| Age group | | |
| State | | |
| Topography | | |
| Laterality | | |
| Morphology | | |
| Frequency | | |
| Amplitude | | |
| Duration / rhythmicity | | |
| Evolution | | |
| After-going slow wave | | |
| Background disruption | | |
| Closest confusion | | |
| **Decisive discriminator** | | |

Source and page/figure for every row:
11.8 Mentor and reviewer message
Subject: [specific thing] [your role], Ain Shams

Dear Dr [name],

I am a medical graduate at Ain Shams University working through a
structured programme in neuroscience and computational methods.

I read [exact paper, year]. [One specific, accurate sentence showing
you actually read it, ideally about a method or a limitation.]

I have attached [ONE artifact: figure audit, protocol, or analysis].

My question: [ONE answerable question, not "can you supervise me".]

If this is not a good use of your time, I completely understand.

[Name] | ORCID | [repo link if relevant]

Rules. One artifact. One question. A real bounded ask. Never mass mail. Log the send date and chase once after two weeks, then stop.

11.9 Gate record
# Gate [Interest / A / B / C / Publication Release] [date]

## Evidence presented
-

## Criteria
| Criterion | Met? | Evidence |
|---|---|---|

## Decision

## Reasoning

## What I am giving up by deciding this

## External input
Who: | When: | What they said: | Peer feedback or expert review?

## If this gate did not pass
Route taken:
11.10 Substitution memo

When a resource, dataset, or programme changes, or a mentor-led opportunity replaces planned work.

# Substitution [date]

What was planned:
What changed, and how I know:
Replacement:
Does it serve the same learning job? How:
What is lost:
Blocks affected:
Calendar effect: none / uses a floating slot / moves the target date

Never silently swap a dataset. Always record the version actually used.

11.11 The fixed transfer pack
How to use the pack

These are fixed objects, not descriptions of objects. Do not rehearse them during instruction. At the completion test: copy the prompt into a dated file, commit your first answer, then open the key and correct yourself in a second section. The point is transfer and correction, not a surprise exam.

Attempt log · tick when your answer is committed to a dated file

A  Block 1 caption transfer

Six mice performed a visual-discrimination task while two-photon calcium imaging recorded GCaMP fluorescence from neurons in primary visual cortex. One panel shows trial-averaged ΔF/F for each recorded neuron at two stimulus contrasts. A second shows each mouse's accuracy during control trials and during optogenetic inhibition of the recorded region.

State: the levels involved, the directly recorded quantity, the observation hierarchy, the main comparisons, one supported inference, and one inference this cannot establish.

B  Block 2 table and montage transfer

Table. Use sklearn.datasets.load_wine(as_frame=True), which appears nowhere in the lessons. Without copying a solution: inspect dimensions, types, and missingness; produce one grouped summary and one labelled plot tied to a stated question; write three limits. It is a coding object, not a neuroscience study.

Montage. Instantaneous potentials relative to the same arbitrary acquisition reference: Fp1 = +20 µV, F7 = -30 µV, T7 = -10 µV. These are not absolute scalp potentials.

  1. Compute Fp1-F7 and F7-T7. Then predict both changes if only F7 becomes 10 µV more negative.
  2. Compute what happens to Fp1-A1, F7-A1, and Fp1-F7 if only the common A1 reference becomes 15 µV more positive.
  3. State why the up or down direction on screen still requires knowing the display convention.

C  Block 3 estimate and measurement transfer

Load sklearn.datasets.load_linnerud(as_frame=True). Before plotting, choose one exercise-physiology pair, state the row and sampling assumption, fit the same regression family you learned, bootstrap paired rows, and explain why the interval and the association establish neither causation nor population generality.

Then: you want to know whether cue-period activity carries information about a mouse's later left or right choice. Choose one measurement among single-unit spikes, simultaneous population spikes, LFP or EEG-like field activity, or behaviour. State the preparation, primary observable, unit hierarchy, analysis target, and the strongest conclusion it still cannot support.

Withheld-unit check. Reuse your unchanged raster and ISI functions on the seeded unit reserved in Block 3.

D  Block 4 leakage and measurement transfer

The fixed dataset. Build it exactly like this so your three numbers are comparable to anyone else's.

import numpy as np, pandas as pd
rng = np.random.default_rng(20260731)
n_patients, n_windows = 30, 40
patient_effect = rng.normal(0, 2.0, n_patients)      # strong per-patient signature
y_patient = rng.integers(0, 2, n_patients)           # label is a PATIENT property
rows = []
for p in range(n_patients):
    for _ in range(n_windows):
        x = rng.normal(patient_effect[p], 1.0, 20)   # 20 features
        x[0] += 0.3 * y_patient[p]                   # weak true signal
        rows.append(dict(patient_id=p, y=y_patient[p],
                         **{f"f{i}": v for i, v in enumerate(x)}))
df = pd.DataFrame(rows)

The label is a property of the patient, and each patient has a strong signature. So a row-wise split lets the model recognise the person and recover the label without learning anything generalisable.

Baseline model: LogisticRegression(max_iter=1000). Report ROC AUC for all three designs:

  1. train_test_split(..., test_size=0.2, random_state=7) with SelectKBest(k=10) and StandardScaler fitted on all data first.
  2. GroupKFold(n_splits=5) grouped on patient_id, transforms still fitted outside the folds.
  3. GroupKFold with SelectKBest and StandardScaler inside a Pipeline, fitted within each training fold only.

Write down all three numbers and explain, in two sentences, which mechanism caused each drop.

Then audit this intentionally broken pipeline:

# X has 40 windows per patient; patient_id repeats across rows
X = SelectKBest(k=20).fit_transform(X, y)
X = StandardScaler().fit_transform(X)
X_train, X_test, y_train, y_test = train_test_split(
    X, y, test_size=0.2, random_state=7
)
model.fit(X_train, y_train)

Name every leakage and non-independence route, then rewrite the design using patient groups, a pipeline fitted inside training data, and a final-evaluation design appropriate to the estimand.

Then, for each of these two questions, choose the needed manipulation and measurement combination, the independence hierarchy, the supported claim, and one unresolved mechanistic or clinical-utility claim:

  1. Does acute V1 silencing change visual-discrimination behaviour within the same animals?
  2. Can resting scalp EEG predict six-month seizure recurrence in new patients?

Keys are split by block. Open only the key for the block you are testing. Opening a later key early destroys that test

Key · Block 1 only

Calcium-dependent fluorescence is a proxy, not spikes. Neurons and trials are nested within mice. The hierarchy and the perturbation design govern which population and causal claims are available. Six mice do not establish broad or human generality.

Key · Block 2 only

Fp1-F7 = +50 µV; F7-T7 = -20 µV. Making F7 10 µV more negative increases the first derivation by 10 µV and decreases the second by 10 µV. A +15 µV change at A1 subtracts 15 µV from both A1-referenced channels and leaves Fp1-F7 unchanged, because a common reference shift cancels in a bipolar difference. Screen direction cannot be inferred without the display convention.

Key · Block 3 only

Rows must be resampled as paired observations. The small observational dataset shows neither direction nor generality. Simultaneous population spikes are the clearest direct option for choice information, but decoding does not show that the activity causes the choice or uniquely represents it. Other measurement choices pass if their stated limits are correct.

Key · Block 4 only

Two distinct leaks, and they are not the same kind:

  • SelectKBest is supervised. It sees y for every row including the held-out ones, so it leaks outcome information from the test set into feature choice. This is the more serious of the two.
  • StandardScaler is unsupervised. It does not touch y. It leaks feature distribution information from the held-out rows into the training representation. Real, but a different mechanism, and worth being precise about.
  • train_test_split on rows puts windows from the same patient on both sides, so the estimate is partly measuring memorisation of individuals.

The fix: put both transforms inside a Pipeline, split with a group-aware splitter on patient_id, and fit everything inside training folds only.

V1 silencing supports a bounded perturbational claim only under a valid within-animal design with controls. EEG prognosis needs patient-level evaluation and real follow-up; predictive association alone establishes neither mechanism nor decision benefit.

E  Blocks 6 to 7, project-specific held-back case

Before any method tutoring or debugging can reveal the answer, name one small transfer object and its pass rule in the learning contract. Select one development-only case by a deterministic rule written in advance, for example the first eligible group after sorting hashed IDs that was not used for debugging. Record its identifier in TRANSFER-CASE.md and do not inspect its primary output. This is not the final evaluation data. If no honest held-back development case exists, use a synthetic fixture that preserves the failure mode, or narrow the project.

F  EEG transfer packets

Five fixed textual packets. For each, give the broad category, two decisive features, the closest alternative, your confidence, and whether expert review is required. These are author-written educational descriptions, not waveform cases and not a validated test.

  1. Older adult, drowsy; unilateral temporal 8-Hz arciform train; no after-going slow wave, no spread, no evolution, no background disruption.
  2. Drowsy adult; flat-topped or notched mid-temporal alpha or theta-range rhythm lasting 10 seconds; stable morphology, no spread; becomes less prominent as drowsiness deepens.
  3. Recurrent temporal sharp transients with a plausible field, a consistent after-going slow wave, and background disruption.
  4. Temporal rhythmic activity whose frequency and amplitude change and whose field spreads to adjacent regions over time.
  5. Irregular high-frequency temporal activity time-locked to jaw clenching and disappearing with relaxation.
Answer key · open only after recording your attempt
  1. Most compatible with wicket rhythm.
  2. Most compatible with RMTD.
  3. Possible epileptiform transient. Expert adjudication required, not a self-study diagnosis.
  4. Possible evolving ictal pattern. Expert adjudication required.
  5. Muscle artefact.
Pass rule · identical in all three files

At least four of five broad categories correct, including both benign-versus-pathology discriminators (items 1 and 3, and items 2 and 4), with zero categorical diagnostic claims.

On failure: revisit only the relevant atlas subsection, correct the affected card, then take Retest B below. Descriptions you write yourself are practice, never retest evidence.

Retest B · five independent packets · open only after failing the first set
  1. Young adult, light sleep; bilateral synchronous 6-Hz arciform bursts, positive at posterior temporal derivations, lasting under a second, no background disruption.
  2. Adult, drowsy; brief, low-amplitude, mono- or diphasic temporal sharp transients, no after-going slow wave, no background disruption, disappearing in deeper sleep.
  3. Adult; sustained temporal rhythmic theta whose frequency slows and whose field enlarges across 40 seconds, with background attenuation.
  4. Recurrent frontal sharp waves with a consistent after-going slow wave, plausible dipole field, disrupting a normal posterior rhythm.
  5. Rhythmic activity strictly confined to one electrode, unchanged by state, abolished when that electrode is re-gelled.
Retest B key · separately protected

1. 14-and-6 positive bursts. 2. Benign small sharp spikes. 3. Possible evolving ictal pattern, expert adjudication required. 4. Possible epileptiform discharge, expert adjudication required. 5. Electrode artefact.

After a second failure, stop generating quizzes. Record the interpretation dependency in writing and require expert adjudication for every interpretation-sensitive claim in your outputs from that point on.

· Resource ledger

Durable entry points only. Check anything date-sensitive when you use it.

PurposeLink
Python distributionMiniforge
EditorVS Code Python
Version controlGit · GitHub
Python basicsKaggle Learn
ML conceptsStatQuest
ML libraryscikit-learn
Linear algebra3Blue1Brown
Computational neuroscienceNeuromatch
Neuroscience textbookNeuroscience Online, UTHealth
EEG analysisMNE-Python
Signal processingMike X Cohen, free lectures
EEG atlasAES atlas, NCBI Bookshelf
EEG dataOpenNeuro · CHB-MIT · TUH/TUSZ
Behaviour dataIBL
Reporting standardsEQUATOR · TRIPOD+AI · PROBAST+AI
RegistrationOSF · PROSPERO
PreprintsmedRxiv · bioRxiv · arXiv
ArchivingZenodo
Identity and referencesORCID · Zotero
Literature accessEKB
ProgrammesNeuromatch courses · Arabs in Neuroscience · IBRO
Back to the main route
Neuroscience and Computational Methods
Open the roadmap Open the EEG module