@brainpilot/skills 0.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +6 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +28 -0
- package/dist/index.js.map +1 -0
- package/package.json +35 -0
- package/skills/01_Meta-Skills/contribute-skill/SKILL.md +277 -0
- package/skills/01_Meta-Skills/contribute-skills-via-pr/SKILL.md +163 -0
- package/skills/01_Meta-Skills/paper-to-skill/SKILL.md +435 -0
- package/skills/01_Meta-Skills/paper-to-skill/references/extraction-guide.md +286 -0
- package/skills/01_Meta-Skills/paper-to-skill/references/skill-template.md +250 -0
- package/skills/01_Meta-Skills/repo-to-skill/SKILL.md +289 -0
- package/skills/01_Meta-Skills/share-case/SKILL.md +253 -0
- package/skills/01_Meta-Skills/share-usage/README.md +63 -0
- package/skills/01_Meta-Skills/share-usage/SKILL.md +395 -0
- package/skills/01_Meta-Skills/verify-skill/SKILL.md +331 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/SKILL.md +194 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/references/effect-sizes.md +352 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/references/sample-size-guide.md +407 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-statistics/SKILL.md +361 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-statistics/references/common-analyses.md +517 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-visualization/SKILL.md +292 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-visualization/references/plot-recipes.md +709 -0
- package/skills/02_Cross-Domain_Foundation/research-literacy/SKILL.md +286 -0
- package/skills/02_Cross-Domain_Foundation/research-literacy/references/common-assumptions.md +320 -0
- package/skills/02_Cross-Domain_Foundation/research-literacy/references/planning-template.md +143 -0
- package/skills/03_Cognitive_Psychology/alternative-uses-task-designer/SKILL.md +197 -0
- package/skills/03_Cognitive_Psychology/alternative-uses-task-designer/references/instruction-templates.md +60 -0
- package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/SKILL.md +246 -0
- package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/references/classic-paradigms.md +435 -0
- package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/references/design-principles.md +256 -0
- package/skills/03_Cognitive_Psychology/creativity-self-efficacy-mediation/SKILL.md +270 -0
- package/skills/03_Cognitive_Psychology/creativity-self-efficacy-mediation/references/lavaan-templates.md +172 -0
- package/skills/03_Cognitive_Psychology/divergent-thinking-scoring/SKILL.md +238 -0
- package/skills/03_Cognitive_Psychology/divergent-thinking-scoring/references/scoring-rubric.md +143 -0
- package/skills/03_Cognitive_Psychology/drift-diffusion-model/SKILL.md +203 -0
- package/skills/03_Cognitive_Psychology/drift-diffusion-model/references/fitting-guide.md +571 -0
- package/skills/03_Cognitive_Psychology/drift-diffusion-model/references/model-variants.md +427 -0
- package/skills/03_Cognitive_Psychology/evidence-accumulation-selector/SKILL.md +310 -0
- package/skills/03_Cognitive_Psychology/evidence-accumulation-selector/references/ez-diffusion-formulas.md +137 -0
- package/skills/03_Cognitive_Psychology/signal-detection-analysis/SKILL.md +300 -0
- package/skills/03_Cognitive_Psychology/signal-detection-analysis/references/application-guide.md +278 -0
- package/skills/03_Cognitive_Psychology/signal-detection-analysis/references/sdt-formulas.md +318 -0
- package/skills/03_Cognitive_Psychology/visual-search-array-generator/SKILL.md +283 -0
- package/skills/03_Cognitive_Psychology/visual-search-array-generator/references/array-generation-parameters.yaml +111 -0
- package/skills/04_Psycholinguistics/reading-time-analysis/SKILL.md +301 -0
- package/skills/04_Psycholinguistics/reading-time-analysis/references/measure-computation-guide.md +195 -0
- package/skills/04_Psycholinguistics/self-paced-reading-designer/SKILL.md +257 -0
- package/skills/04_Psycholinguistics/self-paced-reading-designer/references/analysis-guide.md +356 -0
- package/skills/04_Psycholinguistics/self-paced-reading-designer/references/region-segmentation.md +266 -0
- package/skills/04_Psycholinguistics/sentence-stimulus-norming/SKILL.md +346 -0
- package/skills/04_Psycholinguistics/sentence-stimulus-norming/references/lexical-databases-guide.md +184 -0
- package/skills/05_EEG_ERP/eeg-paradigm-designer/SKILL.md +226 -0
- package/skills/05_EEG_ERP/eeg-paradigm-designer/references/component-paradigm-map.md +276 -0
- package/skills/05_EEG_ERP/eeg-paradigm-designer/references/timing-parameters.md +244 -0
- package/skills/05_EEG_ERP/eeg-preprocessing-pipeline-guide/SKILL.md +367 -0
- package/skills/05_EEG_ERP/eeg-preprocessing-pipeline-guide/references/parameter-lookup-tables.md +138 -0
- package/skills/05_EEG_ERP/erp-analysis/SKILL.md +185 -0
- package/skills/05_EEG_ERP/erp-analysis/references/erp-components.md +447 -0
- package/skills/05_EEG_ERP/erp-analysis/references/preprocessing-pipeline.md +277 -0
- package/skills/05_EEG_ERP/erp-analysis/references/statistical-approaches.md +351 -0
- package/skills/05_EEG_ERP/mne-python-guide/SKILL.md +174 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/decoding.md +178 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/io_formats.md +160 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/preprocessing.md +259 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/simulation.md +173 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/source_localization.md +234 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/statistics.md +196 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/time_frequency.md +165 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/visualization.md +175 -0
- package/skills/06_fMRI_Neuroimaging/brain-connectivity-modeler/SKILL.md +317 -0
- package/skills/06_fMRI_Neuroimaging/brain-connectivity-modeler/references/method-implementation-guide.md +116 -0
- package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/SKILL.md +296 -0
- package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/references/design-matrix-guide.md +214 -0
- package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/references/statistical-inference.md +288 -0
- package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/SKILL.md +274 -0
- package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/references/quality-control.md +336 -0
- package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/references/step-by-step-pipeline.md +380 -0
- package/skills/06_fMRI_Neuroimaging/fmri-task-design-guide/SKILL.md +264 -0
- package/skills/06_fMRI_Neuroimaging/fmri-task-design-guide/references/design-optimization-examples.md +114 -0
- package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/SKILL.md +273 -0
- package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/references/decoding-methods.md +170 -0
- package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/references/rsa-guide.md +266 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/SKILL.md +123 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/database-subjects.md +179 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/dataset-types.md +208 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/freesurfer-fmriprep.md +162 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/mapping-transforms.md +181 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/mni-utils.md +207 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/surface-analysis.md +219 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/visualization.md +251 -0
- package/skills/07_Computational_Modeling/act-r-model-builder/SKILL.md +297 -0
- package/skills/07_Computational_Modeling/act-r-model-builder/references/model-patterns.md +197 -0
- package/skills/07_Computational_Modeling/act-r-model-builder/references/parameter-table.yaml +204 -0
- package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/SKILL.md +294 -0
- package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/references/diagnostics-checklist.md +351 -0
- package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/references/prior-selection-guide.md +241 -0
- package/skills/07_Computational_Modeling/parameter-recovery-checker/SKILL.md +269 -0
- package/skills/07_Computational_Modeling/parameter-recovery-checker/references/recovery-diagnostics.md +207 -0
- package/skills/08_Computational_Neuroscience/brain-connectivity-modeler/SKILL.md +317 -0
- package/skills/08_Computational_Neuroscience/brain-connectivity-modeler/references/method-implementation-guide.md +116 -0
- package/skills/08_Computational_Neuroscience/neural-decoding-analysis/SKILL.md +273 -0
- package/skills/08_Computational_Neuroscience/neural-decoding-analysis/references/decoding-methods.md +170 -0
- package/skills/08_Computational_Neuroscience/neural-decoding-analysis/references/rsa-guide.md +266 -0
- package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/SKILL.md +305 -0
- package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/references/data-requirements.md +60 -0
- package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/references/method-comparison.md +151 -0
- package/skills/08_Computational_Neuroscience/spiking-network-model-builder/SKILL.md +376 -0
- package/skills/08_Computational_Neuroscience/spiking-network-model-builder/references/hh-parameters.md +117 -0
- package/skills/08_Computational_Neuroscience/spiking-network-model-builder/references/network-regimes.md +130 -0
- package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/SKILL.md +258 -0
- package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/references/indicator-parameters.md +242 -0
- package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/references/pipeline-details.md +211 -0
- package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/SKILL.md +261 -0
- package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/references/opsin-catalog.md +124 -0
- package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/references/stimulation-parameters.md +304 -0
- package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/SKILL.md +367 -0
- package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/references/disconnection-guide.md +152 -0
- package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/references/vlsm-pipeline.md +182 -0
- package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/SKILL.md +250 -0
- package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/references/deficit-profiles.md +302 -0
- package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/references/test-catalog.md +304 -0
- package/skills/11_Developmental_Cognition/infant-looking-time-designer/SKILL.md +345 -0
- package/skills/11_Developmental_Cognition/infant-looking-time-designer/references/age-parameters.yaml +186 -0
- package/skills/12_Social_Cognition/tom-task-selector/SKILL.md +379 -0
- package/skills/12_Social_Cognition/tom-task-selector/references/task-database.md +317 -0
- package/skills/13_Visualization/nature-figure/README.md +442 -0
- package/skills/13_Visualization/nature-figure/SKILL.md +60 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-01-bar-charts.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-02-line-trends.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-03-heatmaps.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-04-scatter-bubble.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-05-radar-polar.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-06-distributions.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-07-forest-interval.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-08-area-stacked.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-09-image-plates.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-10-network-matrix.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_motivation.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_observation.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_observation_distillation.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_contrastive.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_results_CEDAR.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_results_IEDB.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_schematic.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/RNAGenScape_schematic.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/figures/ablation.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/figures/comparison.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/plot_ablation.py +86 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/plot_comparison.py +109 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/diffusion_swiss_roll.py +97 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/diffusion_swiss_roll.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_GeneRegulatory.pdf +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_GeneRegulatory.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_Trajectory.pdf +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_Trajectory.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/figX_comparison_Ablation.pdf +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/figX_comparison_Ablation.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_Ablation.py +64 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_GeneRegulatory.py +74 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_Trajectory.py +74 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/figures/idea.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/figures/illustration.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/plot_idea.py +76 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/plot_illustration.py +404 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_FPGM/figures/freq_prior.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_FPGM/plot_freq_prior.py +146 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_ablation_Cancer.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_ablation_IEDB.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_comparison_Cancer.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_comparison_IEDB.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/plot_bars.py +216 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/raw_data.py +125 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/manifold.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/manifold_holes.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_comparison_optimization.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_comparison_speed.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_sweep.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_comparison.py +228 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_hole_manifold.py +82 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_manifold.py +61 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_sweep.py +77 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/figures/comparison_posttraining.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/figures/comparison_radar.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/plot_comparison_radar.py +173 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/plot_posttraining.py +82 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/brute_force.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/correctness_by_category.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/correctness_by_subcategory.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/rewriting.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/selfcorrection_math.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_brute_force.py +248 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_correctness_by_category.py +132 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_correctness_by_subcategory.py +131 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_rewriting.py +105 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_selfcorrection_math.py +99 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/figures/composition_heatmap.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/figures/trend_by_month.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/plot_composition.py +81 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/plot_trend.py +125 -0
- package/skills/13_Visualization/nature-figure/assets/gallery/fig1-material-mechanism-rich.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/gallery/fig2-spatial-imaging-rich.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/gallery/fig3-in-vivo-efficacy-rich.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/gallery/fig4-single-cell-systems-rich.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/gallery/fig5-validation-perturbation-rich.png +0 -0
- package/skills/13_Visualization/nature-figure/evals/evals.json +37 -0
- package/skills/13_Visualization/nature-figure/manifest.yaml +57 -0
- package/skills/13_Visualization/nature-figure/references/api.md +428 -0
- package/skills/13_Visualization/nature-figure/references/backend-selection.md +100 -0
- package/skills/13_Visualization/nature-figure/references/chart-types.md +281 -0
- package/skills/13_Visualization/nature-figure/references/common-patterns.md +350 -0
- package/skills/13_Visualization/nature-figure/references/demos.md +65 -0
- package/skills/13_Visualization/nature-figure/references/design-theory.md +436 -0
- package/skills/13_Visualization/nature-figure/references/figure-contract.md +93 -0
- package/skills/13_Visualization/nature-figure/references/nature-2026-observations.md +112 -0
- package/skills/13_Visualization/nature-figure/references/qa-contract.md +119 -0
- package/skills/13_Visualization/nature-figure/references/r-template-index.md +66 -0
- package/skills/13_Visualization/nature-figure/references/r-workflow.md +161 -0
- package/skills/13_Visualization/nature-figure/references/tutorials.md +251 -0
- package/skills/13_Visualization/nature-figure/static/core/contract.md +29 -0
- package/skills/13_Visualization/nature-figure/static/core/stance.md +37 -0
- package/skills/13_Visualization/nature-figure/static/fragments/backend/python.md +37 -0
- package/skills/13_Visualization/nature-figure/static/fragments/backend/r.md +44 -0
- package/skills/14_Writing/markdown-report-writing/SKILL.md +306 -0
- package/skills/14_Writing/markdown-report-writing/references/compatibility-matrix.md +72 -0
- package/skills/14_Writing/markdown-report-writing/references/templates.md +299 -0
- package/skills/15_Others/neuroimaging-power-guide/SKILL.md +324 -0
- package/skills/15_Others/neuroimaging-power-guide/references/effect-size-lookup-tables.md +102 -0
- package/skills/15_Others/neuroimaging-sample-size-calculator/SKILL.md +330 -0
- package/skills/15_Others/neuroimaging-sample-size-calculator/references/worked-examples.md +220 -0
|
@@ -0,0 +1,367 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "lesion-symptom-mapping-guide"
|
|
3
|
+
description: "Advises on lesion-symptom mapping methods: VLSM, disconnection analysis, network lesion mapping"
|
|
4
|
+
domain: "clinical-neuroscience"
|
|
5
|
+
version: "1.0.0"
|
|
6
|
+
authors:
|
|
7
|
+
- "Claude Code Agent"
|
|
8
|
+
papers:
|
|
9
|
+
- "Bates et al., 2003"
|
|
10
|
+
- "Kimberg et al., 2007"
|
|
11
|
+
- "Foulon et al., 2018"
|
|
12
|
+
- "Zhang et al., 2014"
|
|
13
|
+
- "Boes et al., 2015"
|
|
14
|
+
- "Sperber, 2020"
|
|
15
|
+
dependencies:
|
|
16
|
+
required:
|
|
17
|
+
- research-literacy
|
|
18
|
+
recommended:
|
|
19
|
+
- fmri-preprocessing-pipeline-guide
|
|
20
|
+
review_status: "ai-generated"
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
# Lesion-Symptom Mapping Guide
|
|
24
|
+
|
|
25
|
+
## Purpose
|
|
26
|
+
|
|
27
|
+
This skill encodes expert methodological knowledge for lesion-symptom mapping in clinical and cognitive neuroscience. A competent programmer without neuropsychology and neuroimaging training will get this wrong because:
|
|
28
|
+
|
|
29
|
+
- **Lesion distributions are not random.** Stroke lesions cluster in the middle cerebral artery (MCA) territory, creating systematic collinearity between brain regions. Standard voxelwise methods confound truly causal regions with regions that are simply co-damaged (Sperber, 2020).
|
|
30
|
+
- **Lesion volume is a massive confound.** Larger lesions produce worse behavioral deficits simply because more tissue is damaged. Any analysis that does not control for total lesion volume will attribute behavioral deficits to whichever regions are most often part of large lesions (DeMarco & Turkeltaub, 2018).
|
|
31
|
+
- **White matter disconnection matters as much as grey matter damage.** A focal lesion can disrupt distant regions via white matter pathway disruption (diaschisis). VLSM misses this entirely; disconnection analysis is needed (Foulon et al., 2018).
|
|
32
|
+
- **Standard multiple comparison correction is insufficient.** Permutation-based FWE correction is required because voxelwise tests are massively non-independent (lesion voxels are spatially correlated), violating assumptions of FDR and parametric corrections (Kimberg et al., 2007).
|
|
33
|
+
- **Small samples produce false localizations.** With fewer than 50 patients, VLSM lacks power and produces unreliable maps that do not replicate (Sperber, 2020).
|
|
34
|
+
|
|
35
|
+
## When to Use This Skill
|
|
36
|
+
|
|
37
|
+
- Planning a voxel-based lesion-symptom mapping (VLSM) study
|
|
38
|
+
- Choosing between VLSM, multivariate, and disconnection-based approaches
|
|
39
|
+
- Setting statistical thresholds and correction methods for lesion analyses
|
|
40
|
+
- Evaluating whether a published lesion study adequately controlled for confounds
|
|
41
|
+
- Implementing lesion segmentation and registration pipelines
|
|
42
|
+
- Conducting network-based lesion mapping with normative connectome data
|
|
43
|
+
|
|
44
|
+
Do NOT use this skill for:
|
|
45
|
+
|
|
46
|
+
- Radiological lesion diagnosis (requires clinical neuroradiology)
|
|
47
|
+
- General fMRI analysis (see `fmri-glm-analysis-guide`)
|
|
48
|
+
- White matter tractography methodology (upstream of this skill)
|
|
49
|
+
|
|
50
|
+
## Research Planning Protocol
|
|
51
|
+
|
|
52
|
+
Before executing the domain-specific steps below, you MUST:
|
|
53
|
+
|
|
54
|
+
1. **State the research question** -- What specific question is this analysis/paradigm addressing?
|
|
55
|
+
2. **Justify the method choice** -- Why is this approach appropriate? What alternatives were considered?
|
|
56
|
+
3. **Declare expected outcomes** -- What results would support vs. refute the hypothesis?
|
|
57
|
+
4. **Note assumptions and limitations** -- What does this method assume? Where could it mislead?
|
|
58
|
+
5. **Present the plan to the user and WAIT for confirmation** before proceeding.
|
|
59
|
+
|
|
60
|
+
For detailed methodology guidance, see the `research-literacy` skill.
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
## ⚠️ Verification Notice
|
|
66
|
+
|
|
67
|
+
This skill was generated by AI from academic literature. All parameters, thresholds, and citations require independent verification before use in research. If you find errors, please [open an issue](https://github.com/HaoxuanLiTHUAI/awesome_cognitive_and_neuroscience_skills/issues).
|
|
68
|
+
|
|
69
|
+
## Method Selection Decision Tree
|
|
70
|
+
|
|
71
|
+
```
|
|
72
|
+
What is your research question?
|
|
73
|
+
|
|
|
74
|
+
+-- "Which brain voxels are associated with a behavioral deficit?"
|
|
75
|
+
| |
|
|
76
|
+
| +-- N >= 50 patients, continuous outcome
|
|
77
|
+
| | --> VLSM (mass-univariate)
|
|
78
|
+
| |
|
|
79
|
+
| +-- N >= 50 patients, binary outcome
|
|
80
|
+
| | --> VLSM with Brunner-Munzel or chi-square
|
|
81
|
+
| |
|
|
82
|
+
| +-- N >= 100 patients, distributed representations expected
|
|
83
|
+
| | --> SVR-LSM (multivariate)
|
|
84
|
+
| |
|
|
85
|
+
| +-- N < 50 patients
|
|
86
|
+
| --> Underpowered for VLSM; consider ROI-based approach
|
|
87
|
+
| or case-series descriptive analysis
|
|
88
|
+
|
|
|
89
|
+
+-- "Which white matter pathways mediate the deficit?"
|
|
90
|
+
| --> Disconnection analysis (BCBToolkit, Disconnectome)
|
|
91
|
+
| Can supplement VLSM or replace it when tracts are the question
|
|
92
|
+
|
|
|
93
|
+
+-- "Which brain networks, when lesioned, produce this symptom?"
|
|
94
|
+
--> Lesion network mapping (normative connectome)
|
|
95
|
+
Maps lesion location to network disruption
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## Lesion Segmentation
|
|
101
|
+
|
|
102
|
+
### Methods
|
|
103
|
+
|
|
104
|
+
| Method | Description | Accuracy | Time per patient | Source |
|
|
105
|
+
|---|---|---|---|---|
|
|
106
|
+
| **Manual tracing** | Expert traces lesion on each slice | Gold standard | 30--60 min | Brett et al., 2001 |
|
|
107
|
+
| **Semi-automated (lesion_gnb)** | Gaussian naive Bayes on FLAIR | Good for chronic WM lesions | 5--15 min | Pustina et al., 2016 |
|
|
108
|
+
| **LINDA** | Random forest on T1 | Good for chronic stroke | 5--10 min | Pustina et al., 2016 |
|
|
109
|
+
| **U-net / deep learning** | Trained CNNs | Approaching manual accuracy | < 1 min | Kamnitsas et al., 2017 |
|
|
110
|
+
|
|
111
|
+
> **Domain judgment**: Manual tracing remains the gold standard. Semi-automated methods should always be visually inspected and manually corrected. Never trust a fully automated segmentation without visual QC of every patient (Brett et al., 2001).
|
|
112
|
+
|
|
113
|
+
### Registration to Standard Space
|
|
114
|
+
|
|
115
|
+
1. **Cost function masking** (CRITICAL): When registering a lesioned brain to MNI template, the lesion MUST be masked out of the cost function. Without masking, the registration algorithm warps healthy tissue to fill the lesion, distorting the spatial normalization (Brett et al., 2001).
|
|
116
|
+
|
|
117
|
+
2. **Recommended pipeline**:
|
|
118
|
+
- Segment lesion on native T1 (or FLAIR)
|
|
119
|
+
- Create binary lesion mask
|
|
120
|
+
- Register T1 to MNI using nonlinear registration (e.g., ANTs SyN) with lesion mask as cost function mask
|
|
121
|
+
- Apply the same warp to the lesion mask
|
|
122
|
+
- Verify registration quality visually
|
|
123
|
+
|
|
124
|
+
3. **Enantiomorphic normalization**: For large lesions, replace the lesioned hemisphere with a flipped version of the intact hemisphere before registration. This improves normalization quality for large lesions (Nachev et al., 2008).
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## Voxel-Based Lesion-Symptom Mapping (VLSM)
|
|
129
|
+
|
|
130
|
+
### Prerequisites and Sample Size
|
|
131
|
+
|
|
132
|
+
| Requirement | Minimum | Recommended | Source |
|
|
133
|
+
|---|---|---|---|
|
|
134
|
+
| Sample size | N >= **50** | N >= **100** | Sperber, 2020; Kimberg et al., 2007 |
|
|
135
|
+
| Lesion overlap per voxel | >= **10% of sample** (or N >= 10) | >= 15% | Kimberg et al., 2007 |
|
|
136
|
+
| Behavioral measure | Continuous preferred | -- | Bates et al., 2003 |
|
|
137
|
+
|
|
138
|
+
> **Domain judgment**: VLSM with N < 50 is severely underpowered. Sperber (2020) showed that with N = 30, VLSM produces maps that fail to replicate and have unacceptably high false discovery rates. If N < 50, consider ROI-based analyses with a priori regions or descriptive lesion overlap approaches.
|
|
139
|
+
|
|
140
|
+
### Statistical Tests
|
|
141
|
+
|
|
142
|
+
| Test | When to Use | Advantages | Source |
|
|
143
|
+
|---|---|---|---|
|
|
144
|
+
| **t-test** | Continuous behavior, binary lesion status per voxel | Simple, widely used | Bates et al., 2003 |
|
|
145
|
+
| **Brunner-Munzel** | Non-normal behavioral data, unequal variances | Robust to non-normality and unequal group sizes | Rorden et al., 2007 |
|
|
146
|
+
| **Regression** | Controlling for covariates (age, lesion volume) | Flexible; includes confound control | Sperber, 2020 |
|
|
147
|
+
| **Liebermeister** | Binary behavioral outcome (impaired/spared) | For binary classification | Rorden et al., 2007 |
|
|
148
|
+
|
|
149
|
+
### Multiple Comparison Correction
|
|
150
|
+
|
|
151
|
+
| Method | Description | Recommended? | Source |
|
|
152
|
+
|---|---|---|---|
|
|
153
|
+
| **Permutation-based FWE** | Permute behavioral scores 5000+ times; threshold at 5th percentile of max statistic | **YES -- gold standard** | Kimberg et al., 2007 |
|
|
154
|
+
| **FDR** (Benjamini-Hochberg) | Controls false discovery rate | Acceptable alternative but assumes independence | Kimberg et al., 2007 |
|
|
155
|
+
| **Bonferroni** | Divide alpha by number of voxels | **Too conservative**; almost never detects effects | Expert consensus |
|
|
156
|
+
| **Uncorrected** | No correction | **NEVER for publication** | Expert consensus |
|
|
157
|
+
|
|
158
|
+
> **Domain judgment**: Permutation testing is strongly preferred because lesion maps violate the independence assumptions of FDR and parametric corrections. The spatial correlation structure of lesions means neighboring voxels are highly non-independent. Permutation testing implicitly accounts for this correlation structure (Kimberg et al., 2007).
|
|
159
|
+
|
|
160
|
+
### Controlling for Lesion Volume
|
|
161
|
+
|
|
162
|
+
Lesion volume MUST be controlled. Methods (DeMarco & Turkeltaub, 2018):
|
|
163
|
+
|
|
164
|
+
1. **Direct regression**: Include total lesion volume as a covariate in the voxelwise regression model
|
|
165
|
+
2. **Behavioral residualization**: Regress behavior on lesion volume first; use residuals as the dependent variable in VLSM
|
|
166
|
+
3. **Both yield similar results**, but direct regression is preferred for interpretability (DeMarco & Turkeltaub, 2018)
|
|
167
|
+
|
|
168
|
+
> **CRITICAL**: Failing to control for lesion volume is the single most common error in VLSM studies. Large lesions damage more regions and produce worse deficits, creating a spurious correlation between any frequently-damaged voxel and behavioral impairment (DeMarco & Turkeltaub, 2018).
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## Multivariate Lesion-Symptom Mapping
|
|
173
|
+
|
|
174
|
+
### SVR-LSM (Zhang et al., 2014)
|
|
175
|
+
|
|
176
|
+
Support vector regression-based lesion-symptom mapping considers the full lesion pattern simultaneously, addressing the collinearity problem of mass-univariate VLSM.
|
|
177
|
+
|
|
178
|
+
| Parameter | Recommended Value | Source |
|
|
179
|
+
|---|---|---|
|
|
180
|
+
| Kernel | **Linear** | Zhang et al., 2014 |
|
|
181
|
+
| C parameter | **30** (default for LSM) | Zhang et al., 2014 |
|
|
182
|
+
| Feature reduction | Remove voxels with < 10% lesion overlap | Zhang et al., 2014 |
|
|
183
|
+
| Statistical inference | **Permutation testing** (5000+ permutations) | Zhang et al., 2014 |
|
|
184
|
+
|
|
185
|
+
**Advantages over VLSM** (Zhang et al., 2014):
|
|
186
|
+
- Considers spatial covariance of lesion damage (voxels are analyzed jointly, not independently)
|
|
187
|
+
- Better handles the collinearity created by vascular territories
|
|
188
|
+
- Can detect distributed patterns
|
|
189
|
+
|
|
190
|
+
**Limitations**:
|
|
191
|
+
- Computationally expensive (hours per analysis with permutation testing)
|
|
192
|
+
- Requires larger samples (N >= 80--100 recommended) for stable SVR weights
|
|
193
|
+
- Interpretation of SVR weight maps is less straightforward than VLSM t-maps
|
|
194
|
+
|
|
195
|
+
### Machine Learning-Based Mapping (MLBM)
|
|
196
|
+
|
|
197
|
+
Other multivariate approaches (random forests, LASSO regression) can be applied:
|
|
198
|
+
- LASSO is useful for variable selection among brain regions
|
|
199
|
+
- Random forests handle nonlinear relationships
|
|
200
|
+
- All require permutation-based significance testing
|
|
201
|
+
- Cross-validation (leave-one-out or k-fold) is mandatory
|
|
202
|
+
|
|
203
|
+
---
|
|
204
|
+
|
|
205
|
+
## Disconnection Analysis
|
|
206
|
+
|
|
207
|
+
### Rationale
|
|
208
|
+
|
|
209
|
+
A focal lesion disrupts not only the damaged tissue but also white matter pathways passing through the lesion, disconnecting distant brain regions (Foulon et al., 2018). VLSM maps only the lesion site; disconnection analysis maps the affected structural connections.
|
|
210
|
+
|
|
211
|
+
### Methods
|
|
212
|
+
|
|
213
|
+
| Tool | Approach | Data Required | Source |
|
|
214
|
+
|---|---|---|---|
|
|
215
|
+
| **BCBToolkit** | Maps lesion to disconnected tracts using normative tractography atlas | Lesion mask in MNI space | Foulon et al., 2018 |
|
|
216
|
+
| **Disconnectome maps** | Pre-computed: for each brain voxel, which tracts are disconnected | Lesion mask in MNI space | Thiebaut de Schotten et al., 2015 |
|
|
217
|
+
| **Individual tractography** | DTI/DWI tractography in each patient | Patient DWI data | Expert consensus |
|
|
218
|
+
|
|
219
|
+
### BCBToolkit Pipeline (Foulon et al., 2018)
|
|
220
|
+
|
|
221
|
+
1. Register lesion mask to MNI space
|
|
222
|
+
2. Use the normative tractography atlas (from 170 healthy controls) to identify tracts passing through each lesion
|
|
223
|
+
3. Generate a disconnection probability map: for each voxel outside the lesion, the probability that it is disconnected
|
|
224
|
+
4. Use disconnection maps (instead of or in addition to lesion masks) as predictors in VLSM-like analyses
|
|
225
|
+
|
|
226
|
+
### Advantages Over VLSM
|
|
227
|
+
|
|
228
|
+
- Captures **remote effects** (diaschisis) that VLSM misses entirely
|
|
229
|
+
- Accounts for the fact that two lesions in the same voxel can disconnect different pathways depending on their extent
|
|
230
|
+
- Particularly important for white matter lesions, where the damaged tissue itself has no gray matter function
|
|
231
|
+
|
|
232
|
+
---
|
|
233
|
+
|
|
234
|
+
## Network Lesion Mapping
|
|
235
|
+
|
|
236
|
+
### Lesion Network Mapping (Boes et al., 2015; Fox, 2018)
|
|
237
|
+
|
|
238
|
+
Maps a lesion to the brain-wide functional network it disrupts, using normative resting-state fMRI data:
|
|
239
|
+
|
|
240
|
+
1. Use the lesion as a seed region in a normative resting-state fMRI connectome (e.g., 1000-subject dataset)
|
|
241
|
+
2. Compute the functional connectivity map of the lesion location in healthy brains
|
|
242
|
+
3. The resulting map shows which brain regions are functionally connected to the lesion site
|
|
243
|
+
4. Across patients, identify the network that is commonly disrupted
|
|
244
|
+
|
|
245
|
+
### Key Considerations
|
|
246
|
+
|
|
247
|
+
- **Normative connectome**: Results depend on the quality and size of the normative dataset. Larger datasets (N >= 500 healthy controls) provide more reliable connectivity estimates (Fox, 2018).
|
|
248
|
+
- **Seed definition**: Use the entire lesion as a seed, not just the peak voxel. Consider weighting by lesion probability if lesion masks are probabilistic.
|
|
249
|
+
- **Validation**: Compare network maps to known functional anatomy. The disrupted network should be biologically plausible for the observed deficit.
|
|
250
|
+
- **Limitations**: Assumes that healthy-brain connectivity predicts the effect of a lesion. Does not account for reorganization or compensation (Fox, 2018).
|
|
251
|
+
|
|
252
|
+
---
|
|
253
|
+
|
|
254
|
+
## Common Confounds
|
|
255
|
+
|
|
256
|
+
### 1. Lesion Volume Correlation
|
|
257
|
+
|
|
258
|
+
Larger lesions produce worse behavioral deficits and damage more voxels. Without controlling for lesion volume, VLSM maps reflect voxels that are part of large lesions rather than voxels critical for the behavior (DeMarco & Turkeltaub, 2018).
|
|
259
|
+
|
|
260
|
+
### 2. Non-Random Lesion Distribution (MCA Territory Bias)
|
|
261
|
+
|
|
262
|
+
Stroke lesions are not uniformly distributed across the brain. The MCA territory (lateral frontal, temporal, parietal, insular cortex) is disproportionately affected. This means:
|
|
263
|
+
- High statistical power in MCA territory, low power elsewhere
|
|
264
|
+
- Voxels outside MCA territory may be critical but undetectable
|
|
265
|
+
- Collinearity between MCA-territory voxels inflates false positives for non-critical regions (Sperber, 2020)
|
|
266
|
+
|
|
267
|
+
### 3. Time Post-Onset
|
|
268
|
+
|
|
269
|
+
| Phase | Time | Concern | Source |
|
|
270
|
+
|---|---|---|---|
|
|
271
|
+
| Acute (< 2 weeks) | Edema, diaschisis, penumbra | Lesion extent overestimated; behavior worst | Karnath et al., 2004 |
|
|
272
|
+
| Subacute (2 weeks -- 3 months) | Recovery, reorganization | Lesion stabilizing; behavior improving | Expert consensus |
|
|
273
|
+
| Chronic (> 3 months) | Stable lesion | **Preferred for VLSM**; most stable brain-behavior relationship | Sperber, 2020 |
|
|
274
|
+
|
|
275
|
+
> **Domain judgment**: Chronic-phase data (> 3 months post-onset) is strongly preferred for VLSM because both lesion extent and behavioral deficits have stabilized. Acute-phase data confounds true lesion effects with transient diaschisis and edema (Karnath et al., 2004; Sperber, 2020).
|
|
276
|
+
|
|
277
|
+
### 4. Covariates
|
|
278
|
+
|
|
279
|
+
Always consider controlling for:
|
|
280
|
+
- **Age**: Older patients have worse outcomes independent of lesion
|
|
281
|
+
- **Education**: Affects cognitive test performance
|
|
282
|
+
- **Time post-onset**: If sample includes mixed acute/chronic patients
|
|
283
|
+
- **Handedness**: Affects lateralization of language
|
|
284
|
+
- **Lesion hemisphere**: If analyzing bilateral samples, hemisphere effects must be modeled
|
|
285
|
+
|
|
286
|
+
---
|
|
287
|
+
|
|
288
|
+
## Software
|
|
289
|
+
|
|
290
|
+
| Software | Methods | Language | Source |
|
|
291
|
+
|---|---|---|---|
|
|
292
|
+
| **NiiStat** | VLSM, ROI analysis | MATLAB | Rorden et al., 2007 |
|
|
293
|
+
| **VLSM2** | VLSM with permutation testing | MATLAB | Bates et al., 2003 |
|
|
294
|
+
| **SVR-LSM toolbox** | Multivariate SVR-LSM | MATLAB | Zhang et al., 2014 |
|
|
295
|
+
| **BCBToolkit** | Disconnection analysis, disconnectome | GUI/Python | Foulon et al., 2018 |
|
|
296
|
+
| **LESYMAP** | VLSM, SVR-LSM, SCCAN | R | Pustina et al., 2018 |
|
|
297
|
+
| **ANTs** | Registration with cost function masking | C++/Python | Avants et al., 2011 |
|
|
298
|
+
| **FSL** | Registration, lesion masking | Python/C++ | Jenkinson et al., 2012 |
|
|
299
|
+
|
|
300
|
+
---
|
|
301
|
+
|
|
302
|
+
## Common Pitfalls
|
|
303
|
+
|
|
304
|
+
### 1. Not Controlling for Lesion Volume
|
|
305
|
+
|
|
306
|
+
The most frequent and most damaging error. Always include lesion volume as a covariate or use residualized behavioral scores (DeMarco & Turkeltaub, 2018).
|
|
307
|
+
|
|
308
|
+
### 2. Too Small a Sample
|
|
309
|
+
|
|
310
|
+
VLSM with N < 50 produces unreliable maps. With N = 30, false positive rates can exceed 50% in some simulations (Sperber, 2020). If your sample is small, use ROI-based approaches or descriptive methods.
|
|
311
|
+
|
|
312
|
+
### 3. Not Using Cost Function Masking During Registration
|
|
313
|
+
|
|
314
|
+
Registering lesioned brains to template without masking the lesion distorts the normalization, warping healthy tissue into the lesion cavity and misaligning the rest of the brain (Brett et al., 2001).
|
|
315
|
+
|
|
316
|
+
### 4. Using Uncorrected or Bonferroni Correction
|
|
317
|
+
|
|
318
|
+
Uncorrected thresholds produce massive false positives. Bonferroni is too conservative due to spatial correlation. Use permutation-based FWE (Kimberg et al., 2007).
|
|
319
|
+
|
|
320
|
+
### 5. Ignoring the Vascular Architecture
|
|
321
|
+
|
|
322
|
+
Interpreting a VLSM map as showing "the region responsible for function X" ignores that vascular territory collinearity may have driven the result. Consider supplementing with disconnection analysis or using multivariate methods (Sperber, 2020).
|
|
323
|
+
|
|
324
|
+
### 6. Mixing Acute and Chronic Patients Without Controlling for Time
|
|
325
|
+
|
|
326
|
+
Acute patients have larger effective lesions (edema) and worse behavior, confounding time-post-onset with lesion severity. Analyze chronic patients separately or include time as a covariate (Karnath et al., 2004).
|
|
327
|
+
|
|
328
|
+
---
|
|
329
|
+
|
|
330
|
+
## Minimum Reporting Checklist
|
|
331
|
+
|
|
332
|
+
Based on Sperber (2020), DeMarco & Turkeltaub (2018), and Kimberg et al. (2007):
|
|
333
|
+
|
|
334
|
+
- [ ] Sample size and patient demographics (age, sex, education, handedness)
|
|
335
|
+
- [ ] Etiology (ischemic stroke, hemorrhagic, tumor, etc.) and affected hemisphere(s)
|
|
336
|
+
- [ ] Time post-onset for each patient (or range)
|
|
337
|
+
- [ ] Lesion segmentation method (manual, semi-automated, automated) and software
|
|
338
|
+
- [ ] Registration method and whether cost function masking was used
|
|
339
|
+
- [ ] Minimum lesion overlap threshold for voxel inclusion
|
|
340
|
+
- [ ] Statistical test used (t-test, Brunner-Munzel, regression, SVR)
|
|
341
|
+
- [ ] Multiple comparison correction method and parameters (number of permutations)
|
|
342
|
+
- [ ] Whether and how lesion volume was controlled
|
|
343
|
+
- [ ] Behavioral measure(s) and their psychometric properties
|
|
344
|
+
- [ ] Software and version for all analysis steps
|
|
345
|
+
- [ ] For disconnection analysis: normative tractography dataset and pipeline details
|
|
346
|
+
|
|
347
|
+
---
|
|
348
|
+
|
|
349
|
+
## Key References
|
|
350
|
+
|
|
351
|
+
- Bates, E., Wilson, S. M., Saygin, A. P., Dick, F., Sereno, M. I., Knight, R. T., & Dronkers, N. F. (2003). Voxel-based lesion-symptom mapping. *Nature Neuroscience*, 6(5), 448--450.
|
|
352
|
+
- Boes, A. D., Prasad, S., Liu, H., Liu, Q., Pascual-Leone, A., Caviness, V. S., & Fox, M. D. (2015). Network localization of neurological symptoms from focal brain lesions. *Brain*, 138(10), 3061--3075.
|
|
353
|
+
- Brett, M., Leff, A. P., Rorden, C., & Ashburner, J. (2001). Spatial normalization of brain images with focal lesions using cost function masking. *NeuroImage*, 14(2), 486--500.
|
|
354
|
+
- DeMarco, A. T., & Turkeltaub, P. E. (2018). A multivariate lesion symptom mapping toolbox and examination of lesion-volume biases and correction methods in lesion-symptom mapping. *Human Brain Mapping*, 39(11), 4169--4182.
|
|
355
|
+
- Foulon, C., Cerliani, L., Kinkingnehun, S., Levy, R., Rosso, C., Urbanski, M., Volle, E., & Thiebaut de Schotten, M. (2018). Advanced lesion symptom mapping analyses and implementation as BCBtoolkit. *GigaScience*, 7(3), giy004.
|
|
356
|
+
- Fox, M. D. (2018). Mapping symptoms to brain networks with the human connectome. *New England Journal of Medicine*, 379(23), 2237--2245.
|
|
357
|
+
- Kamnitsas, K., Ledig, C., Newcombe, V. F. J., Simpson, J. P., Kane, A. D., Menon, D. K., Rueckert, D., & Glocker, B. (2017). Efficient multi-scale 3D CNN with fully connected CRF for accurate brain lesion segmentation. *Medical Image Analysis*, 36, 61--78.
|
|
358
|
+
- Karnath, H.-O., Fruhmann Berger, M., Kuker, W., & Rorden, C. (2004). The anatomy of spatial neglect based on voxelwise statistical analysis: A study of 140 patients. *Cerebral Cortex*, 14(10), 1164--1172.
|
|
359
|
+
- Kimberg, D. Y., Coslett, H. B., & Schwartz, M. F. (2007). Power in voxel-based lesion-symptom mapping. *Journal of Cognitive Neuroscience*, 19(7), 1067--1080.
|
|
360
|
+
- Nachev, P., Coulthard, E., Jager, H. R., Kennard, C., & Husain, M. (2008). Enantiomorphic normalization of focally lesioned brains. *NeuroImage*, 39(3), 1215--1226.
|
|
361
|
+
- Pustina, D., Coslett, H. B., Turkeltaub, P. E., Tustison, N., Schwartz, M. F., & Avants, B. (2016). Automated segmentation of chronic stroke lesions using LINDA: Lesion identification with neighborhood data analysis. *Human Brain Mapping*, 37(4), 1405--1421.
|
|
362
|
+
- Rorden, C., Karnath, H.-O., & Bonilha, L. (2007). Improving lesion-symptom mapping. *Journal of Cognitive Neuroscience*, 19(7), 1081--1088.
|
|
363
|
+
- Sperber, C. (2020). Rethinking causality and data complexity in brain lesion-behaviour inference and its implications for lesion-behaviour modelling. *Cortex*, 126, 49--62.
|
|
364
|
+
- Zhang, Y., Kimberg, D. Y., Coslett, H. B., Schwartz, M. F., & Wang, Z. (2014). Multivariate lesion-symptom mapping using support vector regression. *Human Brain Mapping*, 35(12), 5861--5876.
|
|
365
|
+
|
|
366
|
+
See `references/vlsm-pipeline.md` for step-by-step VLSM analysis workflow.
|
|
367
|
+
See `references/disconnection-guide.md` for detailed BCBToolkit and disconnection analysis procedures.
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
# Disconnection Analysis and Network Lesion Mapping Guide
|
|
2
|
+
|
|
3
|
+
This reference document supplements `SKILL.md` with detailed procedures for disconnection analysis using BCBToolkit and network lesion mapping approaches.
|
|
4
|
+
|
|
5
|
+
## Disconnection Analysis with BCBToolkit
|
|
6
|
+
|
|
7
|
+
### Overview
|
|
8
|
+
|
|
9
|
+
BCBToolkit (Foulon et al., 2018) maps focal brain lesions to the white matter pathways they disrupt, using a normative tractography atlas derived from 170 healthy control diffusion MRI datasets.
|
|
10
|
+
|
|
11
|
+
### Step-by-Step Procedure
|
|
12
|
+
|
|
13
|
+
#### Step 1: Prepare Lesion Masks
|
|
14
|
+
|
|
15
|
+
- Lesion masks must be in MNI152 space (1mm or 2mm resolution)
|
|
16
|
+
- Binary format (0 = healthy, 1 = lesioned)
|
|
17
|
+
- One NIfTI file per patient
|
|
18
|
+
|
|
19
|
+
#### Step 2: Run Disconnection Mapping
|
|
20
|
+
|
|
21
|
+
For each patient lesion mask:
|
|
22
|
+
1. The toolbox identifies which tractography streamlines pass through the lesion
|
|
23
|
+
2. For each voxel outside the lesion, compute the probability of disconnection:
|
|
24
|
+
```
|
|
25
|
+
P(disconnection at voxel v) = N(streamlines through lesion AND through v) / N(total streamlines through v)
|
|
26
|
+
```
|
|
27
|
+
3. Output: a whole-brain disconnection probability map per patient
|
|
28
|
+
|
|
29
|
+
#### Step 3: Threshold Disconnection Maps
|
|
30
|
+
|
|
31
|
+
- Apply a disconnection probability threshold (typically **> 0.5** or **> 0.7**)
|
|
32
|
+
- Lower thresholds are more sensitive but include more false positives
|
|
33
|
+
- Higher thresholds are more specific but may miss partially disconnected regions
|
|
34
|
+
|
|
35
|
+
#### Step 4: Statistical Analysis
|
|
36
|
+
|
|
37
|
+
Use disconnection probability maps in the same statistical framework as VLSM:
|
|
38
|
+
- **AnaCOM**: Anatomical connectivity-based mapping (included in BCBToolkit)
|
|
39
|
+
- **Voxelwise regression**: Disconnection probability as predictor of behavior
|
|
40
|
+
- **Tract-specific analysis**: Sum disconnection probability within specific tracts (e.g., arcuate fasciculus, corticospinal tract)
|
|
41
|
+
|
|
42
|
+
### Tract-Specific Analysis
|
|
43
|
+
|
|
44
|
+
Major tracts to consider in lesion studies:
|
|
45
|
+
|
|
46
|
+
| Tract | Function | Common Lesion Association | Source |
|
|
47
|
+
|---|---|---|---|
|
|
48
|
+
| Arcuate fasciculus | Language (phonological) | Conduction aphasia, repetition deficits | Catani & Mesulam, 2008 |
|
|
49
|
+
| Inferior fronto-occipital fasciculus | Semantic processing | Semantic deficits | Duffau et al., 2005 |
|
|
50
|
+
| Superior longitudinal fasciculus (II, III) | Spatial attention, praxis | Neglect, apraxia | Thiebaut de Schotten et al., 2011 |
|
|
51
|
+
| Uncinate fasciculus | Ventral semantic pathway | Naming deficits (controversial) | Papagno et al., 2011 |
|
|
52
|
+
| Corticospinal tract | Motor function | Hemiparesis | Zhu et al., 2010 |
|
|
53
|
+
| Inferior longitudinal fasciculus | Visual processing | Visual recognition deficits | Catani et al., 2003 |
|
|
54
|
+
| Cingulum | Memory, emotional processing | Memory deficits | Bubb et al., 2018 |
|
|
55
|
+
| Corpus callosum | Interhemispheric transfer | Disconnection syndromes | Gazzaniga, 2005 |
|
|
56
|
+
|
|
57
|
+
### Comparing VLSM and Disconnection Results
|
|
58
|
+
|
|
59
|
+
Run both VLSM and disconnection analysis on the same dataset to compare:
|
|
60
|
+
|
|
61
|
+
1. **Overlap**: Regions identified by both methods are strong candidates for critical involvement
|
|
62
|
+
2. **VLSM-only regions**: May reflect direct grey matter damage effects
|
|
63
|
+
3. **Disconnection-only regions**: May reflect remote effects via white matter disruption
|
|
64
|
+
4. **Statistical comparison**: Test whether disconnection probability explains additional behavioral variance beyond lesion location (using hierarchical regression)
|
|
65
|
+
|
|
66
|
+
## Network Lesion Mapping
|
|
67
|
+
|
|
68
|
+
### Lesion Network Mapping Procedure (Boes et al., 2015; Fox, 2018)
|
|
69
|
+
|
|
70
|
+
#### Step 1: Obtain Normative Connectome Data
|
|
71
|
+
|
|
72
|
+
- Use a large resting-state fMRI dataset (N >= 500 healthy controls)
|
|
73
|
+
- Common choices:
|
|
74
|
+
- GSP 1000 connectome (Harvard/MGH)
|
|
75
|
+
- Human Connectome Project (HCP)
|
|
76
|
+
- UK Biobank
|
|
77
|
+
- Preprocess normative data with standard resting-state pipeline (motion correction, bandpass filtering 0.01--0.1 Hz, nuisance regression)
|
|
78
|
+
|
|
79
|
+
#### Step 2: Compute Lesion-Seeded Connectivity
|
|
80
|
+
|
|
81
|
+
For each patient:
|
|
82
|
+
1. Use the lesion mask as a seed region
|
|
83
|
+
2. Extract the mean BOLD time series from the seed location using the normative data
|
|
84
|
+
3. Compute whole-brain connectivity (Pearson correlation) from the seed
|
|
85
|
+
4. Fisher z-transform the correlation map
|
|
86
|
+
|
|
87
|
+
#### Step 3: Identify Common Network
|
|
88
|
+
|
|
89
|
+
Across all patients:
|
|
90
|
+
1. Threshold individual connectivity maps (e.g., at z > 0.2)
|
|
91
|
+
2. Compute the overlap: which regions are functionally connected to ALL (or most) lesion sites
|
|
92
|
+
3. Alternatively, correlate patient-specific connectivity patterns with behavioral scores
|
|
93
|
+
|
|
94
|
+
#### Step 4: Validate
|
|
95
|
+
|
|
96
|
+
- Compare the identified network to known functional anatomy
|
|
97
|
+
- Test whether network disruption score predicts behavioral deficit severity
|
|
98
|
+
- Cross-validate using leave-one-out or split-half approaches
|
|
99
|
+
|
|
100
|
+
### Network Lesion Mapping Considerations
|
|
101
|
+
|
|
102
|
+
| Consideration | Details | Source |
|
|
103
|
+
|---|---|---|
|
|
104
|
+
| Normative data quality | Larger, better-preprocessed datasets yield more reliable maps | Fox, 2018 |
|
|
105
|
+
| Lesion size effects | Large lesions produce more diffuse connectivity maps; consider size-matched controls | Fox, 2018 |
|
|
106
|
+
| Compensation/reorganization | Normative connectivity does not account for post-lesion plasticity | Fox, 2018 |
|
|
107
|
+
| Symptom specificity | Different symptoms from lesions in the same location may map to different networks | Boes et al., 2015 |
|
|
108
|
+
| Laterality | Ensure normative data includes adequate coverage of both hemispheres | Expert consensus |
|
|
109
|
+
|
|
110
|
+
### When to Use Each Approach
|
|
111
|
+
|
|
112
|
+
| Research Question | Recommended Method | Rationale |
|
|
113
|
+
|---|---|---|
|
|
114
|
+
| Which voxels are associated with deficit? | VLSM | Direct, established, widely accepted |
|
|
115
|
+
| Which tracts mediate the deficit? | Disconnection analysis | Captures white matter effects |
|
|
116
|
+
| Which brain network is disrupted? | Lesion network mapping | Captures distributed network effects |
|
|
117
|
+
| What explains the most variance? | Combine all three | Compare models; use hierarchical regression |
|
|
118
|
+
|
|
119
|
+
## Integration of Multiple Approaches
|
|
120
|
+
|
|
121
|
+
### Recommended Multi-Method Pipeline
|
|
122
|
+
|
|
123
|
+
1. **Start with VLSM**: Establish voxel-level associations (requires N >= 50)
|
|
124
|
+
2. **Add disconnection analysis**: Identify tract-level contributions (BCBToolkit)
|
|
125
|
+
3. **Add network mapping**: Identify network-level disruption (if normative connectome available)
|
|
126
|
+
4. **Compare**: Use hierarchical regression to test which level (voxel, tract, network) best explains behavioral variance
|
|
127
|
+
5. **Report all**: Provide maps at all three levels for comprehensive brain-behavior inference
|
|
128
|
+
|
|
129
|
+
### Statistical Framework for Model Comparison
|
|
130
|
+
|
|
131
|
+
```
|
|
132
|
+
Model 1: Behavior ~ Lesion volume (baseline)
|
|
133
|
+
Model 2: Behavior ~ Lesion volume + VLSM ROI damage
|
|
134
|
+
Model 3: Behavior ~ Lesion volume + Tract disconnection
|
|
135
|
+
Model 4: Behavior ~ Lesion volume + Network disruption
|
|
136
|
+
Model 5: Behavior ~ Lesion volume + All levels
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
Compare using AIC/BIC or likelihood ratio tests to determine which level provides the best explanation.
|
|
140
|
+
|
|
141
|
+
## References
|
|
142
|
+
|
|
143
|
+
- Boes, A. D., et al. (2015). Network localization of neurological symptoms from focal brain lesions. *Brain*, 138(10), 3061--3075.
|
|
144
|
+
- Bubb, E. J., Metzler-Baddeley, C., & Aggleton, J. P. (2018). The cingulum bundle: Anatomy, function, and dysfunction. *Neuroscience & Biobehavioral Reviews*, 92, 104--127.
|
|
145
|
+
- Catani, M., & Mesulam, M. (2008). The arcuate fasciculus and the disconnection theme in language and aphasia. *Cortex*, 44(8), 953--961.
|
|
146
|
+
- Catani, M., et al. (2003). Occipito-temporal connections in the human brain. *Brain*, 126(9), 2093--2107.
|
|
147
|
+
- Duffau, H., et al. (2005). New insights into the anatomo-functional connectivity of the semantic system. *NeuroReport*, 16(13), 1461--1465.
|
|
148
|
+
- Foulon, C., et al. (2018). Advanced lesion symptom mapping analyses and implementation as BCBtoolkit. *GigaScience*, 7(3), giy004.
|
|
149
|
+
- Fox, M. D. (2018). Mapping symptoms to brain networks with the human connectome. *New England Journal of Medicine*, 379(23), 2237--2245.
|
|
150
|
+
- Gazzaniga, M. S. (2005). Forty-five years of split-brain research and still going strong. *Nature Reviews Neuroscience*, 6(8), 653--659.
|
|
151
|
+
- Thiebaut de Schotten, M., et al. (2011). A lateralized brain network for visuospatial attention. *Nature Neuroscience*, 14(10), 1245--1246.
|
|
152
|
+
- Thiebaut de Schotten, M., et al. (2015). Brain disconnections link structural connectivity with function and behaviour. *Nature Communications*, 6, 7462.
|