用途:对已发表 fMRI 研究的峰值坐标做元分析式解码,回答“这个 MNI 坐标与什么认知功能相关”,或反查某认知术语对应哪些研究及其峰值位置。数据来自公开可下载的 Neurosynth 坐标数据库(14,371 项研究、约 3,228 个术语),无需 API 密钥或登录。
主要能力:decode_coordinate.py 找出查询点半径内所有报告峰值的研究,再用两比例 z 检验比较各术语在近坐标研究集与其余语料中的出现频率,输出原始 p 值与 BH 校正后的 fdr_q_value;search_by_term.py 按精确术语返回 tfidf 权重最高的研究(标题、作者、年份、期刊、权重),可选返回其 MNI 坐标。
使用方式:先运行 python3 scripts/download_data.py 下载约 9MB 数据并缓存到 ~/.cache/tooluniverse/neurosynth/(可用 TOOLUNIVERSE_CACHE_DIR 覆盖,重复运行默认跳过,--force 强制重下)。解码示例:python3 scripts/decode_coordinate.py <x> <y> <z> --radius 8 --top 15;术语查询示例:python3 scripts/search_by_term.py "working memory" --top 10 --with-coordinates。
限制:术语必须精确匹配(区分大小写),未命中会返回建议而非猜测;每次解码同时检验约 3,228 个术语,须报告 FDR 校正后的 q 值而非仅原始 p 值;这是简化的反向推断检验,不是完整 ALE/MKDA 流程,若需发表级精度应改用 NiMARE;数据库仅含已发表峰值坐标与术语权重,不含原始 fMRI 体素数据;附近研究少于 --min-studies(默认 5)时会明确失败,应扩大半径。下载失败须停止并报告,不得使用部分数据或编造结果。