应用截图
详细介绍
下载 Ancestry DNA 匹配信息
Ancestry Match Downloader 使用新的 Ancestry DNA API 扫描、存储和下载您当前的匹配对象。
此扩展程序只下载共享 20cm 或以上的匹配对象。这是 Ancestry 使用的“四代表亲或更近”筛选条件。Ancestry 不会在共同匹配中包含共享少于 20cm 的匹配对象。
通常,用户在此范围内最多有 10000 个匹配对象。每扫描 5000 个匹配对象约需 1 分钟。扫描共同匹配仍需要很长时间。如果您有 2500 个匹配对象,预计 ICW 扫描约需 30 分钟;如果有 4000 个,预计需要 2 小时;如果有 6000 个,预计需要 3 到 4 小时。
更新:
版本 0.1.4
更改了默认导出文件名,使其包含测试者姓名。聚类文件名中还包含聚类筛选设置。聚类文件名格式为 Name-ICW-Clusters-MaxCM-MinCM-Percent-MinSize.XML。
版本 0.1.3
为导出过程添加消息框,显示导出的匹配对象和聚类数量。
为导出添加更多错误捕获功能。
版本 0.1.2
为导出过程添加错误捕获功能,以检测不完整的匹配数据扫描。
在匹配扫描和 ICW 扫描完成时添加弹出消息。
如果扫描期间与 Ancestry 服务器的通信中断,则显示警告消息。
版本 0.1.1
移除了当前 ICW 匹配对象标签。扫描 ICW 匹配对象时,如果您有近亲匹配对象,已扫描的 ICW 匹配对象数量可能需要约 15 秒才会增加。请耐心等待,相信程序正在运行。您也可以按 Ctrl+Shift+I 打开开发者工具,点击网络标签页实时查看网络请求。
在聚类输出中添加家族树信息。匹配对象姓名旁边的列会显示是否发现共同祖先、家族树是公开还是私有,以及关联家族树中的人数。如果没有公开或私有家族树,则只会显示没有家族树。
版本 0.1.0
整理了用户界面。
添加筛选功能,排除只有一个匹配对象的聚类。将最小聚类大小设置为 2 或更大,即可筛除小型聚类。
版本 0.0.9
修复了可能导致损坏数据被保存到存储中的一些错误。
将扫描匹配信息和家族树信息合并为一次按钮操作。
早期版本
修复了聚类筛选器中的一个错误。
修复了最后几个 ICW 匹配对象无法保存的错误。
修改了匹配数据的存储方式,以降低 CPU 负载。
修改了 ICW 矩阵导出方式,以减少内存使用。大量匹配对象曾导致内存不足而崩溃。
更改扩展程序,使其默认在新标签页中加载,而不是使用 iframe。切换到新标签页或窗口后,扫描现在可以继续进行。
大幅缩短了扫描时间。
修改共同匹配下载,消除不必要的请求。这应该能在一定程度上加快 ICW 下载速度。
修复了存储共同匹配对象时的一个错误。
针对 Ancestry API 的更新调整了匹配扫描:每页返回的匹配对象从 20 个增加到 100 个。这大幅减少了扫描匹配对象和 ICW 匹配对象所需的时间。现在扫描完成速度应该是之前的 5 倍。
待办事项:
我正在开发下载匹配对象的祖先谱系树并将其合并为单个 gedcom 文件的功能。目前,即使没有订阅 Ancestry 的服务,Ancestry 测试版也允许查看匹配对象的六代祖先谱系树。
使用说明:
要使扩展程序正常工作,您必须登录有权访问该 DNA 测试的 Ancestry 账号。
我建议在 Chrome 中打开新窗口,然后访问 Ancestry.com。确认已登录后,点击扩展程序图标。扩展程序将在新标签页中加载,即使您切换到其他标签页或窗口也会保持运行。
1:首次使用扩展程序时,点击“Get Test IDs”按钮,让下拉列表显示已登录账号中可用的 DNA 测试。ID 将保存在本地。除非您在账号中添加了更多测试者,否则只需在首次运行扩展程序时点击“Get Test IDs”。
2:从下拉选择框中选择测试者姓名。随后,匹配对象数量字段将显示当前可供该测试者扫描的匹配对象数量。
注意:如果您之前扫描过该测试者,还会显示之前扫描的匹配对象数量、已扫描家族树信息的匹配对象数量,以及已扫描“In Common With”匹配对象的数量。
3:点击“Scan matches”按钮开始扫描匹配对象。如果您之前扫描过匹配对象,将出现提示,确认您是否希望重新扫描。“Match information scanned”会随着扫描进行而更新,作为进度指示。扫描完所有匹配对象后,程序将扫描其家族树信息。“Tree information scanned”会更新以显示扫描进度。完成后,匹配信息和家族树信息的数量应与“Number of Matches”一致。
注意:Ancestry 的新 API 不提供只获取新匹配对象的方法,因此每次更新匹配数据库时都必须重新扫描所有匹配对象。
注意:扫描不会改变匹配对象的已查看状态。它实际上创建了一个与 Ancestry 网站上显示的匹配对象列表相当的列表。
注意:如果扫描期间互联网连接中断或 Ancestry 服务器出现问题,导致匹配对象数量与已扫描的匹配信息和家族树信息数量不同,您需要点击扫描匹配对象按钮,并在消息框中选择 OK 来重新扫描。
注意:程序会在放弃前重试扫描 3 次。
4. 共同匹配对象扫描耗时较长,但使用聚类工具需要完成此扫描。初次扫描时间在很大程度上取决于匹配对象的数量以及他们彼此之间的关联程度。
注意:如果测试者有 2000 个匹配对象,且每个匹配对象平均有少于 100 个共同匹配对象,扫描需要 30 分钟完成。
注意:如果测试者有 5000 个匹配对象,且每个匹配对象平均有 200 个共同匹配对象,扫描需要 3 小时完成。
5. 如果共同匹配对象扫描因某种原因失败(例如互联网连接中断),最后一个完全扫描的匹配对象会被保存。只要您没有运行 Scan Matches 更新已扫描的匹配对象列表,就可以恢复扫描。点击恢复按钮,继续失败的 ICW 匹配对象扫描。
注意:点击 Resume 后会提示您继续失败的扫描。选择 ok 继续。
6. 如果自上次运行“Scan ICW”以来更新过已扫描的匹配对象,请选择“Update”,而不是“Resume”。这会继续扫描共同匹配对象,并更新之前扫描过的、与任何新匹配对象共同匹配的对象。
7. “Export Matches”按钮会以 CSV 格式导出当前测试者的所有已保存匹配信息。
注意:ICW 匹配对象 ID 会附加在每一行匹配记录的末尾。
注意:标记为 1000 至 1023 的列代表测试者用于标记匹配对象的自定义颜色标签。
注意:如果匹配对象数量较多,导出可能需要最多 1 分钟。
8. “Export”按钮会创建 2 个 CSV 文件。第一个包含不含 ICW 数据的匹配信息。第二个是测试者匹配对象的矩阵,其中 ICW 匹配对象用“X”标记。
注意:第二个文件 ICW Matrix 可能需要最多 1 分钟才能输出。
9. “Cluster”按钮会对 ICW 匹配数据运行聚类程序。它根据介于“Max CM”和“Min CM”之间的匹配对象创建聚类。使用“Min percent of matches in common”可以使聚类更紧密。默认值为 50%,但 65% 或更高可能产生更好的结果。为获得最佳结果,Max CM 应设置为低于任何 1C1R 匹配对象的值。Min CM 会增加或减少聚类数量。将最小聚类大小设置为 2 或更大,即可筛除小型聚类。
注意:聚类输出为 Excel XML 电子表格文件。此格式可以直接在 Excel 2007 或更新版本中打开。
注意:XML 中每个聚类都有一个工作表,行和列已经过格式化,方便查看。
注意:程序会计算匹配对象作为聚类中其他对象的 ICW 匹配对象出现的次数,并在各列显示该数值。
注意:匹配对象按该数值排序。
注意:我希望在未来版本中继续改进算法和聚类输出。
注意:如果需要 CSV 文件输出,我可以添加此功能。但由于 CSV 不支持多个工作表,所有聚类都必须放在同一个工作表中。