使用帮助
1. 平台简介
POINEER(POI Network for Early Evaluation and Recognition)围绕样本的遗传变异(SNV/Indel 等)计算 BP cluster 水平的突变负荷,并使用 13 特征弹性网(elastic-net)逻辑回归模型评估早发性卵巢功能不全(POI)的发病风险,输出连续概率与低/临界/高三档风险。模型在 174 例中国人群发现队列(88 例 POI / 86 例对照)上训练,并在独立病例队列中完成外部验证。本平台仅供科研使用。
注意:如需要使用模型进行预测,突变应在公共数据库(包括gnomAD和1000 Genomes)的东亚人群(EAS)中MAF < 1%。
1.1 分析流程
POINEER 平台提供五个步骤的完整分析流程:
- 步骤1 - 数据导入:上传 MAF 突变文件并进行基础统计与质量控制
- 步骤2 - 矩阵构建:将位点级突变转换为样本×基因突变矩阵
- 步骤3 - 突变负荷:在 GO BP term 水平统计每个样本发生突变的基因个数(term 负荷),并做基因集大小归一化与统计分析
- 步骤4 - 分类预测:按 BP cluster 聚合成员 term 的负荷得到 13 个特征,经 log1p + z-score 标准化后由弹性网模型输出风险概率与三档风险
- 步骤5 - 分子分型:根据关键基因突变对 POI 样本进行分子亚型标注并统计分布
2. 各步骤详细说明
2.1 步骤1 - 数据导入
功能:上传 MAF 格式突变文件,进行基础统计分析和简单质量控制
输入格式:MAF (Mutation Annotation Format) 文件,必需列包括:
- Hugo_Symbol:基因名称
- Tumor_Sample_Barcode:样本ID
- Variant_Classification:变异分类(如Missense_Mutation, Nonsense_Mutation等)
- Chromosome:染色体位置(可选)
输出:基础统计信息、突变谱图、样本分布图、染色体分布图
2.2 步骤2 - 矩阵构建
功能:将 MAF 文件中的位点突变转换为基因水平的样本×基因突变矩阵
输入:MAF文件(来自步骤1)或已转换的基因-样本矩阵
输出格式:CSV文件,行为样本,列为基因,值为突变位点计数
输出内容:基因-样本突变矩阵、突变热图、基因突变统计
2.3 步骤3 - 突变负荷
功能:计算每个样本在各基因集中突变的基因个数(突变负荷),并进行标准化和统计分析
输入:步骤2生成的基因-样本突变矩阵
基因集来源:GO Biological Process(c5.go.bp.v2025.1.Hs.symbols)。
输出格式:CSV 文件,行为基因集(BP term),列为样本;值为该 term 内突变基因的个数;图表中可展示按基因集大小归一化后的负荷
输出内容:基因集突变负荷矩阵、统计信息(均值、中位数、最大值、最小值、标准差)、Top基因集箱线图
2.4 步骤4 - 分类预测
功能:将 BP cluster 的突变负荷特征送入 13 特征弹性网模型(POINEER-v2-13feat),输出 POI 风险概率与三档风险
输入:步骤3生成的基因集突变计数矩阵
处理流程:
- 读取 BP cluster 定义(poineer13_clusters.json):13 个模型特征及其各自的成员 GO BP term
- 将每个特征对应 cluster 内全部成员 term 的突变负荷相加,得到 cluster 水平突变负荷
- 对 13 个特征依次做 log1p 与 z-score 标准化(使用训练期固定的均值与标准差)
- 弹性网逻辑回归输出 predict_prob,并按锁定阈值划分三档(rule-out ≤ 0.316 低风险、0.316–0.668 临界、rule-in ≥ 0.668 高风险);单阈值 0.574 仅用于二分类标签 predict_label
输出内容:预测概率(predict_prob)、预测标签(predict_label:1=高风险,0=低风险)、风险档位(低/临界/高)、风险分布图、样本排名图
2.5 步骤5 - 分子分型
功能:在POI预测为高风险的样本中,根据关键基因的突变状态进行分子亚型标注
输入:步骤2的基因突变矩阵 与步骤4的预测结果(predict_label)
输出:分子分型计数、分子分型barplot、包含分子亚型字段的预测结果表格与下载文件
3. 示例文件下载
以下示例文件取自同一批 8 例真实队列样本(3 高风险 / 2 临界 / 3 低风险),与各分析步骤「一键运行示例」所用的数据完全一致,可依次跑通五个步骤:
4. 分析参数说明
- 步骤1(数据导入):自动进行基础统计与质控,无需额外参数
- 步骤2(矩阵构建):可设置显示的前N个基因和样本数量(默认各50个)
- 步骤3(突变负荷):可设置显示的前N个基因集(默认10个)
- 步骤4(分类预测):使用 13 特征弹性网模型;阈值在开发集上锁定,页面不可调整 —— rule-out 0.316 与 rule-in 0.668 用于三档风险,单阈值 0.574 用于二分类标签 predict_label
- 步骤5(分子分型):无需额外参数,对Step 4预测为高风险的样本按关键基因突变状态进行分型
5. 结果解读
步骤4输出字段说明:
- predict_prob:POI发病风险概率(0-1之间),数值越高表示风险越大
- predict_label:预测标签,1表示高风险,0表示低风险
- risk_category:风险类别,High Risk(高风险)/ Equivocal(临界)/ Low Risk(低风险)
判定阈值(开发集锁定,页面不可调)——三档风险由一对临床阈值决定:rule-out 0.316(predict_prob ≤ 0.316 判为低风险,用于高敏感排除,覆盖约 95% 病例)、rule-in 0.668(≥ 0.668 判为高风险,用于高特异提示,约 95% 对照低于此值),两者之间 0.316–0.668 为临界灰区(建议进一步遗传学检测)。另有单阈值 0.574(开发集对照样本分数的 90% 分位),仅用于生成二分类标签 predict_label,并作为分子亚型分析的入选依据;该阈值落在灰区内部,与三档规则用途不同,不可混用。
步骤5输出字段说明:
- molecular_subtype:分子分型结果(可能同时包含两种亚型,若同时满足则用分号分隔)
- subtype_protein_K48_ubiquitination:关键基因的突变标记
- subtype_regulation_mitotic_cell_cycle:关键基因的突变标记
6. POINEER-AI 智能助手
POINEER-AI 是内嵌于本平台的 POI 领域智能助手,点击右下角悬浮按钮即可唤起。它面向缺乏生物信息学背景的临床与科研用户,帮助解读分类结果、理解关键生物学过程,并实时检索相关文献。
助手由大语言模型驱动,经服务端代理调用;API 密钥仅保存在服务端,不会下发到浏览器。
主要能力:
结果解读
读取当前的分析结果(风险预测与分子分型),并结合平台锁定的判定规则给出结构化解读。
BP cluster 功能查询
查询关键 BP cluster(K48 泛素化、有丝分裂细胞周期调控)的功能机制、GO 编号与关键基因。
文献实时检索
通过 NCBI E-utilities 实时检索 PubMed,返回 PMID、标题、作者、期刊、年份与 DOI。
分析报告生成
汇总当前分析结果,生成标准化的 Markdown 分析报告,便于记录与整理。
使用方法:
- 点击页面右下角的圆形图标打开对话面板
- 用自然语言提问(中英文均可);Enter 发送,Shift+Enter 换行
- 若已运行过分析,助手会自动带入当前结果作为上下文;也可直接询问平台使用方法或 POI 相关知识
示例问题:
- “我的预测结果中临界档代表什么?”
- “K48 泛素化与 POI 有什么关联?”
- “生成一份当前分析结果的报告。”
边界说明:助手仅作为结果解读层,不参与模型预测,也不会修改任何分析结果或判定阈值;其输出属于科研辅助信息,不构成临床诊断依据。
隐私说明:对话内容与当前分析结果的摘要会发送至模型服务用于生成回答;请勿在对话中提交受试者身份信息等敏感数据。
7. 常见问题
MAF文件上传失败
请确保MAF文件包含必需的列:Hugo_Symbol, Tumor_Sample_Barcode, Variant_Classification。文件可以是制表符分隔(.maf, .tsv)或逗号分隔(.csv)格式。
基因矩阵格式错误
基因-样本矩阵应为CSV格式,第一行为样本ID,第一列为基因名称,矩阵值为突变计数(整数)。请参考示例文件格式。
分析时间过长
分析时间取决于数据大小:MAF文件分析通常需要几秒到几分钟;基因矩阵转换可能需要几分钟;基因集分析和风险预测通常较快(几秒到几十秒)。
如何理解预测结果?
predict_prob 为 0–1 的风险概率,平台按两套规则解读。① 三档风险(用于临床沟通):≤ rule-out 0.316 为低风险(POI 排除)、≥ rule-in 0.668 为高风险(POI 提示)、其间为临界(建议结合 panel 或随访进一步检测)。② 单阈值 0.574(用于二分类):仅生成 predict_label(1=阳性,0=阴性),并决定哪些样本进入步骤5的分子亚型分析。三个阈值均在开发集上锁定、页面不提供调整;单阈值位于灰区内部,与三档规则不可混用。
8. 联系我们
如果您在使用本工具过程中遇到任何问题或有任何建议,请随时联系我们:
我们的工作时间为周一至周五,9:00-17:00(北京时间)。我们会在24小时内回复您的邮件。