@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,300 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "signal-detection-analysis"
|
|
3
|
+
description: "Domain-validated decision logic, formulas, and interpretation guidelines for applying Signal Detection Theory to cognitive science data"
|
|
4
|
+
domain: "cognitive-psychology"
|
|
5
|
+
version: "1.0.0"
|
|
6
|
+
authors:
|
|
7
|
+
- "Claude (AI-assisted)"
|
|
8
|
+
papers:
|
|
9
|
+
- "Green & Swets, 1966"
|
|
10
|
+
- "Macmillan & Creelman, 2005"
|
|
11
|
+
- "Stanislaw & Todorov, 1999"
|
|
12
|
+
- "Hautus, 1995"
|
|
13
|
+
dependencies:
|
|
14
|
+
required:
|
|
15
|
+
- research-literacy
|
|
16
|
+
review_status: "ai-generated"
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# Signal Detection Analysis
|
|
20
|
+
|
|
21
|
+
## Purpose
|
|
22
|
+
|
|
23
|
+
This skill encodes expert methodological knowledge for applying Signal Detection Theory (SDT) to behavioral and cognitive science data. SDT separates an observer's perceptual sensitivity from their decision criterion -- a distinction that raw accuracy conflates. A competent programmer without cognitive science training would typically compute percent correct, missing the critical insight that two observers with identical accuracy can differ drastically in their ability to detect signals vs. their willingness to say "yes."
|
|
24
|
+
|
|
25
|
+
## When to Use SDT (Not Simple Accuracy)
|
|
26
|
+
|
|
27
|
+
Use SDT whenever:
|
|
28
|
+
|
|
29
|
+
- Stimuli belong to two classes (signal vs. noise, old vs. new, present vs. absent) and the observer makes a binary classification
|
|
30
|
+
- You need to distinguish **how well** someone can discriminate (sensitivity) from **how willing** they are to respond in a particular way (bias/criterion)
|
|
31
|
+
- Response bias may differ across conditions, groups, or time points, making raw accuracy misleading
|
|
32
|
+
- You want a measure that is independent of base rates and payoff structures
|
|
33
|
+
|
|
34
|
+
Do **not** use standard SDT when:
|
|
35
|
+
|
|
36
|
+
- There are more than two stimulus classes (use multi-class extensions or confusion matrices)
|
|
37
|
+
- Responses are continuous rather than categorical (use regression-based approaches)
|
|
38
|
+
- The task has no noise distribution (e.g., simple threshold detection with catch trials absent)
|
|
39
|
+
|
|
40
|
+
## Research Planning Protocol
|
|
41
|
+
|
|
42
|
+
Before executing the domain-specific steps below, you MUST:
|
|
43
|
+
|
|
44
|
+
1. **State the research question** — What sensitivity or bias question is this SDT analysis addressing?
|
|
45
|
+
2. **Justify the method choice** — Why SDT (not simple accuracy, logistic regression, etc.)? What alternatives were considered?
|
|
46
|
+
3. **Declare expected outcomes** — Do you expect sensitivity differences, bias differences, or both?
|
|
47
|
+
4. **Note assumptions and limitations** — What does SDT assume (e.g., Gaussian distributions, equal variance)? Where could it mislead?
|
|
48
|
+
5. **Present the plan to the user and WAIT for confirmation** before proceeding.
|
|
49
|
+
|
|
50
|
+
For detailed methodology guidance, see the `research-literacy` skill.
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
## ⚠️ Verification Notice
|
|
54
|
+
|
|
55
|
+
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).
|
|
56
|
+
|
|
57
|
+
## Core Concepts
|
|
58
|
+
|
|
59
|
+
### The 2x2 Response Matrix
|
|
60
|
+
|
|
61
|
+
Every SDT analysis begins with classifying each trial into one of four categories:
|
|
62
|
+
|
|
63
|
+
| | Signal Present | Signal Absent |
|
|
64
|
+
|--|----------------|---------------|
|
|
65
|
+
| **"Yes" Response** | Hit (H) | False Alarm (FA) |
|
|
66
|
+
| **"No" Response** | Miss (M) | Correct Rejection (CR) |
|
|
67
|
+
|
|
68
|
+
From these four cells, compute two rates:
|
|
69
|
+
|
|
70
|
+
- **Hit Rate**: H / (H + M) = proportion of signal trials correctly identified
|
|
71
|
+
- **False Alarm Rate**: FA / (FA + CR) = proportion of noise trials incorrectly called "signal"
|
|
72
|
+
|
|
73
|
+
### Sensitivity: d' (d-prime)
|
|
74
|
+
|
|
75
|
+
d' measures the distance between the signal and noise distributions in standard deviation units, assuming equal-variance Gaussian distributions (Green & Swets, 1966, Ch. 1):
|
|
76
|
+
|
|
77
|
+
> **d' = z(Hit Rate) - z(False Alarm Rate)**
|
|
78
|
+
|
|
79
|
+
where z() is the inverse of the standard normal CDF (the z-transform).
|
|
80
|
+
|
|
81
|
+
**What d' values mean in practice** (Macmillan & Creelman, 2005; Table 1.1):
|
|
82
|
+
|
|
83
|
+
| d' Value | Yes/No Interpretation | 2AFC % Correct | Practical Meaning |
|
|
84
|
+
|----------|----------------------|----------------|-------------------|
|
|
85
|
+
| 0 | Chance performance | 50% | No discrimination ability |
|
|
86
|
+
| 0.5 | Low sensitivity | ~60% | Barely above chance |
|
|
87
|
+
| 1.0 | Moderate sensitivity | ~69% | Often used as threshold (Green & Swets, 1966, Ch. 4) |
|
|
88
|
+
| 2.0 | Good sensitivity | ~84% | Reliable discrimination |
|
|
89
|
+
| 2.5 | High sensitivity | ~90% | Strong discrimination |
|
|
90
|
+
| 3.0+ | Near-ceiling | >93% | Approaching perfect; check for floor/ceiling issues |
|
|
91
|
+
|
|
92
|
+
The typical experimental range avoiding floor/ceiling effects is **d' = 0.5 to 2.5** (Macmillan & Creelman, 2005).
|
|
93
|
+
|
|
94
|
+
### Bias Measures: c, beta, and c'
|
|
95
|
+
|
|
96
|
+
SDT provides three interchangeable bias measures. The choice matters when d' varies across conditions.
|
|
97
|
+
|
|
98
|
+
**Criterion location c** (Macmillan & Creelman, 2005, Ch. 2):
|
|
99
|
+
|
|
100
|
+
> **c = -0.5 x [z(Hit Rate) + z(False Alarm Rate)]**
|
|
101
|
+
|
|
102
|
+
- c = 0: unbiased (optimal for equal base rates and symmetric payoffs)
|
|
103
|
+
- c > 0: conservative (tendency to say "no" / fewer false alarms, fewer hits)
|
|
104
|
+
- c < 0: liberal (tendency to say "yes" / more hits, more false alarms)
|
|
105
|
+
|
|
106
|
+
**Likelihood ratio beta** (Green & Swets, 1966, Ch. 1):
|
|
107
|
+
|
|
108
|
+
> **ln(beta) = d' x c**
|
|
109
|
+
|
|
110
|
+
- beta = 1: unbiased
|
|
111
|
+
- beta > 1: conservative
|
|
112
|
+
- beta < 1: liberal
|
|
113
|
+
|
|
114
|
+
**Relative criterion c'** (Macmillan & Creelman, 2005, Ch. 2):
|
|
115
|
+
|
|
116
|
+
> **c' = c / d'**
|
|
117
|
+
|
|
118
|
+
Normalizes criterion placement by sensitivity; useful when comparing bias across conditions with different d' values.
|
|
119
|
+
|
|
120
|
+
**Which bias measure to use** (Macmillan & Creelman, 2005, Ch. 2):
|
|
121
|
+
|
|
122
|
+
- Use **c** as the default -- it is statistically independent of d', defined when d' = 0, and symmetric around chance
|
|
123
|
+
- Use **beta** when testing whether observers approximate an optimal likelihood-ratio decision rule (e.g., recognition memory; Stretch & Wixted, 1998)
|
|
124
|
+
- Use **c'** when you need to compare bias across conditions where d' changes substantially
|
|
125
|
+
|
|
126
|
+
## Decision Logic: Choosing a Sensitivity Measure
|
|
127
|
+
|
|
128
|
+
```
|
|
129
|
+
Is the task a single-interval (yes/no) design?
|
|
130
|
+
|
|
|
131
|
+
+-- YES --> Are assumptions of equal-variance Gaussian distributions met?
|
|
132
|
+
| |
|
|
133
|
+
| +-- YES --> Use d' = z(H) - z(FA) (Green & Swets, 1966)
|
|
134
|
+
| |
|
|
135
|
+
| +-- NO, distributions have unequal variance
|
|
136
|
+
| | --> Use da with estimated variance ratio
|
|
137
|
+
| | (Macmillan & Creelman, 2005, Ch. 3)
|
|
138
|
+
| |
|
|
139
|
+
| +-- NO, distributions are non-Gaussian or unknown
|
|
140
|
+
| --> Use Az (area under the ROC curve)
|
|
141
|
+
| (Swets, 1986; Macmillan & Creelman, 2005, Ch. 3)
|
|
142
|
+
|
|
|
143
|
+
+-- NO --> Is it a two-interval forced choice (2AFC/2IFC)?
|
|
144
|
+
|
|
|
145
|
+
+-- YES --> d'(2AFC) = z(proportion correct) x sqrt(2)
|
|
146
|
+
| (Green & Swets, 1966, Ch. 6; Macmillan & Creelman, 2005, Ch. 5)
|
|
147
|
+
|
|
|
148
|
+
+-- NO --> Is it same-different or ABX?
|
|
149
|
+
|
|
|
150
|
+
+-- YES --> Use paradigm-specific formulas
|
|
151
|
+
| (see references/sdt-formulas.md)
|
|
152
|
+
|
|
|
153
|
+
+-- NO --> Is it a rating-scale (confidence) design?
|
|
154
|
+
|
|
|
155
|
+
+-- YES --> Construct ROC from rating data;
|
|
156
|
+
use Az or fit parametric model
|
|
157
|
+
(Macmillan & Creelman, 2005, Ch. 3)
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
### When to Use Az Instead of d'
|
|
161
|
+
|
|
162
|
+
Use the area under the ROC curve (Az) when:
|
|
163
|
+
|
|
164
|
+
1. You have **rating-scale data** (multiple confidence levels) and can construct a full ROC
|
|
165
|
+
2. The **equal-variance assumption is violated** (common in recognition memory, where the zROC slope is typically ~0.80 rather than 1.0; Mickes, Wixted, & Wais, 2007; Ratcliff, Sheu, & Gronlund, 1992)
|
|
166
|
+
3. You want a **distribution-free** sensitivity measure that does not assume Gaussian internals (Swets, 1986)
|
|
167
|
+
|
|
168
|
+
**AUC benchmarks** (Swets, Dawes, & Monahan, 2000):
|
|
169
|
+
|
|
170
|
+
| AUC Range | Interpretation |
|
|
171
|
+
|-----------|----------------|
|
|
172
|
+
| 0.50 | Chance (no discrimination) |
|
|
173
|
+
| 0.70 - 0.80 | Fair diagnostic accuracy |
|
|
174
|
+
| 0.80 - 0.90 | Good diagnostic accuracy |
|
|
175
|
+
| 0.90 - 1.00 | Excellent diagnostic accuracy |
|
|
176
|
+
|
|
177
|
+
## Common Paradigms
|
|
178
|
+
|
|
179
|
+
### Yes/No Detection
|
|
180
|
+
|
|
181
|
+
The canonical SDT paradigm. On each trial, either a signal or noise is presented; the observer responds "yes" (signal present) or "no" (signal absent). Yields H and FA rates directly.
|
|
182
|
+
|
|
183
|
+
- d' = z(H) - z(FA)
|
|
184
|
+
- Bias c = -0.5 x [z(H) + z(FA)]
|
|
185
|
+
|
|
186
|
+
### Two-Alternative Forced Choice (2AFC / 2IFC)
|
|
187
|
+
|
|
188
|
+
Two intervals are presented (one signal, one noise); the observer selects the signal interval. Only proportion correct is measured; there is no independent FA rate, and no bias measure can be computed.
|
|
189
|
+
|
|
190
|
+
- d'(2AFC) = z(proportion correct) x sqrt(2) (Green & Swets, 1966, Ch. 6)
|
|
191
|
+
- d'(2AFC) = d'(yes/no) x sqrt(2) (Macmillan & Creelman, 2005, Ch. 5)
|
|
192
|
+
|
|
193
|
+
**Critical domain pitfall**: A task where the observer chooses between two labels (e.g., "left" or "right") on a single stimulus is **not** a 2AFC -- it is a yes/no task in disguise (Macmillan & Creelman, 2005). True 2AFC requires two temporal or spatial intervals.
|
|
194
|
+
|
|
195
|
+
### Rating Scale (Confidence Ratings)
|
|
196
|
+
|
|
197
|
+
Observers make a detection judgment plus a confidence rating (e.g., 1-6 scale from "sure noise" to "sure signal"). Each confidence boundary yields a separate (H, FA) pair, constructing a multi-point ROC.
|
|
198
|
+
|
|
199
|
+
- Fit with parametric (Gaussian) or nonparametric methods
|
|
200
|
+
- Compute Az from the fitted ROC
|
|
201
|
+
- The zROC slope estimates the variance ratio of the two distributions
|
|
202
|
+
|
|
203
|
+
### Same-Different
|
|
204
|
+
|
|
205
|
+
Two stimuli are presented; the observer judges "same" or "different." Two observer models exist (Macmillan & Creelman, 2005, Ch. 6):
|
|
206
|
+
|
|
207
|
+
- **Independent observations model**: observer compares each stimulus to an internal criterion
|
|
208
|
+
- **Differencing model**: observer computes the difference between the two percepts
|
|
209
|
+
|
|
210
|
+
These yield different d' formulas; see `references/sdt-formulas.md`.
|
|
211
|
+
|
|
212
|
+
### ABX (Oddity / AX)
|
|
213
|
+
|
|
214
|
+
Stimulus A, then B, then X (which matches A or B); the observer identifies X. Sensitivity depends on assumed observer strategy (Macmillan & Creelman, 2005, Ch. 6). See `references/sdt-formulas.md`.
|
|
215
|
+
|
|
216
|
+
## Handling Extreme Hit/False Alarm Rates
|
|
217
|
+
|
|
218
|
+
When H = 1.0 or FA = 0.0, z-scores become infinite and d' is undefined. This is a **common computational pitfall** that requires correction.
|
|
219
|
+
|
|
220
|
+
### Correction Methods
|
|
221
|
+
|
|
222
|
+
**1. The 1/(2N) rule** (Macmillan & Kaplan, 1985):
|
|
223
|
+
|
|
224
|
+
- Replace 0 with 0.5/N
|
|
225
|
+
- Replace 1 with (N - 0.5)/N
|
|
226
|
+
- Where N = number of signal trials (for H) or noise trials (for FA)
|
|
227
|
+
- Applied **only** to extreme values
|
|
228
|
+
|
|
229
|
+
**2. The log-linear rule** (Hautus, 1995) -- **recommended**:
|
|
230
|
+
|
|
231
|
+
- Add 0.5 to every cell in the 2x2 matrix (hits, misses, FA, CR) **before** computing rates
|
|
232
|
+
- Applied to **all** cells, regardless of whether extremes are present
|
|
233
|
+
- Produces less biased estimates that consistently underestimate true d' (Hautus, 1995)
|
|
234
|
+
|
|
235
|
+
**Which to use**: The log-linear rule is preferred because it produces less biased d' estimates and avoids the asymmetric bias of the 1/(2N) rule, which can either over- or underestimate d' (Hautus, 1995). Apply the log-linear correction **routinely**, not just when extremes occur, for consistency across participants and conditions.
|
|
236
|
+
|
|
237
|
+
## The Unequal-Variance Problem
|
|
238
|
+
|
|
239
|
+
### Why It Matters
|
|
240
|
+
|
|
241
|
+
Standard d' assumes signal and noise distributions have equal variance. In recognition memory, this assumption is **routinely violated**: zROC slopes are typically **~0.80** (not 1.0), indicating the old-item (target) distribution has ~25% more variance than the new-item (lure) distribution (Ratcliff, Sheu, & Gronlund, 1992; Mickes, Wixted, & Wais, 2007).
|
|
242
|
+
|
|
243
|
+
### Consequences of Ignoring It
|
|
244
|
+
|
|
245
|
+
If variances are unequal and you compute standard d', the measure is **not criterion-free** -- it will vary with criterion placement even if true sensitivity is constant (Macmillan & Creelman, 2005, Ch. 3).
|
|
246
|
+
|
|
247
|
+
### What to Do
|
|
248
|
+
|
|
249
|
+
1. Collect rating-scale data to construct a zROC
|
|
250
|
+
2. If the zROC slope deviates from 1.0, use the unequal-variance model
|
|
251
|
+
3. Compute da (the unequal-variance sensitivity measure); see `references/sdt-formulas.md`
|
|
252
|
+
|
|
253
|
+
## Common Pitfalls
|
|
254
|
+
|
|
255
|
+
1. **Using percent correct instead of d'**: Percent correct confounds sensitivity and bias. Two observers with identical discrimination ability but different criteria will have different accuracy scores (Green & Swets, 1966, Ch. 1).
|
|
256
|
+
|
|
257
|
+
2. **Treating a single-stimulus forced choice as 2AFC**: If only one stimulus is presented per trial and the observer picks a label, this is a yes/no design, not 2AFC. Using the 2AFC formula will yield incorrect d' values (Macmillan & Creelman, 2005).
|
|
258
|
+
|
|
259
|
+
3. **Ignoring extreme rate corrections**: Computing d' without correcting H = 1 or FA = 0 produces infinite values. Always apply the log-linear correction (Hautus, 1995).
|
|
260
|
+
|
|
261
|
+
4. **Assuming equal variance in recognition memory**: Recognition memory data almost always show unequal variance (zROC slope ~0.80). Standard d' is not criterion-free in this domain (Ratcliff, Sheu, & Gronlund, 1992).
|
|
262
|
+
|
|
263
|
+
5. **Interpreting c as "response bias" without checking**: c measures where the criterion is placed relative to distributions, not why it is placed there. A shift in c can reflect rational adaptation to base rates, not irrational bias (Macmillan & Creelman, 2005, Ch. 2).
|
|
264
|
+
|
|
265
|
+
6. **Comparing d' across paradigms without conversion**: d' values from yes/no and 2AFC designs are not directly comparable. d'(2AFC) = d'(yes/no) x sqrt(2). Failure to convert leads to erroneous sensitivity comparisons (Green & Swets, 1966, Ch. 6).
|
|
266
|
+
|
|
267
|
+
7. **Averaging d' across participants without caution**: d' is nonlinearly related to H and FA rates. Averaging H and FA rates first, then computing d', gives different results than averaging individual d' values. The appropriate method depends on the research question (Macmillan & Creelman, 2005, Ch. 8).
|
|
268
|
+
|
|
269
|
+
## Minimum Reporting Checklist
|
|
270
|
+
|
|
271
|
+
Based on Macmillan & Creelman (2005) and Stanislaw & Todorov (1999):
|
|
272
|
+
|
|
273
|
+
- [ ] Paradigm type (yes/no, 2AFC, rating, same-different, ABX)
|
|
274
|
+
- [ ] Number of signal and noise trials per condition
|
|
275
|
+
- [ ] Hit rate and false alarm rate (or full rating distribution)
|
|
276
|
+
- [ ] Correction method used for extreme proportions (log-linear or 1/2N)
|
|
277
|
+
- [ ] Sensitivity measure (d', da, Az) with justification for choice
|
|
278
|
+
- [ ] Bias measure (c, beta, c') with justification for choice
|
|
279
|
+
- [ ] Whether equal- or unequal-variance model was used (and estimated variance ratio if unequal)
|
|
280
|
+
- [ ] If rating data: ROC and/or zROC plot with slope reported
|
|
281
|
+
- [ ] Statistical tests on SDT measures (not on raw accuracy)
|
|
282
|
+
- [ ] Software and version used for computation
|
|
283
|
+
|
|
284
|
+
## References
|
|
285
|
+
|
|
286
|
+
- Green, D. M., & Swets, J. A. (1966). *Signal detection theory and psychophysics*. New York: Wiley.
|
|
287
|
+
- Hautus, M. J. (1995). Corrections for extreme proportions and their biasing effects on estimated values of d'. *Behavior Research Methods, Instruments, & Computers*, 27, 46-51.
|
|
288
|
+
- Macmillan, N. A., & Creelman, C. D. (2005). *Detection theory: A user's guide* (2nd ed.). Mahwah, NJ: Erlbaum.
|
|
289
|
+
- Macmillan, N. A., & Kaplan, H. L. (1985). Detection theory analysis of group data. *Psychological Bulletin*, 98, 185-199.
|
|
290
|
+
- Maniscalco, B., & Lau, H. (2012). A signal detection theoretic approach for estimating metacognitive sensitivity from confidence ratings. *Consciousness and Cognition*, 21, 422-430.
|
|
291
|
+
- Mickes, L., Wixted, J. T., & Wais, P. E. (2007). A direct test of the unequal-variance signal detection model of recognition memory. *Psychonomic Bulletin & Review*, 14, 858-865.
|
|
292
|
+
- Ratcliff, R., Sheu, C. F., & Gronlund, S. D. (1992). Testing global memory models using ROC curves. *Psychological Review*, 99, 518-535.
|
|
293
|
+
- Stanislaw, H., & Todorov, N. (1999). Calculation of signal detection theory measures. *Behavior Research Methods, Instruments, & Computers*, 31, 137-149.
|
|
294
|
+
- Stretch, V., & Wixted, J. T. (1998). On the difference between strength-based and frequency-based mirror effects in recognition memory. *Journal of Experimental Psychology: Learning, Memory, and Cognition*, 24, 1379-1396.
|
|
295
|
+
- Swets, J. A. (1986). Indices of discrimination or diagnostic accuracy. *Psychological Bulletin*, 99, 100-117.
|
|
296
|
+
- Swets, J. A. (1988). Measuring the accuracy of diagnostic systems. *Science*, 240, 1285-1293.
|
|
297
|
+
- Swets, J. A., Dawes, R. M., & Monahan, J. (2000). Psychological science can improve diagnostic decisions. *Psychological Science in the Public Interest*, 1, 1-26.
|
|
298
|
+
|
|
299
|
+
See `references/sdt-formulas.md` for detailed mathematical formulas and lookup tables.
|
|
300
|
+
See `references/application-guide.md` for domain-specific applications.
|
package/skills/03_Cognitive_Psychology/signal-detection-analysis/references/application-guide.md
ADDED
|
@@ -0,0 +1,278 @@
|
|
|
1
|
+
# SDT Application Guide: Domain-Specific Uses
|
|
2
|
+
|
|
3
|
+
This reference file supplements the main `SKILL.md` with detailed guidance on applying Signal Detection Theory in specific cognitive science domains.
|
|
4
|
+
|
|
5
|
+
## 1. Recognition Memory
|
|
6
|
+
|
|
7
|
+
### The Old/New Paradigm
|
|
8
|
+
|
|
9
|
+
The most common application of SDT in memory research. Participants study a list of items, then are tested with a mix of old (studied) and new (unstudied) items, responding "old" or "new."
|
|
10
|
+
|
|
11
|
+
**Mapping to SDT** (Macmillan & Creelman, 2005, Ch. 2):
|
|
12
|
+
- Signal = old item; Noise = new item
|
|
13
|
+
- Hit = correctly responding "old" to an old item
|
|
14
|
+
- False Alarm = incorrectly responding "old" to a new item
|
|
15
|
+
- d' reflects **memory strength** (discriminability of old from new)
|
|
16
|
+
- c reflects **response criterion** (willingness to endorse items as "old")
|
|
17
|
+
|
|
18
|
+
### The Mirror Effect
|
|
19
|
+
|
|
20
|
+
A robust finding: variables that increase hit rates also decrease false alarm rates (e.g., high-frequency words produce both lower H and higher FA than low-frequency words). This "mirror effect" (Glanzer & Adams, 1985) is naturally explained by SDT if both distributions shift (Stretch & Wixted, 1998).
|
|
21
|
+
|
|
22
|
+
### Unequal Variance: The Default in Recognition Memory
|
|
23
|
+
|
|
24
|
+
Standard d' assumes equal variance, but recognition memory data **almost always** violate this assumption (Ratcliff, Sheu, & Gronlund, 1992):
|
|
25
|
+
|
|
26
|
+
- **zROC slopes** in recognition memory are typically **0.80** (range: 0.70-0.90 across studies; Ratcliff, Sheu, & Gronlund, 1992; Mickes, Wixted, & Wais, 2007)
|
|
27
|
+
- This means sigma_old / sigma_new ~ **1.25** (old items have more variable memory strength)
|
|
28
|
+
- The encoding variability hypothesis explains this: items are encoded with variable strength, increasing the variance of the old-item distribution (Wixted, 2007)
|
|
29
|
+
|
|
30
|
+
**Practical recommendation**: When analyzing recognition memory data:
|
|
31
|
+
1. Collect confidence ratings (e.g., 6-point scale: sure new, probably new, maybe new, maybe old, probably old, sure old)
|
|
32
|
+
2. Construct the zROC and estimate the slope
|
|
33
|
+
3. If slope deviates from 1.0 (it will), compute da rather than d'
|
|
34
|
+
4. Report the slope and variance ratio alongside sensitivity
|
|
35
|
+
|
|
36
|
+
### The Remember/Know Paradigm
|
|
37
|
+
|
|
38
|
+
Participants indicate whether they "remember" specific details (recollection) or "know" the item was studied based on familiarity. Under the dual-process SDT model (Yonelinas, 1994):
|
|
39
|
+
|
|
40
|
+
- **Recollection** (R) is modeled as a threshold process: P(R) = proportion of old items exceeding a recollection threshold
|
|
41
|
+
- **Familiarity** is modeled as a continuous Gaussian SDT process: d'(familiarity) is estimated after removing recollected items
|
|
42
|
+
|
|
43
|
+
**Estimation** (Yonelinas, 2002):
|
|
44
|
+
- Recollection = P("remember" | old) - P("remember" | new)
|
|
45
|
+
- Familiarity d' = z(P("know" | old) / (1 - P("remember" | old))) - z(P("know" | new) / (1 - P("remember" | new)))
|
|
46
|
+
|
|
47
|
+
**Critical pitfall**: The independence assumption underlying these formulas (that "know" responses come only from non-recollected items) is debated. The redundancy model (Wixted & Mickes, 2010) argues recollection and familiarity are not independent. Report which model was assumed.
|
|
48
|
+
|
|
49
|
+
## 2. Perception and Psychophysics
|
|
50
|
+
|
|
51
|
+
### Threshold Estimation
|
|
52
|
+
|
|
53
|
+
SDT was originally developed for perceptual detection (Green & Swets, 1966). The "threshold" in SDT is typically defined as the stimulus intensity yielding a criterion level of d':
|
|
54
|
+
|
|
55
|
+
- **d' = 1.0** is the most common threshold definition in yes/no tasks (Green & Swets, 1966, Ch. 4)
|
|
56
|
+
- **76% correct** is the equivalent threshold in 2AFC (corresponding to d'(2AFC) ~ 1.0; Green & Swets, 1966, Ch. 6)
|
|
57
|
+
|
|
58
|
+
Other threshold conventions exist:
|
|
59
|
+
- 75% correct in 2AFC (d' ~ 0.95) -- used in some adaptive staircase methods
|
|
60
|
+
- d' = 2.0 for clinical hearing tests -- a more conservative threshold
|
|
61
|
+
|
|
62
|
+
### Psychometric Functions and SDT
|
|
63
|
+
|
|
64
|
+
The psychometric function (proportion correct vs. stimulus intensity) is related to SDT:
|
|
65
|
+
|
|
66
|
+
- At each stimulus intensity, the observer has a particular d'
|
|
67
|
+
- Plotting d' vs. stimulus intensity yields the psychometric function in SDT units
|
|
68
|
+
- The slope of this function reflects how rapidly sensitivity changes with stimulus strength
|
|
69
|
+
|
|
70
|
+
**Adaptive methods** (staircases, QUEST, PEST) estimate the stimulus level corresponding to a target d' or proportion correct (Watson & Pelli, 1983; Taylor & Creelman, 1967).
|
|
71
|
+
|
|
72
|
+
### Signal Detection in Vision Research
|
|
73
|
+
|
|
74
|
+
Common visual paradigms and their SDT implementations:
|
|
75
|
+
|
|
76
|
+
| Task | SDT Design | Sensitivity Measure |
|
|
77
|
+
|------|-----------|-------------------|
|
|
78
|
+
| Contrast detection | Yes/no with noise intervals | d' |
|
|
79
|
+
| Orientation discrimination | 2AFC (which interval had tilted grating?) | d'(2AFC) |
|
|
80
|
+
| Change detection | Yes/no ("did something change?") | d' or Cowan's K (Cowan, 2001) |
|
|
81
|
+
| Visual search | Yes/no ("target present?") | d' (separate for each set size) |
|
|
82
|
+
|
|
83
|
+
**Visual search and SDT**: In visual search, d' typically decreases linearly with the logarithm of set size for inefficient search, but remains constant for efficient ("pop-out") search (Palmer, Verghese, & Pavel, 2000).
|
|
84
|
+
|
|
85
|
+
### Signal Detection in Auditory Research
|
|
86
|
+
|
|
87
|
+
Common auditory paradigms:
|
|
88
|
+
|
|
89
|
+
| Task | SDT Design | Notes |
|
|
90
|
+
|------|-----------|-------|
|
|
91
|
+
| Tone detection in noise | Yes/no or 2IFC | Classic SDT paradigm (Green & Swets, 1966) |
|
|
92
|
+
| Frequency discrimination | 2IFC or same-different | Use appropriate paradigm-specific formula |
|
|
93
|
+
| Speech in noise | Open-set (word identification) | SDT less applicable; use percent correct or SRT |
|
|
94
|
+
| Audiometric threshold | Adaptive staircase | Target d' varies by clinical standard |
|
|
95
|
+
|
|
96
|
+
## 3. Clinical Psychology and Diagnostic Accuracy
|
|
97
|
+
|
|
98
|
+
### SDT Framework for Diagnosis
|
|
99
|
+
|
|
100
|
+
Any diagnostic decision can be framed as signal detection (Swets, 1988; Swets, Dawes, & Monahan, 2000):
|
|
101
|
+
|
|
102
|
+
- **Signal** = condition present (e.g., disease, disorder, threat)
|
|
103
|
+
- **Noise** = condition absent
|
|
104
|
+
- **Hit** = true positive (correctly detecting condition)
|
|
105
|
+
- **False Alarm** = false positive (incorrectly diagnosing condition when absent)
|
|
106
|
+
- **Sensitivity** (d' or AUC) = diagnostic accuracy of the test/clinician
|
|
107
|
+
- **Criterion** (c) = diagnostic threshold (how much evidence is required before diagnosing)
|
|
108
|
+
|
|
109
|
+
### AUC Benchmarks for Clinical Instruments
|
|
110
|
+
|
|
111
|
+
From Swets (1988) and Swets, Dawes, & Monahan (2000):
|
|
112
|
+
|
|
113
|
+
| AUC | Clinical Interpretation |
|
|
114
|
+
|-----|------------------------|
|
|
115
|
+
| 0.50 | No diagnostic value (chance) |
|
|
116
|
+
| 0.50 - 0.70 | Low accuracy; rarely useful clinically |
|
|
117
|
+
| 0.70 - 0.80 | Fair accuracy; may be useful as one of several indicators |
|
|
118
|
+
| 0.80 - 0.90 | Good accuracy; clinically useful |
|
|
119
|
+
| 0.90 - 1.00 | Excellent accuracy; high diagnostic value |
|
|
120
|
+
|
|
121
|
+
**Benchmark context**: Strong psychological assessment measures routinely yield AUC estimates around 0.70 (Youngstrom, 2014). An AUC of 0.80 is a reasonable target for clinically useful individual-level prediction.
|
|
122
|
+
|
|
123
|
+
### Clinical Applications
|
|
124
|
+
|
|
125
|
+
**Violence risk assessment** (Swets, Dawes, & Monahan, 2000):
|
|
126
|
+
- Actuarial risk instruments (e.g., VRAG) achieve AUC ~ 0.70-0.76
|
|
127
|
+
- Clinical judgment alone: AUC ~ 0.55-0.65
|
|
128
|
+
- SDT analysis reveals that clinicians tend to have a conservative criterion (low FA but many misses)
|
|
129
|
+
|
|
130
|
+
**Depression screening** (e.g., PHQ-9):
|
|
131
|
+
- At cutoff score >= 10: sensitivity ~ 0.88, specificity ~ 0.88 (Kroenke, Spitzer, & Williams, 2001)
|
|
132
|
+
- The cutoff score represents the criterion in SDT terms
|
|
133
|
+
- Different cutoffs trade off sensitivity vs. specificity along the ROC curve
|
|
134
|
+
|
|
135
|
+
**Medical imaging** (Swets, 1988):
|
|
136
|
+
- Radiologist mammography reading: AUC ~ 0.80-0.90
|
|
137
|
+
- Computer-aided detection systems: AUC ~ 0.85-0.95
|
|
138
|
+
- SDT separates the radiologist's perceptual ability from their decision threshold
|
|
139
|
+
|
|
140
|
+
### Base Rate Effects on Clinical Decisions
|
|
141
|
+
|
|
142
|
+
A critical SDT insight for clinical work: the **optimal criterion shifts with base rate** (Green & Swets, 1966, Ch. 2).
|
|
143
|
+
|
|
144
|
+
- In rare conditions (low base rate), the optimal criterion is conservative (high c)
|
|
145
|
+
- In common conditions (high base rate), the optimal criterion is liberal (low c)
|
|
146
|
+
- Clinicians often fail to adjust sufficiently for base rates, leading to systematic over-diagnosis of rare conditions and under-diagnosis of common ones (Swets, Dawes, & Monahan, 2000)
|
|
147
|
+
|
|
148
|
+
**Positive predictive value** (PPV) depends on base rate even when sensitivity and specificity are constant:
|
|
149
|
+
|
|
150
|
+
```
|
|
151
|
+
PPV = (sensitivity * base_rate) / (sensitivity * base_rate + (1 - specificity) * (1 - base_rate))
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
For a test with sensitivity = 0.90 and specificity = 0.90:
|
|
155
|
+
- Base rate 50%: PPV = 0.90
|
|
156
|
+
- Base rate 10%: PPV = 0.50
|
|
157
|
+
- Base rate 1%: PPV = 0.08
|
|
158
|
+
|
|
159
|
+
This dramatic drop in PPV at low base rates is a key SDT-informed insight that clinicians without SDT training often miss.
|
|
160
|
+
|
|
161
|
+
## 4. Metacognition and Confidence Ratings
|
|
162
|
+
|
|
163
|
+
### Type 1 vs. Type 2 SDT
|
|
164
|
+
|
|
165
|
+
**Type 1 SDT**: How well does the observer discriminate external stimulus states (signal vs. noise)?
|
|
166
|
+
- Measures: d', c, Az
|
|
167
|
+
|
|
168
|
+
**Type 2 SDT**: How well does the observer discriminate their own correct from incorrect responses?
|
|
169
|
+
- Measures: type 2 d', type 2 AUC, meta-d' (Maniscalco & Lau, 2012)
|
|
170
|
+
|
|
171
|
+
### Meta-d' (Maniscalco & Lau, 2012)
|
|
172
|
+
|
|
173
|
+
Meta-d' is the type 1 d' that would produce the observed type 2 (metacognitive) performance under ideal SDT assumptions. It answers: "How much signal-to-noise information is available for metacognitive judgments?"
|
|
174
|
+
|
|
175
|
+
**Key properties**:
|
|
176
|
+
- Meta-d' is expressed in the same units as d', enabling direct comparison
|
|
177
|
+
- If meta-d' = d': metacognition is ideal (all information available for the type 1 task is also used for metacognition)
|
|
178
|
+
- If meta-d' < d': metacognitive inefficiency (some information is lost or unavailable for confidence judgments)
|
|
179
|
+
- If meta-d' > d' (rare): suggests additional information sources for metacognition beyond the type 1 decision variable
|
|
180
|
+
|
|
181
|
+
**Metacognitive efficiency** (M-ratio):
|
|
182
|
+
|
|
183
|
+
```
|
|
184
|
+
M-ratio = meta-d' / d'
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
- M-ratio = 1: ideal metacognition
|
|
188
|
+
- M-ratio < 1: suboptimal metacognition (typical finding; Maniscalco & Lau, 2012)
|
|
189
|
+
- Typical values in perceptual tasks: **M-ratio ~ 0.6 - 0.8** (Fleming & Lau, 2014)
|
|
190
|
+
|
|
191
|
+
### Computing Meta-d'
|
|
192
|
+
|
|
193
|
+
Meta-d' cannot be computed with a simple formula. It requires fitting a model to the type 2 data (confidence rating distributions conditioned on accuracy). Two approaches:
|
|
194
|
+
|
|
195
|
+
1. **Maximum likelihood estimation** (Maniscalco & Lau, 2012): fit meta-d' to maximize the likelihood of observed type 2 hit and FA rates at each confidence level
|
|
196
|
+
2. **Hierarchical Bayesian estimation** (Fleming, 2017): preferred for group-level analysis; handles individual differences and small trial counts better
|
|
197
|
+
|
|
198
|
+
Software: Available at https://github.com/smfleming/HMeta-d (MATLAB and Python).
|
|
199
|
+
|
|
200
|
+
### Confidence Calibration vs. Metacognitive Sensitivity
|
|
201
|
+
|
|
202
|
+
These are distinct concepts often confused:
|
|
203
|
+
|
|
204
|
+
- **Calibration**: Do confidence ratings match objective accuracy? (e.g., when someone says "80% sure," are they correct 80% of the time?)
|
|
205
|
+
- **Resolution/sensitivity**: Can the observer distinguish correct from incorrect responses, regardless of absolute calibration?
|
|
206
|
+
|
|
207
|
+
SDT-based measures (meta-d', type 2 AUC) measure **resolution**, not calibration. Calibration requires separate analysis (e.g., calibration curves).
|
|
208
|
+
|
|
209
|
+
## 5. Eyewitness Identification
|
|
210
|
+
|
|
211
|
+
### SDT in Lineup Research
|
|
212
|
+
|
|
213
|
+
SDT has been applied to eyewitness identification (Wixted & Mickes, 2012):
|
|
214
|
+
|
|
215
|
+
- **Signal** = target-present lineup
|
|
216
|
+
- **Noise** = target-absent lineup
|
|
217
|
+
- **Hit** = correct identification from target-present lineup
|
|
218
|
+
- **False Alarm** = incorrect identification from target-absent lineup (filler or foil identification)
|
|
219
|
+
|
|
220
|
+
### Lineup Procedure Effects
|
|
221
|
+
|
|
222
|
+
SDT analysis reveals that different lineup procedures (simultaneous vs. sequential) primarily affect criterion placement, not discriminability (Wixted & Mickes, 2012):
|
|
223
|
+
|
|
224
|
+
- **Simultaneous lineups**: more liberal criterion (higher H and higher FA)
|
|
225
|
+
- **Sequential lineups**: more conservative criterion (lower H and lower FA)
|
|
226
|
+
- **d' (discriminability)**: similar across procedures in many studies
|
|
227
|
+
|
|
228
|
+
This SDT insight has important policy implications: sequential lineups were once recommended as superior, but SDT analysis shows they primarily make witnesses more conservative, not more accurate at discrimination (Wixted & Mickes, 2012).
|
|
229
|
+
|
|
230
|
+
## 6. Decision Making Under Uncertainty
|
|
231
|
+
|
|
232
|
+
### SDT and Optimal Decision Rules
|
|
233
|
+
|
|
234
|
+
The optimal SDT observer sets the criterion to maximize expected utility (Green & Swets, 1966, Ch. 2):
|
|
235
|
+
|
|
236
|
+
```
|
|
237
|
+
beta_optimal = [P(noise) / P(signal)] * [(V_CR + C_FA) / (V_H + C_M)]
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
Where:
|
|
241
|
+
- P(noise), P(signal) = prior probabilities
|
|
242
|
+
- V_CR, V_H = values of correct decisions
|
|
243
|
+
- C_FA, C_M = costs of incorrect decisions
|
|
244
|
+
|
|
245
|
+
When base rates are equal and payoffs symmetric, beta_optimal = 1 (unbiased).
|
|
246
|
+
|
|
247
|
+
### SDT and the Utility of Caution
|
|
248
|
+
|
|
249
|
+
A key insight from "utilized" SDT (Lynn & Barrett, 2014): maximizing accuracy and maximizing utility are **not** always the same. There are situations where the optimal strategy is deliberately inaccurate:
|
|
250
|
+
|
|
251
|
+
- When misses are far more costly than false alarms (e.g., smoke detector design), the optimal criterion is very liberal, maximizing hits at the expense of many false alarms
|
|
252
|
+
- When false alarms are far more costly than misses (e.g., criminal conviction), the optimal criterion is very conservative
|
|
253
|
+
|
|
254
|
+
## References
|
|
255
|
+
|
|
256
|
+
- Cowan, N. (2001). The magical number 4 in short-term memory. *Behavioral and Brain Sciences*, 24, 87-114.
|
|
257
|
+
- Fleming, S. M. (2017). HMeta-d: Hierarchical Bayesian estimation of metacognitive efficiency from confidence ratings. *Neuroscience of Consciousness*, 3(1), nix007.
|
|
258
|
+
- Fleming, S. M., & Lau, H. C. (2014). How to measure metacognition. *Frontiers in Human Neuroscience*, 8, 443.
|
|
259
|
+
- Glanzer, M., & Adams, J. K. (1985). The mirror effect in recognition memory. *Memory & Cognition*, 13, 8-20.
|
|
260
|
+
- Green, D. M., & Swets, J. A. (1966). *Signal detection theory and psychophysics*. New York: Wiley.
|
|
261
|
+
- Kroenke, K., Spitzer, R. L., & Williams, J. B. (2001). The PHQ-9: Validity of a brief depression severity measure. *Journal of General Internal Medicine*, 16, 606-613.
|
|
262
|
+
- Lynn, S. K., & Barrett, L. F. (2014). "Utilizing" signal detection theory. *Psychological Science*, 25, 1663-1673.
|
|
263
|
+
- Macmillan, N. A., & Creelman, C. D. (2005). *Detection theory: A user's guide* (2nd ed.). Mahwah, NJ: Erlbaum.
|
|
264
|
+
- Maniscalco, B., & Lau, H. (2012). A signal detection theoretic approach for estimating metacognitive sensitivity from confidence ratings. *Consciousness and Cognition*, 21, 422-430.
|
|
265
|
+
- Mickes, L., Wixted, J. T., & Wais, P. E. (2007). A direct test of the unequal-variance signal detection model of recognition memory. *Psychonomic Bulletin & Review*, 14, 858-865.
|
|
266
|
+
- Palmer, J., Verghese, P., & Pavel, M. (2000). The psychophysics of visual search. *Vision Research*, 40, 1227-1268.
|
|
267
|
+
- Ratcliff, R., Sheu, C. F., & Gronlund, S. D. (1992). Testing global memory models using ROC curves. *Psychological Review*, 99, 518-535.
|
|
268
|
+
- Stretch, V., & Wixted, J. T. (1998). On the difference between strength-based and frequency-based mirror effects in recognition memory. *Journal of Experimental Psychology: Learning, Memory, and Cognition*, 24, 1379-1396.
|
|
269
|
+
- Swets, J. A. (1988). Measuring the accuracy of diagnostic systems. *Science*, 240, 1285-1293.
|
|
270
|
+
- Swets, J. A., Dawes, R. M., & Monahan, J. (2000). Psychological science can improve diagnostic decisions. *Psychological Science in the Public Interest*, 1, 1-26.
|
|
271
|
+
- Taylor, M. M., & Creelman, C. D. (1967). PEST: Efficient estimates on probability functions. *Journal of the Acoustical Society of America*, 41, 782-787.
|
|
272
|
+
- Watson, A. B., & Pelli, D. G. (1983). QUEST: A Bayesian adaptive psychometric method. *Perception & Psychophysics*, 33, 113-120.
|
|
273
|
+
- Wixted, J. T. (2007). Dual-process theory and signal-detection theory of recognition memory. *Psychological Review*, 114, 152-176.
|
|
274
|
+
- Wixted, J. T., & Mickes, L. (2010). A continuous dual-process model of remember/know judgments. *Psychological Review*, 117, 1025-1054.
|
|
275
|
+
- Wixted, J. T., & Mickes, L. (2012). The field of eyewitness memory should abandon probative value and embrace receiver operating characteristic analysis. *Perspectives on Psychological Science*, 7, 275-278.
|
|
276
|
+
- Yonelinas, A. P. (1994). Receiver-operating characteristics in recognition memory: Evidence for a dual-process model. *Journal of Experimental Psychology: Learning, Memory, and Cognition*, 20, 1341-1354.
|
|
277
|
+
- Yonelinas, A. P. (2002). The nature of recollection and familiarity: A review of 30 years of research. *Journal of Memory and Language*, 46, 441-517.
|
|
278
|
+
- Youngstrom, E. A. (2014). A primer on receiver operating characteristic analysis and diagnostic efficiency statistics for pediatric psychology. *Journal of Pediatric Psychology*, 39, 204-221.
|