@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.
Files changed (229) hide show
  1. package/dist/index.d.ts +6 -0
  2. package/dist/index.d.ts.map +1 -0
  3. package/dist/index.js +28 -0
  4. package/dist/index.js.map +1 -0
  5. package/package.json +35 -0
  6. package/skills/01_Meta-Skills/contribute-skill/SKILL.md +277 -0
  7. package/skills/01_Meta-Skills/contribute-skills-via-pr/SKILL.md +163 -0
  8. package/skills/01_Meta-Skills/paper-to-skill/SKILL.md +435 -0
  9. package/skills/01_Meta-Skills/paper-to-skill/references/extraction-guide.md +286 -0
  10. package/skills/01_Meta-Skills/paper-to-skill/references/skill-template.md +250 -0
  11. package/skills/01_Meta-Skills/repo-to-skill/SKILL.md +289 -0
  12. package/skills/01_Meta-Skills/share-case/SKILL.md +253 -0
  13. package/skills/01_Meta-Skills/share-usage/README.md +63 -0
  14. package/skills/01_Meta-Skills/share-usage/SKILL.md +395 -0
  15. package/skills/01_Meta-Skills/verify-skill/SKILL.md +331 -0
  16. package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/SKILL.md +194 -0
  17. package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/references/effect-sizes.md +352 -0
  18. package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/references/sample-size-guide.md +407 -0
  19. package/skills/02_Cross-Domain_Foundation/cogsci-statistics/SKILL.md +361 -0
  20. package/skills/02_Cross-Domain_Foundation/cogsci-statistics/references/common-analyses.md +517 -0
  21. package/skills/02_Cross-Domain_Foundation/cogsci-visualization/SKILL.md +292 -0
  22. package/skills/02_Cross-Domain_Foundation/cogsci-visualization/references/plot-recipes.md +709 -0
  23. package/skills/02_Cross-Domain_Foundation/research-literacy/SKILL.md +286 -0
  24. package/skills/02_Cross-Domain_Foundation/research-literacy/references/common-assumptions.md +320 -0
  25. package/skills/02_Cross-Domain_Foundation/research-literacy/references/planning-template.md +143 -0
  26. package/skills/03_Cognitive_Psychology/alternative-uses-task-designer/SKILL.md +197 -0
  27. package/skills/03_Cognitive_Psychology/alternative-uses-task-designer/references/instruction-templates.md +60 -0
  28. package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/SKILL.md +246 -0
  29. package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/references/classic-paradigms.md +435 -0
  30. package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/references/design-principles.md +256 -0
  31. package/skills/03_Cognitive_Psychology/creativity-self-efficacy-mediation/SKILL.md +270 -0
  32. package/skills/03_Cognitive_Psychology/creativity-self-efficacy-mediation/references/lavaan-templates.md +172 -0
  33. package/skills/03_Cognitive_Psychology/divergent-thinking-scoring/SKILL.md +238 -0
  34. package/skills/03_Cognitive_Psychology/divergent-thinking-scoring/references/scoring-rubric.md +143 -0
  35. package/skills/03_Cognitive_Psychology/drift-diffusion-model/SKILL.md +203 -0
  36. package/skills/03_Cognitive_Psychology/drift-diffusion-model/references/fitting-guide.md +571 -0
  37. package/skills/03_Cognitive_Psychology/drift-diffusion-model/references/model-variants.md +427 -0
  38. package/skills/03_Cognitive_Psychology/evidence-accumulation-selector/SKILL.md +310 -0
  39. package/skills/03_Cognitive_Psychology/evidence-accumulation-selector/references/ez-diffusion-formulas.md +137 -0
  40. package/skills/03_Cognitive_Psychology/signal-detection-analysis/SKILL.md +300 -0
  41. package/skills/03_Cognitive_Psychology/signal-detection-analysis/references/application-guide.md +278 -0
  42. package/skills/03_Cognitive_Psychology/signal-detection-analysis/references/sdt-formulas.md +318 -0
  43. package/skills/03_Cognitive_Psychology/visual-search-array-generator/SKILL.md +283 -0
  44. package/skills/03_Cognitive_Psychology/visual-search-array-generator/references/array-generation-parameters.yaml +111 -0
  45. package/skills/04_Psycholinguistics/reading-time-analysis/SKILL.md +301 -0
  46. package/skills/04_Psycholinguistics/reading-time-analysis/references/measure-computation-guide.md +195 -0
  47. package/skills/04_Psycholinguistics/self-paced-reading-designer/SKILL.md +257 -0
  48. package/skills/04_Psycholinguistics/self-paced-reading-designer/references/analysis-guide.md +356 -0
  49. package/skills/04_Psycholinguistics/self-paced-reading-designer/references/region-segmentation.md +266 -0
  50. package/skills/04_Psycholinguistics/sentence-stimulus-norming/SKILL.md +346 -0
  51. package/skills/04_Psycholinguistics/sentence-stimulus-norming/references/lexical-databases-guide.md +184 -0
  52. package/skills/05_EEG_ERP/eeg-paradigm-designer/SKILL.md +226 -0
  53. package/skills/05_EEG_ERP/eeg-paradigm-designer/references/component-paradigm-map.md +276 -0
  54. package/skills/05_EEG_ERP/eeg-paradigm-designer/references/timing-parameters.md +244 -0
  55. package/skills/05_EEG_ERP/eeg-preprocessing-pipeline-guide/SKILL.md +367 -0
  56. package/skills/05_EEG_ERP/eeg-preprocessing-pipeline-guide/references/parameter-lookup-tables.md +138 -0
  57. package/skills/05_EEG_ERP/erp-analysis/SKILL.md +185 -0
  58. package/skills/05_EEG_ERP/erp-analysis/references/erp-components.md +447 -0
  59. package/skills/05_EEG_ERP/erp-analysis/references/preprocessing-pipeline.md +277 -0
  60. package/skills/05_EEG_ERP/erp-analysis/references/statistical-approaches.md +351 -0
  61. package/skills/05_EEG_ERP/mne-python-guide/SKILL.md +174 -0
  62. package/skills/05_EEG_ERP/mne-python-guide/references/decoding.md +178 -0
  63. package/skills/05_EEG_ERP/mne-python-guide/references/io_formats.md +160 -0
  64. package/skills/05_EEG_ERP/mne-python-guide/references/preprocessing.md +259 -0
  65. package/skills/05_EEG_ERP/mne-python-guide/references/simulation.md +173 -0
  66. package/skills/05_EEG_ERP/mne-python-guide/references/source_localization.md +234 -0
  67. package/skills/05_EEG_ERP/mne-python-guide/references/statistics.md +196 -0
  68. package/skills/05_EEG_ERP/mne-python-guide/references/time_frequency.md +165 -0
  69. package/skills/05_EEG_ERP/mne-python-guide/references/visualization.md +175 -0
  70. package/skills/06_fMRI_Neuroimaging/brain-connectivity-modeler/SKILL.md +317 -0
  71. package/skills/06_fMRI_Neuroimaging/brain-connectivity-modeler/references/method-implementation-guide.md +116 -0
  72. package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/SKILL.md +296 -0
  73. package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/references/design-matrix-guide.md +214 -0
  74. package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/references/statistical-inference.md +288 -0
  75. package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/SKILL.md +274 -0
  76. package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/references/quality-control.md +336 -0
  77. package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/references/step-by-step-pipeline.md +380 -0
  78. package/skills/06_fMRI_Neuroimaging/fmri-task-design-guide/SKILL.md +264 -0
  79. package/skills/06_fMRI_Neuroimaging/fmri-task-design-guide/references/design-optimization-examples.md +114 -0
  80. package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/SKILL.md +273 -0
  81. package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/references/decoding-methods.md +170 -0
  82. package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/references/rsa-guide.md +266 -0
  83. package/skills/06_fMRI_Neuroimaging/pycortex-guide/SKILL.md +123 -0
  84. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/database-subjects.md +179 -0
  85. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/dataset-types.md +208 -0
  86. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/freesurfer-fmriprep.md +162 -0
  87. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/mapping-transforms.md +181 -0
  88. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/mni-utils.md +207 -0
  89. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/surface-analysis.md +219 -0
  90. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/visualization.md +251 -0
  91. package/skills/07_Computational_Modeling/act-r-model-builder/SKILL.md +297 -0
  92. package/skills/07_Computational_Modeling/act-r-model-builder/references/model-patterns.md +197 -0
  93. package/skills/07_Computational_Modeling/act-r-model-builder/references/parameter-table.yaml +204 -0
  94. package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/SKILL.md +294 -0
  95. package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/references/diagnostics-checklist.md +351 -0
  96. package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/references/prior-selection-guide.md +241 -0
  97. package/skills/07_Computational_Modeling/parameter-recovery-checker/SKILL.md +269 -0
  98. package/skills/07_Computational_Modeling/parameter-recovery-checker/references/recovery-diagnostics.md +207 -0
  99. package/skills/08_Computational_Neuroscience/brain-connectivity-modeler/SKILL.md +317 -0
  100. package/skills/08_Computational_Neuroscience/brain-connectivity-modeler/references/method-implementation-guide.md +116 -0
  101. package/skills/08_Computational_Neuroscience/neural-decoding-analysis/SKILL.md +273 -0
  102. package/skills/08_Computational_Neuroscience/neural-decoding-analysis/references/decoding-methods.md +170 -0
  103. package/skills/08_Computational_Neuroscience/neural-decoding-analysis/references/rsa-guide.md +266 -0
  104. package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/SKILL.md +305 -0
  105. package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/references/data-requirements.md +60 -0
  106. package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/references/method-comparison.md +151 -0
  107. package/skills/08_Computational_Neuroscience/spiking-network-model-builder/SKILL.md +376 -0
  108. package/skills/08_Computational_Neuroscience/spiking-network-model-builder/references/hh-parameters.md +117 -0
  109. package/skills/08_Computational_Neuroscience/spiking-network-model-builder/references/network-regimes.md +130 -0
  110. package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/SKILL.md +258 -0
  111. package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/references/indicator-parameters.md +242 -0
  112. package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/references/pipeline-details.md +211 -0
  113. package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/SKILL.md +261 -0
  114. package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/references/opsin-catalog.md +124 -0
  115. package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/references/stimulation-parameters.md +304 -0
  116. package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/SKILL.md +367 -0
  117. package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/references/disconnection-guide.md +152 -0
  118. package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/references/vlsm-pipeline.md +182 -0
  119. package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/SKILL.md +250 -0
  120. package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/references/deficit-profiles.md +302 -0
  121. package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/references/test-catalog.md +304 -0
  122. package/skills/11_Developmental_Cognition/infant-looking-time-designer/SKILL.md +345 -0
  123. package/skills/11_Developmental_Cognition/infant-looking-time-designer/references/age-parameters.yaml +186 -0
  124. package/skills/12_Social_Cognition/tom-task-selector/SKILL.md +379 -0
  125. package/skills/12_Social_Cognition/tom-task-selector/references/task-database.md +317 -0
  126. package/skills/13_Visualization/nature-figure/README.md +442 -0
  127. package/skills/13_Visualization/nature-figure/SKILL.md +60 -0
  128. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-01-bar-charts.png +0 -0
  129. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-02-line-trends.png +0 -0
  130. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-03-heatmaps.png +0 -0
  131. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-04-scatter-bubble.png +0 -0
  132. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-05-radar-polar.png +0 -0
  133. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-06-distributions.png +0 -0
  134. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-07-forest-interval.png +0 -0
  135. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-08-area-stacked.png +0 -0
  136. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-09-image-plates.png +0 -0
  137. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-10-network-matrix.png +0 -0
  138. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_motivation.png +0 -0
  139. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_observation.png +0 -0
  140. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_observation_distillation.png +0 -0
  141. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_contrastive.png +0 -0
  142. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_results_CEDAR.png +0 -0
  143. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_results_IEDB.png +0 -0
  144. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_schematic.png +0 -0
  145. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/RNAGenScape_schematic.png +0 -0
  146. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/figures/ablation.png +0 -0
  147. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/figures/comparison.png +0 -0
  148. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/plot_ablation.py +86 -0
  149. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/plot_comparison.py +109 -0
  150. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/diffusion_swiss_roll.py +97 -0
  151. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/diffusion_swiss_roll.png +0 -0
  152. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_GeneRegulatory.pdf +0 -0
  153. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_GeneRegulatory.png +0 -0
  154. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_Trajectory.pdf +0 -0
  155. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_Trajectory.png +0 -0
  156. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/figX_comparison_Ablation.pdf +0 -0
  157. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/figX_comparison_Ablation.png +0 -0
  158. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_Ablation.py +64 -0
  159. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_GeneRegulatory.py +74 -0
  160. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_Trajectory.py +74 -0
  161. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/figures/idea.png +0 -0
  162. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/figures/illustration.png +0 -0
  163. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/plot_idea.py +76 -0
  164. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/plot_illustration.py +404 -0
  165. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_FPGM/figures/freq_prior.png +0 -0
  166. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_FPGM/plot_freq_prior.py +146 -0
  167. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_ablation_Cancer.png +0 -0
  168. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_ablation_IEDB.png +0 -0
  169. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_comparison_Cancer.png +0 -0
  170. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_comparison_IEDB.png +0 -0
  171. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/plot_bars.py +216 -0
  172. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/raw_data.py +125 -0
  173. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/manifold.png +0 -0
  174. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/manifold_holes.png +0 -0
  175. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_comparison_optimization.png +0 -0
  176. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_comparison_speed.png +0 -0
  177. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_sweep.png +0 -0
  178. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_comparison.py +228 -0
  179. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_hole_manifold.py +82 -0
  180. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_manifold.py +61 -0
  181. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_sweep.py +77 -0
  182. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/figures/comparison_posttraining.png +0 -0
  183. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/figures/comparison_radar.png +0 -0
  184. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/plot_comparison_radar.py +173 -0
  185. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/plot_posttraining.py +82 -0
  186. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/brute_force.png +0 -0
  187. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/correctness_by_category.png +0 -0
  188. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/correctness_by_subcategory.png +0 -0
  189. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/rewriting.png +0 -0
  190. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/selfcorrection_math.png +0 -0
  191. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_brute_force.py +248 -0
  192. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_correctness_by_category.py +132 -0
  193. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_correctness_by_subcategory.py +131 -0
  194. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_rewriting.py +105 -0
  195. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_selfcorrection_math.py +99 -0
  196. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/figures/composition_heatmap.png +0 -0
  197. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/figures/trend_by_month.png +0 -0
  198. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/plot_composition.py +81 -0
  199. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/plot_trend.py +125 -0
  200. package/skills/13_Visualization/nature-figure/assets/gallery/fig1-material-mechanism-rich.png +0 -0
  201. package/skills/13_Visualization/nature-figure/assets/gallery/fig2-spatial-imaging-rich.png +0 -0
  202. package/skills/13_Visualization/nature-figure/assets/gallery/fig3-in-vivo-efficacy-rich.png +0 -0
  203. package/skills/13_Visualization/nature-figure/assets/gallery/fig4-single-cell-systems-rich.png +0 -0
  204. package/skills/13_Visualization/nature-figure/assets/gallery/fig5-validation-perturbation-rich.png +0 -0
  205. package/skills/13_Visualization/nature-figure/evals/evals.json +37 -0
  206. package/skills/13_Visualization/nature-figure/manifest.yaml +57 -0
  207. package/skills/13_Visualization/nature-figure/references/api.md +428 -0
  208. package/skills/13_Visualization/nature-figure/references/backend-selection.md +100 -0
  209. package/skills/13_Visualization/nature-figure/references/chart-types.md +281 -0
  210. package/skills/13_Visualization/nature-figure/references/common-patterns.md +350 -0
  211. package/skills/13_Visualization/nature-figure/references/demos.md +65 -0
  212. package/skills/13_Visualization/nature-figure/references/design-theory.md +436 -0
  213. package/skills/13_Visualization/nature-figure/references/figure-contract.md +93 -0
  214. package/skills/13_Visualization/nature-figure/references/nature-2026-observations.md +112 -0
  215. package/skills/13_Visualization/nature-figure/references/qa-contract.md +119 -0
  216. package/skills/13_Visualization/nature-figure/references/r-template-index.md +66 -0
  217. package/skills/13_Visualization/nature-figure/references/r-workflow.md +161 -0
  218. package/skills/13_Visualization/nature-figure/references/tutorials.md +251 -0
  219. package/skills/13_Visualization/nature-figure/static/core/contract.md +29 -0
  220. package/skills/13_Visualization/nature-figure/static/core/stance.md +37 -0
  221. package/skills/13_Visualization/nature-figure/static/fragments/backend/python.md +37 -0
  222. package/skills/13_Visualization/nature-figure/static/fragments/backend/r.md +44 -0
  223. package/skills/14_Writing/markdown-report-writing/SKILL.md +306 -0
  224. package/skills/14_Writing/markdown-report-writing/references/compatibility-matrix.md +72 -0
  225. package/skills/14_Writing/markdown-report-writing/references/templates.md +299 -0
  226. package/skills/15_Others/neuroimaging-power-guide/SKILL.md +324 -0
  227. package/skills/15_Others/neuroimaging-power-guide/references/effect-size-lookup-tables.md +102 -0
  228. package/skills/15_Others/neuroimaging-sample-size-calculator/SKILL.md +330 -0
  229. package/skills/15_Others/neuroimaging-sample-size-calculator/references/worked-examples.md +220 -0
