Templates and Transfer Pack
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.
| § | Template | First used |
|---|---|---|
| 11.1 | PROGRESS.md | Block 1 |
| 11.2 | Field map, people map, measurement matrix, figure audit | Block 1 |
| 11.3 | Progressive question card | Block 1 |
| 11.4 | Dated overlap memo | Block 5 |
| 11.5 | Data and annotation card | Block 2 |
| 11.6 | Learning contract and pilot record | Block 6 |
| 11.7 | EEG description form and comparison card | EEG module |
| 11.8 | Mentor and reviewer message | Block 2 |
| 11.9 | Gate record | Block 4 |
| 11.10 | Substitution memo | As needed |
| 11.11 | Fixed transfer pack | Every block |
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 –
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.
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.
- Compute
Fp1-F7andF7-T7. Then predict both changes if only F7 becomes 10 µV more negative. - Compute what happens to
Fp1-A1,F7-A1, andFp1-F7if only the common A1 reference becomes 15 µV more positive. - 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:
train_test_split(..., test_size=0.2, random_state=7)withSelectKBest(k=10)andStandardScalerfitted on all data first.GroupKFold(n_splits=5)grouped onpatient_id, transforms still fitted outside the folds.GroupKFoldwithSelectKBestandStandardScalerinside aPipeline, 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:
- Does acute V1 silencing change visual-discrimination behaviour within the same animals?
- 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:
SelectKBestis supervised. It seesyfor 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.StandardScaleris unsupervised. It does not touchy. 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_spliton 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.
- Older adult, drowsy; unilateral temporal 8-Hz arciform train; no after-going slow wave, no spread, no evolution, no background disruption.
- 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.
- Recurrent temporal sharp transients with a plausible field, a consistent after-going slow wave, and background disruption.
- Temporal rhythmic activity whose frequency and amplitude change and whose field spreads to adjacent regions over time.
- Irregular high-frequency temporal activity time-locked to jaw clenching and disappearing with relaxation.
Answer key · open only after recording your attempt
- Most compatible with wicket rhythm.
- Most compatible with RMTD.
- Possible epileptiform transient. Expert adjudication required, not a self-study diagnosis.
- Possible evolving ictal pattern. Expert adjudication required.
- Muscle artefact.
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
- Young adult, light sleep; bilateral synchronous 6-Hz arciform bursts, positive at posterior temporal derivations, lasting under a second, no background disruption.
- Adult, drowsy; brief, low-amplitude, mono- or diphasic temporal sharp transients, no after-going slow wave, no background disruption, disappearing in deeper sleep.
- Adult; sustained temporal rhythmic theta whose frequency slows and whose field enlarges across 40 seconds, with background attenuation.
- Recurrent frontal sharp waves with a consistent after-going slow wave, plausible dipole field, disrupting a normal posterior rhythm.
- 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.
Durable entry points only. Check anything date-sensitive when you use it.
| Purpose | Link |
|---|---|
| Python distribution | Miniforge |
| Editor | VS Code Python |
| Version control | Git · GitHub |
| Python basics | Kaggle Learn |
| ML concepts | StatQuest |
| ML library | scikit-learn |
| Linear algebra | 3Blue1Brown |
| Computational neuroscience | Neuromatch |
| Neuroscience textbook | Neuroscience Online, UTHealth |
| EEG analysis | MNE-Python |
| Signal processing | Mike X Cohen, free lectures |
| EEG atlas | AES atlas, NCBI Bookshelf |
| EEG data | OpenNeuro · CHB-MIT · TUH/TUSZ |
| Behaviour data | IBL |
| Reporting standards | EQUATOR · TRIPOD+AI · PROBAST+AI |
| Registration | OSF · PROSPERO |
| Preprints | medRxiv · bioRxiv · arXiv |
| Archiving | Zenodo |
| Identity and references | ORCID · Zotero |
| Literature access | EKB |
| Programmes | Neuromatch courses · Arabs in Neuroscience · IBRO |