Repolode
arvkevi

arvkevi/ezancestry

基于 1000 Genomes 样本的 Python 工具,可根据消费级基因检测数据预测个人的遗传祖源。

Star
70
Fork
10
未关闭 Issue
7
最近提交
上个月

这是什么?

ezancestry 可以从 23andMe、ancestry.com 等消费级基因检测输出的原始文件以及 VCF 文件中预测遗传祖源。它会把用户的基因型与 1000 Genomes 项目中 2500 多个样本放在一起比较,并使用基于祖源信息 SNP(AISNP)训练的 k 近邻分类器,给出洲际和地区人群标签。

项目内置了两套已发表 AISNP 位点集的预训练模型:Kidd 等人提出的 55 个位点,以及 Kosoy 等人(Seldin 实验室)提出的 128 个位点。预测可以在超级人群或具体人群两个层级进行,并支持基于 PCA 的降维。

项目提供 fetch、predict、plot、train 四个命令行命令,也提供 Python API。用户还可以提供自定义的 AISNP 列表并训练新模型,通过交叉验证报告评估该位点集区分祖源人群的效果。项目附带 Streamlit 应用和三维散点图用于可视化。

核心功能

  • 01支持从 23andMe、ancestry.com 和 VCF 文件预测祖源
  • 02将用户样本与 2500 多个 1000 Genomes 样本进行比较
  • 03内置 Kidd(55 个位点)和 Seldin(128 个位点)两套预训练 k 近邻模型
  • 04支持超级人群和具体人群两个层级的预测
  • 05允许用户基于自定义 AISNP 位点训练模型并生成交叉验证报告
  • 06提供三维散点图命令和 Streamlit 可视化应用

适用场景

  • 将消费级基因检测结果与参考人群并排可视化
  • 评估自定义祖源信息 SNP 位点集区分人群的能力
  • 使用 1000 Genomes 数据讲授或演示祖源推断
  • 对一批基因型文件进行批量祖源预测

快速上手

  1. 1

    使用 pip 安装 ezancestry

    pip install ezancestry
  2. 2

    从你的直接消费者基因数据文件预测祖源

    ezancestry predict mygenome.txt
  3. 3

    在浏览器中以三维散点图可视化预测结果

    ezancestry plot predictions.csv

使用前须知

  • 预测仅基于一小部分祖源信息SNP,并与1000 Genomes样本比较,因此结果只是近似值。
  • 不适用于医疗或临床决策,仅是研究和探索工具。

收录于专题

标签

#genomics#ancestry#machine-learning#bioinformatics#personal-genomics#data-visualization#streamlit#dimensionality-reduction#genomics-visualization#genotypes

常见问题

ezancestry 是什么?
基于 1000 Genomes 样本的 Python 工具,可根据消费级基因检测数据预测个人的遗传祖源。 ezancestry 可以从 23andMe、ancestry.com 等消费级基因检测输出的原始文件以及 VCF 文件中预测遗传祖源。它会把用户的基因型与 1000 Genomes 项目中 2500 多个样本放在一起比较,并使用基于祖源信息 SNP(AISNP)训练的 k 近邻分类器,给出洲际和地区人群标签。
ezancestry 可以免费使用吗?用的什么许可证?
ezancestry 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
ezancestry 还在维护吗?
半年内有更新。ezancestry 最近一次提交是在 2026年10月7日。
ezancestry 适合用来做什么?
将消费级基因检测结果与参考人群并排可视化 评估自定义祖源信息 SNP 位点集区分人群的能力 使用 1000 Genomes 数据讲授或演示祖源推断 对一批基因型文件进行批量祖源预测
ezancestry 怎么安装和运行?
使用 pip 安装 ezancestry: pip install ezancestry 从你的直接消费者基因数据文件预测祖源: ezancestry predict mygenome.txt 在浏览器中以三维散点图可视化预测结果: ezancestry plot predictions.csv
在哪里获取 ezancestry?
源代码和安装说明在 GitHub 上:https://github.com/arvkevi/ezancestry

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目