@@ -0,0 +1,299 @@
1
+ # Markdown Report Templates (Annotated)
2
+
3
+ ## 1. Project Report Template
4
+
5
+ ```md
6
+ ---
7
+ title: Project Name
8
+ author: Team / Agent
9
+ date: YYYY-MM-DD
10
+ tags: [project, report]
11
+ ---
12
+
13
+ # Project Name
14
+
15
+ > One-line summary: this report covers project background, current progress, key risks, and next steps.
16
+
17
+ ## Executive Summary
18
+
19
+ - Background:
20
+ - Current phase:
21
+ - Completed:
22
+ - Key risks:
23
+ - Next steps:
24
+
25
+ ## Project Background
26
+
27
+ ### Business Context
28
+
29
+ ### Problem Definition
30
+
31
+ ### Success Criteria
32
+
33
+ ## Project Scope
34
+
35
+ ### In Scope
36
+
37
+ - [x] Feature A
38
+ - [x] Feature B
39
+ - [ ] Feature C
40
+
41
+ ### Out of Scope
42
+
43
+ - Item 1
44
+ - Item 2
45
+
46
+ ## Architecture & Design
47
+
48
+ ![System architecture diagram](./assets/fig-system.svg)
49
+
50
+ *Figure: Overall system architecture.*
51
+
52
+ ### Core Modules
53
+
54
+ | Module | Responsibility | Input | Output |
55
+ |---|---|---|---|
56
+ | Data Layer | Data ingestion | Raw data | Standardized data |
57
+ | Service Layer | Analysis pipeline | Standardized data | Intermediate results |
58
+ | Presentation Layer | Output rendering | Intermediate results | Reports & charts |
59
+
60
+ ### Key Workflow
61
+
62
+ ​```mermaid
63
+ flowchart LR
64
+ A[Requirements] --> B[Design]
65
+ B --> C[Implementation]
66
+ C --> D[Testing]
67
+ D --> E[Delivery & Review]
68
+ ​```
69
+
70
+ ## Current Progress
71
+
72
+ | Item | Owner | Status | Notes |
73
+ |---|---|---|---|
74
+ | Requirements confirmed | @owner | Complete | Frozen |
75
+ | Data integration | @owner | In Progress | Awaiting API |
76
+ | Report template | @owner | Complete | Mermaid + footnotes |
77
+ | Release prep | @owner | Not Started | Depends on sign-off |
78
+
79
+ ## Risks & Mitigation
80
+
81
+ | Risk | Impact | Likelihood | Mitigation |
82
+ |---|---|---|---|
83
+ | Data inconsistency | High | Medium | Field mapping checks |
84
+ | Broken asset links | Medium | Medium | Relative paths + CI validation |
85
+ | Scope creep | Medium | High | Change freeze window |
86
+
87
+ ## Conclusion & Next Steps
88
+
89
+ ### Conclusion
90
+
91
+ ### Next Actions
92
+
93
+ - [ ] Complete integration
94
+ - [ ] Update diagrams
95
+ - [ ] Validate links
96
+ - [ ] Publish v1 report
97
+
98
+ ## Appendix
99
+
100
+ - [Detailed design doc](./docs/design.md)
101
+ - [Data dictionary](./docs/data-dictionary.md)
102
+ - [System architecture SVG](./assets/fig-system.svg)
103
+
104
+ ## Footnotes
105
+
106
+ Example terminology[^scope].
107
+
108
+ [^scope]: Scope freeze means no new high-impact requirements are introduced past the agreed cutoff date.
109
+ ```
110
+
111
+ ---
112
+
113
+ ## 2. Experiment Report Template
114
+
115
+ ```md
116
+ ---
117
+ title: Experiment Name
118
+ author: Researcher / Agent
119
+ date: YYYY-MM-DD
120
+ tags: [experiment, report]
121
+ ---
122
+
123
+ # Experiment Name
124
+
125
+ > One-line summary: what was tested, with what method, and what was found.
126
+
127
+ ## Executive Summary
128
+
129
+ - Hypothesis:
130
+ - Method:
131
+ - Key results:
132
+ - Conclusion:
133
+
134
+ ## Research Questions & Hypotheses
135
+
136
+ ### Research Question
137
+
138
+ ### Hypothesis
139
+
140
+ ## Experimental Setup
141
+
142
+ ### Environment
143
+
144
+ | Item | Value |
145
+ |---|---|
146
+ | OS | |
147
+ | Software version | |
148
+ | Dataset | |
149
+ | Time range | |
150
+
151
+ ### Variables
152
+
153
+ | Type | Variable | Description |
154
+ |---|---|---|
155
+ | Independent | | |
156
+ | Dependent | | |
157
+ | Controlled | | |
158
+
159
+ ## Procedure
160
+
161
+ 1. Data preparation
162
+ 2. Parameter configuration
163
+ 3. Experiment execution
164
+ 4. Result recording
165
+ 5. Statistical analysis
166
+
167
+ ​```mermaid
168
+ flowchart TD
169
+ A[Data Prep] --> B[Execution]
170
+ B --> C[Recording]
171
+ C --> D[Analysis]
172
+ D --> E[Conclusion]
173
+ ​```
174
+
175
+ ## Results
176
+
177
+ ### Results Table
178
+
179
+ | Method | Metric A | Metric B | Notes |
180
+ |---|---:|---:|---|
181
+ | Baseline | | | |
182
+ | Method-1 | | | |
183
+ | Method-2 | | | |
184
+
185
+ ### Charts
186
+
187
+ ![Results comparison chart](./assets/fig-results.svg)
188
+
189
+ *Figure: Results comparison across methods.*
190
+
191
+ ## Discussion
192
+
193
+ ### Interpretation
194
+
195
+ ### Error Sources
196
+
197
+ ### Limitations
198
+
199
+ ## Reproducibility
200
+
201
+ - [Experiment script](./code/run.py)
202
+ - [Config file](./configs/exp.yaml)
203
+ - [Raw results](./results/raw.csv)
204
+
205
+ ## Conclusion
206
+
207
+ ## Footnotes
208
+
209
+ Terminology[^metric].
210
+
211
+ [^metric]: Metric A is the primary evaluation metric; higher is better.
212
+ ```
213
+
214
+ ---
215
+
216
+ ## 3. README Template
217
+
218
+ ```md
219
+ # Project Name
220
+
221
+ > One-line description of the problem this solves and its core value.
222
+
223
+ [Quick Start](#quick-start) · [Docs](./docs/index.md) · [Changelog](./CHANGELOG.md) · [License](./LICENSE)
224
+
225
+ ## About
226
+
227
+ What this project is, who it's for, and how it differs from alternatives.
228
+
229
+ ## Features
230
+
231
+ - Feature A
232
+ - Feature B
233
+ - Feature C
234
+
235
+ ## Project Structure
236
+
237
+ | Path | Description |
238
+ |---|---|
239
+ | `src/` | Core source code |
240
+ | `docs/` | Detailed documentation |
241
+ | `assets/` | Images and diagrams |
242
+ | `examples/` | Example inputs and outputs |
243
+
244
+ ## Quick Start
245
+
246
+ ### Installation
247
+
248
+ ​```bash
249
+ # install command
250
+ ​```
251
+
252
+ ### Usage
253
+
254
+ ​```bash
255
+ # run command
256
+ ​```
257
+
258
+ ### Example
259
+
260
+ ​```bash
261
+ # example command
262
+ ​```
263
+
264
+ ## How It Works
265
+
266
+ ​```mermaid
267
+ flowchart LR
268
+ A[Install] --> B[Configure]
269
+ B --> C[Run]
270
+ C --> D[View Results]
271
+ ​```
272
+
273
+ ### Input & Output
274
+
275
+ | Type | Path | Description |
276
+ |---|---|---|
277
+ | Input | `examples/input.json` | Sample input |
278
+ | Output | `examples/output.md` | Sample output |
279
+
280
+ ## Documentation
281
+
282
+ - [User Guide](./docs/user-guide.md)
283
+ - [Developer Guide](./docs/developer-guide.md)
284
+ - [FAQ](./docs/faq.md)
285
+
286
+ ## Roadmap
287
+
288
+ - [ ] Release v1.0
289
+ - [ ] Plugin system
290
+ - [ ] Documentation site
291
+
292
+ ## Contributing
293
+
294
+ Issues and pull requests welcome. Please read [CONTRIBUTING.md](./CONTRIBUTING.md) first.
295
+
296
+ ## License
297
+
298
+ This project is licensed under [MIT License](./LICENSE).
299
+ ```
@@ -0,0 +1,324 @@
1
+ ---
2
+ name: "neuroimaging-power-guide"
3
+ description: "Sample-size planning for fMRI/EEG studies using effect-size benchmarks and simulation-based power"
4
+ domain: "cross-cutting-methodology"
5
+ version: "1.0.0"
6
+ authors:
7
+ - "awesome_cognitive_and_neuroscience_skills contributors"
8
+ papers:
9
+ - "Button et al., 2013"
10
+ - "Poldrack et al., 2017"
11
+ - "Marek et al., 2022"
12
+ - "Mumford & Nichols, 2008"
13
+ - "Boudewyn et al., 2018"
14
+ - "Desmond & Glover, 2002"
15
+ - "Elliott et al., 2020"
16
+ dependencies:
17
+ required:
18
+ - research-literacy
19
+ recommended:
20
+ - cogsci-power-analysis
21
+ - fmri-glm-analysis-guide
22
+ review_status: "ai-generated"
23
+ ---
24
+
25
+ # Neuroimaging Power Guide
26
+
27
+ ## Purpose
28
+
29
+ Statistical power in neuroimaging is fundamentally different from power in behavioral research. The massive multiple comparisons problem (testing ~100,000 voxels simultaneously), spatial correlation structure, and non-standard test statistics mean that standard power formulas underestimate required sample sizes. Meanwhile, the field has historically been severely underpowered: the median fMRI study has only ~20% power to detect a typical effect (Button et al., 2013).
30
+
31
+ A competent programmer without neuroimaging training would apply standard power calculations (e.g., G*Power for a t-test) without accounting for multiple comparison correction, would not know typical effect sizes in neuroimaging, and would dramatically underestimate the sample sizes needed. This skill encodes the domain-specific knowledge for neuroimaging power analysis.
32
+
33
+ ## When to Use This Skill
34
+
35
+ - Planning sample size for a new fMRI, EEG, or MEG study
36
+ - Estimating power for grant applications or registered reports
37
+ - Determining whether a published study was adequately powered
38
+ - Choosing between ROI-based and whole-brain analysis based on power constraints
39
+ - Evaluating the reliability implications of sample size choices
40
+
41
+ ## Research Planning Protocol
42
+
43
+ Before executing the domain-specific steps below, you MUST:
44
+
45
+ 1. **State the research question** — What specific question is this analysis/paradigm addressing?
46
+ 2. **Justify the method choice** — Why is this approach appropriate? What alternatives were considered?
47
+ 3. **Declare expected outcomes** — What results would support vs. refute the hypothesis?
48
+ 4. **Note assumptions and limitations** — What does this method assume? Where could it mislead?
49
+ 5. **Present the plan to the user and WAIT for confirmation** before proceeding.
50
+
51
+ For detailed methodology guidance, see the `research-literacy` skill.
52
+
53
+
54
+ ## ⚠️ Verification Notice
55
+
56
+ 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).
57
+
58
+ ## Why Neuroimaging Power Is Different
59
+
60
+ Standard power analysis assumes a single statistical test. Neuroimaging involves:
61
+
62
+ | Challenge | Impact on Power | Source |
63
+ |---|---|---|
64
+ | Massive multiple comparisons | ~100,000 voxels tested; correction reduces sensitivity by orders of magnitude | Nichols & Hayasaka, 2003 |
65
+ | Spatial smoothness | Adjacent voxels are correlated, reducing effective number of independent tests but complicating power calculation | Worsley et al., 1996 |
66
+ | Multi-level inference | Subject-level estimation + group-level test; both levels contribute noise | Mumford & Nichols, 2008 |
67
+ | Effect size variability | Effects vary across voxels, regions, and subjects; no single "effect size" characterizes a study | Poldrack et al., 2017 |
68
+ | Threshold-dependent power | Power depends heavily on the statistical threshold (corrected vs. uncorrected) and correction method | Hayasaka et al., 2007 |
69
+
70
+ **Key implication**: A standard G*Power calculation for a two-sample t-test will dramatically overestimate the power of a whole-brain fMRI analysis because it ignores multiple comparison correction (Mumford & Nichols, 2008).
71
+
72
+ ## Typical Effect Sizes in Neuroimaging
73
+
74
+ ### fMRI Effect Sizes
75
+
76
+ | Analysis Type | Typical Effect Size | Unit | Source |
77
+ |---|---|---|---|
78
+ | Task activation (voxel-level) | Cohen's d = **0.5-1.0** | Standardized mean difference | Poldrack et al., 2017 |
79
+ | Task activation (ROI-level) | Cohen's d = **0.5-1.5** | Standardized mean difference | Poldrack et al., 2017 |
80
+ | Between-group difference (voxel) | Cohen's d = **0.3-0.8** | Standardized mean difference | Poldrack et al., 2017 |
81
+ | Functional connectivity (correlation) | r = **0.2-0.5** | Pearson correlation | Marek et al., 2022 |
82
+ | Brain-behavior association | r = **0.1-0.3** | Pearson correlation | Marek et al., 2022 |
83
+ | Brain-wide association (replicable) | r < **0.05** at N < 1000 | Pearson correlation | Marek et al., 2022 |
84
+
85
+ **Critical finding**: Marek et al. (2022) demonstrated that brain-behavior correlations in typical neuroimaging samples (N < 100) are severely inflated. Replicable brain-behavior associations require **N > 2,000** for whole-brain analyses.
86
+
87
+ ### EEG/ERP Effect Sizes
88
+
89
+ | Analysis Type | Typical Effect Size | Source |
90
+ |---|---|---|
91
+ | ERP component amplitude (e.g., N400, P300) | Cohen's d = **0.3-0.8** | Boudewyn et al., 2018 |
92
+ | ERP latency differences | Cohen's d = **0.2-0.5** | Luck, 2014 |
93
+ | EEG oscillatory power | Cohen's d = **0.3-0.6** | Cohen, 2014 |
94
+ | EEG connectivity (coherence/PLV) | Cohen's d = **0.2-0.5** | Cohen, 2014 |
95
+
96
+ ## Sample Size Benchmarks
97
+
98
+ ### fMRI Sample Size Recommendations
99
+
100
+ | Design | Minimum N | Recommended N | Assumptions | Source |
101
+ |---|---|---|---|---|
102
+ | Within-subject task activation | **20** | **25-30** | Large effect (d > 0.8), lenient correction | Desmond & Glover, 2002 |
103
+ | Between-group comparison (large effect, d = 0.8) | **20 per group** | **25-30 per group** | Whole-brain, cluster-corrected | Thirion et al., 2007 |
104
+ | Between-group comparison (medium effect, d = 0.5) | **40 per group** | **50+ per group** | Whole-brain, cluster-corrected | Thirion et al., 2007; Poldrack et al., 2017 |
105
+ | Resting-state individual differences | **25+** | **50+** (much more for replicability) | Depends on reliability of measure | Marek et al., 2022 |
106
+ | Brain-behavior correlations | **100+** | **N > 2,000** for replicable whole-brain | Large-scale only | Marek et al., 2022 |
107
+ | ROI-based analysis (a priori) | **15-20** | **25+** | Single ROI, no whole-brain correction | Desmond & Glover, 2002 |
108
+
109
+ ### EEG/ERP Sample Size Recommendations
110
+
111
+ | Design | Minimum per Condition | Recommended per Condition | Source |
112
+ |---|---|---|---|
113
+ | ERP trials per condition per subject | **30** | **40-60** | Boudewyn et al., 2018 |
114
+ | ERP between-group (medium d = 0.5) | **34 per group** | **50+ per group** | Boudewyn et al., 2018 |
115
+ | ERP within-subject (medium d = 0.5) | **25 subjects** | **30+ subjects** | Luck, 2014 |
116
+ | Time-frequency analysis | **40 trials** | **60+ trials** | Cohen, 2014 |
117
+
118
+ ### Power at Common Sample Sizes
119
+
120
+ | N (per group) | Power for d = 0.5 (uncorrected) | Power for d = 0.5 (corrected, whole-brain) | Power for d = 0.8 (corrected) |
121
+ |---|---|---|---|
122
+ | 10 | ~26% | < 10% | ~25% |
123
+ | 20 | ~50% | ~20% | ~50% |
124
+ | 30 | ~70% | ~35% | ~70% |
125
+ | 40 | ~82% | ~50% | ~85% |
126
+ | 60 | ~94% | ~70% | ~95% |
127
+
128
+ Values are approximate, based on simulations from Mumford & Nichols (2008) and Desmond & Glover (2002). Exact power depends on design, smoothness, effect spatial extent, and correction method.
129
+
130
+ ## Power Decision Tree
131
+
132
+ ```
133
+ What type of analysis are you planning?
134
+ |
135
+ +-- Whole-brain voxelwise analysis
136
+ | |
137
+ | +-- Within-subject (one-sample t-test)
138
+ | | --> Minimum N = 20; aim for N = 25-30
139
+ | | (Desmond & Glover, 2002)
140
+ | |
141
+ | +-- Between-group comparison
142
+ | | |
143
+ | | +-- Large expected effect (d > 0.8)
144
+ | | | --> N = 20-25 per group (Thirion et al., 2007)
145
+ | | |
146
+ | | +-- Medium expected effect (d = 0.5)
147
+ | | | --> N = 40-50 per group (Poldrack et al., 2017)
148
+ | | |
149
+ | | +-- Small expected effect (d = 0.3)
150
+ | | --> N = 80+ per group; consider ROI approach
151
+ | |
152
+ | +-- Brain-behavior correlation
153
+ | --> N = 100+ minimum; N > 2,000 for replicability
154
+ | (Marek et al., 2022)
155
+ |
156
+ +-- ROI-based analysis (a priori regions)
157
+ | --> Use standard power formulas (G*Power) with expected
158
+ | effect size from literature or pilot data.
159
+ | No multiple comparison correction needed for single ROI.
160
+ | N = 15-30 typical for medium-large effects.
161
+ |
162
+ +-- ERP analysis
163
+ |
164
+ +-- Between-group
165
+ | --> 30-50 per group for medium effects
166
+ | (Boudewyn et al., 2018)
167
+ |
168
+ +-- Within-subject
169
+ --> 25-30 subjects, 30+ trials per condition
170
+ (Boudewyn et al., 2018; Luck, 2014)
171
+ ```
172
+
173
+ ## Simulation-Based Power Approaches
174
+
175
+ ### fMRIpower (Mumford & Nichols, 2008)
176
+
177
+ Estimates power using pilot group-level activation maps:
178
+
179
+ 1. Run a pilot study (or use published results) to obtain group-level statistical maps
180
+ 2. Estimate effect sizes at each voxel from the pilot data
181
+ 3. Simulate new datasets with varying N by resampling from the estimated effect size and variance
182
+ 4. Apply the full statistical pipeline (including multiple comparison correction) to each simulation
183
+ 5. Power = proportion of simulations that detect the effect at a given ROI or voxel
184
+
185
+ **Requirements**: Pilot data from at least **10-15 subjects** for stable variance estimates (Mumford & Nichols, 2008)
186
+
187
+ ### NeuroPowerTools (Durnez et al., 2016)
188
+
189
+ Web-based tool for peak-based power estimation:
190
+
191
+ 1. Upload an unthresholded statistical map from a pilot or published study
192
+ 2. The tool fits a mixture model to the peak distribution (null + alternative)
193
+ 3. Estimates the proportion of truly active voxels and their average effect size
194
+ 4. Computes power for new studies with varying N and thresholds
195
+
196
+ **Advantage**: Does not require individual subject data; can use published group maps
197
+ **URL**: https://neuropowertools.org
198
+
199
+ ### Permutation-Based Power (Hayasaka et al., 2007)
200
+
201
+ 1. Generate simulated datasets under the alternative hypothesis using effect size maps from pilot data
202
+ 2. For each simulated dataset, run a full permutation test (5,000+ permutations)
203
+ 3. Compute power as the proportion of simulations in which the permutation test rejects the null
204
+
205
+ **Advantage**: Fully nonparametric; accounts for the exact multiple comparison correction used
206
+ **Disadvantage**: Computationally expensive (requires running thousands of permutation tests per power estimate)
207
+
208
+ ### PowerMap (Joyce & Hayasaka, 2012)
209
+
210
+ Simulation-based power using parametric assumptions:
211
+
212
+ 1. Specify effect size map (from pilot data or assumed values)
213
+ 2. Specify noise model (based on residuals from pilot data)
214
+ 3. Simulate datasets with varying N
215
+ 4. Apply parametric statistical testing with specified correction method
216
+ 5. Estimate power at each voxel
217
+
218
+ ## Multiple Comparison Correction Impact on Power
219
+
220
+ The choice of correction method dramatically affects required sample size:
221
+
222
+ | Correction Method | Effective Alpha per Voxel | Relative Power | Source |
223
+ |---|---|---|---|
224
+ | None (p < 0.001 uncorrected) | 0.001 | **Highest** (but invalid inference) | -- |
225
+ | FDR q < 0.05 | ~0.0001-0.001 (data-dependent) | Moderate-High | Genovese et al., 2002 |
226
+ | Cluster-based (CDT p < 0.001) | Depends on cluster size | Moderate-High for large effects | Eklund et al., 2016 |
227
+ | Voxelwise FWE (RFT, p < 0.05) | ~0.00000005 | Low | Worsley et al., 1996 |
228
+ | TFCE + permutation | Varies | Moderate | Smith & Nichols, 2009 |
229
+
230
+ **Domain insight**: Switching from voxelwise FWE to cluster-based or FDR correction can increase power by **50-200%** for the same sample size, because these methods exploit the spatial extent of true activations (Nichols & Hayasaka, 2003).
231
+
232
+ ## Test-Retest Reliability and Power
233
+
234
+ For individual differences designs (correlating brain measures with behavior), reliability of the brain measure is critical (Elliott et al., 2020):
235
+
236
+ | Measure | Typical ICC | Implication | Source |
237
+ |---|---|---|---|
238
+ | Task fMRI activation (ROI) | **0.3-0.6** | Poor to moderate reliability | Elliott et al., 2020 |
239
+ | Resting-state connectivity | **0.3-0.7** | Moderate reliability; depends on scan duration | Elliott et al., 2020 |
240
+ | ERP amplitude | **0.5-0.8** | Moderate to good | Cassidy et al., 2012 |
241
+ | EEG oscillatory power | **0.6-0.9** | Good to excellent | Cohen, 2014 |
242
+
243
+ **Critical formula**: The maximum detectable correlation between brain and behavior is bounded by the reliabilities of both measures:
244
+
245
+ ```
246
+ r_observed_max = r_true * sqrt(reliability_brain * reliability_behavior)
247
+ ```
248
+
249
+ With brain ICC = 0.5 and behavior reliability = 0.8, even a true correlation of r = 0.5 would appear as r = 0.5 * sqrt(0.5 * 0.8) = **0.32** on average (Elliott et al., 2020). This attenuation means far larger samples are needed.
250
+
251
+ **Recommendation**: For individual differences designs, collect longer scan sessions (at least **20-30 minutes** of resting-state data; Birn et al., 2013) or use multi-session data to improve reliability.
252
+
253
+ ## Practical Power Calculation Workflow
254
+
255
+ ### For a New fMRI Study
256
+
257
+ 1. **Define the primary analysis**: Whole-brain voxelwise or ROI-based?
258
+ 2. **Estimate effect size**:
259
+ - From pilot data (preferred): extract effect sizes from pilot activation maps
260
+ - From literature: find the most comparable published study; correct for publication bias by assuming the true effect is **~50-75%** of the published estimate (Button et al., 2013)
261
+ - From meta-analysis: use NeuroSynth or BrainMap to estimate typical activation strength
262
+ 3. **Choose the power analysis tool**:
263
+ - ROI-based: Standard power calculation (G*Power) using the estimated effect size at the ROI
264
+ - Whole-brain: fMRIpower, NeuroPowerTools, or simulation
265
+ 4. **Set target power**: **80%** (conventional) or **90%** (recommended for costly neuroimaging studies)
266
+ 5. **Account for attrition**: Add **10-20%** to planned N for participant exclusions due to excessive motion, incomplete data, or technical failures
267
+ 6. **Report**: Effect size source, power tool used, correction method, target power, final N
268
+
269
+ ### For a New EEG/ERP Study
270
+
271
+ 1. **Estimate effect size**: From pilot data or published ERP studies (see effect size table above)
272
+ 2. **Determine trial count**: At least **30 trials per condition** post-rejection (Boudewyn et al., 2018)
273
+ 3. **Plan for trial attrition**: Assume **20-30%** trial rejection rate; collect accordingly
274
+ 4. **Subject-level power**: Use G*Power with the estimated within- or between-subject effect size
275
+ 5. **Account for subject attrition**: Add **15-20%** for exclusions due to excessive artifacts
276
+
277
+ ## Common Pitfalls
278
+
279
+ 1. **Using uncorrected power estimates for whole-brain analyses**: A study with 80% power at p < 0.001 uncorrected has far less than 80% power after FWE or FDR correction (Mumford & Nichols, 2008)
280
+ 2. **Ignoring effect size inflation in pilot studies**: Small pilot studies produce inflated effect sizes due to the "winner's curse." Assume the true effect is **50-75%** of the pilot estimate (Button et al., 2013)
281
+ 3. **Applying behavioral power formulas to neuroimaging**: Standard t-test power calculations dramatically overestimate power for whole-brain analyses because they ignore multiple comparison correction
282
+ 4. **Not accounting for participant attrition**: In fMRI, **10-20%** of participants may be excluded due to motion, scanner artifacts, or incomplete data. Over-recruit accordingly
283
+ 5. **Ignoring reliability for individual differences**: Brain measures with ICC < 0.5 attenuate correlations, requiring much larger samples than traditional power analysis suggests (Elliott et al., 2020)
284
+ 6. **Assuming published sample sizes are adequate**: Most published fMRI studies are underpowered (median power ~20%; Button et al., 2013). Do not use published N as a benchmark
285
+ 7. **Neglecting the impact of design efficiency**: An optimized event-related design can be 2-3x more efficient than a suboptimal one (Dale, 1999), effectively increasing power without adding subjects
286
+
287
+ ## Minimum Reporting Checklist
288
+
289
+ - [ ] Target effect size and its source (pilot data, literature, meta-analysis)
290
+ - [ ] Effect size metric used (Cohen's d, r, partial eta-squared)
291
+ - [ ] Power analysis method (analytical, simulation-based, tool used)
292
+ - [ ] Target power level (typically 80% or 90%)
293
+ - [ ] Statistical test assumed (one-sample t, two-sample t, correlation, ANOVA)
294
+ - [ ] Multiple comparison correction method and parameters
295
+ - [ ] Planned N and justification
296
+ - [ ] Attrition allowance (expected exclusion rate)
297
+ - [ ] For simulation-based: number of simulations, pilot data source, software
298
+ - [ ] For reliability-dependent designs: reliability estimates and their source
299
+
300
+ ## References
301
+
302
+ - Birn, R. M., Molloy, E. K., Patriat, R., et al. (2013). The effect of scan length on the reliability of resting-state fMRI connectivity estimates. *NeuroImage*, 83, 550-558.
303
+ - Boudewyn, M. A., Luck, S. J., Farrens, J. L., & Kappenman, E. S. (2018). How many trials does it take to get a significant ERP effect? *Psychophysiology*, 55(6), e13049.
304
+ - Button, K. S., Ioannidis, J. P. A., Mokrysz, C., et al. (2013). Power failure: Why small sample size undermines the reliability of neuroscience. *Nature Reviews Neuroscience*, 14(5), 365-376.
305
+ - Cassidy, S. M., Robertson, I. H., & O'Connell, R. G. (2012). Retest reliability of event-related potentials: Evidence from a variety of paradigms. *Psychophysiology*, 49(5), 659-664.
306
+ - Cohen, M. X. (2014). *Analyzing Neural Time Series Data: Theory and Practice*. MIT Press.
307
+ - Dale, A. M. (1999). Optimal experimental design for event-related fMRI. *Human Brain Mapping*, 8(2-3), 109-114.
308
+ - Desmond, J. E., & Glover, G. H. (2002). Estimating sample size in functional MRI (fMRI) neuroimaging studies. *Journal of Neuroscience Methods*, 118(2), 115-128.
309
+ - Durnez, J., Degryse, J., Moerkerke, B., et al. (2016). Power and sample size calculations for fMRI studies based on the prevalence of active peaks. *bioRxiv*, 049429.
310
+ - Eklund, A., Nichols, T. E., & Knutsson, H. (2016). Cluster failure: Why fMRI inferences for spatial extent have inflated false-positive rates. *PNAS*, 113(28), 7900-7905.
311
+ - Elliott, M. L., Knodt, A. R., Ireland, D., et al. (2020). What is the test-retest reliability of common task-functional MRI measures? *Biological Psychiatry*, 87(11), 934-948.
312
+ - Genovese, C. R., Lazar, N. A., & Nichols, T. (2002). Thresholding of statistical maps in functional neuroimaging using the false discovery rate. *NeuroImage*, 15(4), 870-878.
313
+ - Hayasaka, S., Peiffer, A. M., Hugenschmidt, C. E., & Laurienti, P. J. (2007). Power and sample size calculation for neuroimaging studies by non-central random field theory. *NeuroImage*, 37(3), 721-730.
314
+ - Joyce, K. E., & Hayasaka, S. (2012). Development of PowerMap: A software package for statistical power calculation in neuroimaging studies. *Neuroinformatics*, 10(4), 351-365.
315
+ - Luck, S. J. (2014). *An Introduction to the Event-Related Potential Technique* (2nd ed.). MIT Press.
316
+ - Marek, S., Tervo-Clemmens, B., Calabro, F. J., et al. (2022). Reproducible brain-wide association studies require thousands of individuals. *Nature*, 603(7902), 654-660.
317
+ - Mumford, J. A., & Nichols, T. E. (2008). Power calculation for group fMRI studies accounting for arbitrary design and temporal autocorrelation. *NeuroImage*, 39(1), 261-268.
318
+ - Nichols, T. E., & Hayasaka, S. (2003). Controlling the familywise error rate in functional neuroimaging: A comparative review. *Statistical Methods in Medical Research*, 12(5), 419-446.
319
+ - Poldrack, R. A., Baker, C. I., Durnez, J., et al. (2017). Scanning the horizon: Towards transparent and reproducible neuroimaging research. *Nature Reviews Neuroscience*, 18(2), 115-126.
320
+ - Smith, S. M., & Nichols, T. E. (2009). Threshold-free cluster enhancement. *NeuroImage*, 44(1), 83-98.
321
+ - Thirion, B., Pinel, P., Meriaux, S., et al. (2007). Analysis of a large fMRI cohort: Statistical and methodological issues for group analyses. *NeuroImage*, 35(1), 105-120.
322
+ - Worsley, K. J., Marrett, S., Neelin, P., et al. (1996). A unified statistical approach for determining significant signals in images of cerebral activation. *Human Brain Mapping*, 4(1), 58-73.
323
+
324
+ See `references/` for detailed simulation examples and effect size lookup tables.