使用帮助
1. 平台简介
POINEER 基于样本遗传变异计算基因集突变负荷,并结合预训练模型评估原发性卵巢功能不全(POI)的发病风险。
注意:如需要使用模型进行预测,mutations应是MAF < 1% in EAS population in public databases (including gnomAD, and 1000 Genomes)。
1.1 分析流程
POINEER平台提供四个步骤的完整分析流程:
- 步骤1 - MAF文件分析:上传MAF格式突变文件,进行基础统计分析和可视化
- 步骤2 - 基因水平分析:将位点突变转换为基因水平的样本-基因突变矩阵
- 步骤3 - 基因集分析:计算基因集突变负荷,进行标准化和统计分析
- 步骤4 - 风险预测:基于基因集cluster突变负荷,使用预训练模型预测POI风险
- 步骤5 - 分子分型:根据关键基因突变对POI样本进行亚型标注并统计分布
2. 各步骤详细说明
2.1 步骤1 - MAF文件分析
功能:上传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文件,行为基因集,列为样本,值为突变基因计数(标准化为百分比)
输出内容:基因集突变负荷矩阵、统计信息(均值、中位数、最大值、最小值、标准差)、Top基因集箱线图
2.4 步骤4 - 风险预测
功能:基于基因集cluster突变负荷,使用预训练模型预测POI风险
输入:步骤3生成的基因集突变计数矩阵
处理流程:
- 根据cluster映射文件,将基因集按cluster聚合
- 计算每个cluster的突变负荷(使用加权求和公式)
- 按 BP cluster 成员关系聚合:每个特征 = cluster 内全部成员 GO BP term 的突变基因数之和
- 使用 13 特征弹性网模型(POINEER-v2-13feat)进行 POI 风险预测(三档:低/临界/高)
输出内容:预测概率(predict_prob)、预测标签(predict_label:1=高风险,0=低风险)、风险分布图、样本排名图
2.5 步骤5 - 分子分型
功能:在POI预测为高风险的样本中,根据UBE3B/UBE4B与MYO16/POLE/SPDL1的突变状态进行分子亚型标注
输入:步骤2的基因突变矩阵 与步骤4的预测结果(predict_label)
输出:分子分型计数、分子分型barplot、包含分子亚型字段的预测结果表格与下载文件
3. 示例文件下载
您可以下载以下示例文件来了解正确的数据格式:
4. 分析参数说明
- 步骤1(MAF分析):自动进行基础统计,无需额外参数
- 步骤2(基因分析):可设置显示的前N个基因和样本数量(默认各50个)
- 步骤3(基因集分析):可设置显示的前N个基因集(默认10个)
- 步骤4(分类预测):使用预训练模型,预测阈值固定为0.5(predict_prob ≥ 0.5为高风险)
- 步骤5(分子分型):无需额外参数,对Step 4预测为高风险的样本按关键基因突变状态进行分型
5. 结果解读
步骤4输出字段说明:
- predict_prob:POI发病风险概率(0-1之间),数值越高表示风险越大
- predict_label:预测标签,1表示高风险,0表示低风险
- risk_category:风险类别,High Risk(高风险)或Low Risk(低风险)
预测阈值:默认使用0.5作为阈值,predict_prob ≥ 0.5预测为高风险,否则为低风险。
步骤5输出字段说明:
- molecular_subtype:分子分型结果(可能同时包含两种亚型,若同时满足则用分号分隔)
- subtype_protein_K48_ubiquitination:关键基因的突变标记(true/false)
- subtype_regulation_mitotic_cell_cycle:关键基因的突变标记(true/false)
6. 常见问题
MAF文件上传失败
请确保MAF文件包含必需的列:Hugo_Symbol, Tumor_Sample_Barcode, Variant_Classification。文件可以是制表符分隔(.maf, .tsv)或逗号分隔(.csv)格式。
基因矩阵格式错误
基因-样本矩阵应为CSV格式,第一行为样本ID,第一列为基因名称,矩阵值为突变计数(整数)。请参考示例文件格式。
分析时间过长
分析时间取决于数据大小:MAF文件分析通常需要几秒到几分钟;基因矩阵转换可能需要几分钟;基因集分析和风险预测通常较快(几秒到几十秒)。
如何理解预测结果?
predict_prob值在0-1之间,越接近1表示POI风险越高。默认阈值0.5:≥0.5为高风险,<0.5为低风险。您可以根据实际需求调整阈值。
7. 联系我们
如果您在使用本工具过程中遇到任何问题或有任何建议,请随时联系我们:
我们的工作时间是周一至周五,9:00-17:00(北京时间)。我们会在24小时内回复您的邮件。