Ancestry Match Downloader

Ancestry Match Downloader插件简介

Ancestry Match Downloader插件描述

Ancestry Match Downloader is designed to use the new Ancestry DNA API to scan, ste,  download your current matches.
The extension limits the download to matches having 20cm  me in common.  This the 4th Cousin  Closer filter that Ancestry uses.  Ancestry does not include matches with less than 20cm shared in their in common matching.
Typically a user will have from up to 10000 matches that fall in this range.  The match scan will take approximately 1 minute per 5000 matches.  Scanning in common matches still takes a long time to complete.  If you have 2500 matches expect ICW scan to take around 30 minutes.  If you have 4000 matches expect it to take 2 hours.  If you have 6000 matches expect it to take 3 to 4 hours.

Updates: 
Version 0.1.4
Changed the default filenames f expt to include the test takers name.  Also I included the filter settings f Clusters in the file name. The Cluster file name will be NameICWClustersMaxCMMinCMPercentMinSize.XML.  

Version 0.1.3
Added message box to expt routines to show number of matches expted  clusters expted.  
Added me err catching to the expts.

Version 0.1.2
Added some err catching to the expt routines to catch incomplete scans of match data.
Added an message pop up when match scan is complete  ICW scan is complete.
Added an alert message if communication to Ancestry server is interrupted during a scan.

Version 0.1.1
Eliminated current ICW matches label.  When scanning ICW matches if you have close family matches it may take up to 15 seconds  so f the scanned ICW matches number to increase.  Be patient  trust that it is wking. Or open the developer tools with Ctrl+Shift+I  click the netwk tab to view the netwk requests in real time.
Added tree infmation to the cluster output.  The column beside the matches name will tell you if there is a common ancest identified, public  private tree,  number of people in the tree if it is linked to the match.  If there is no tree public  private it will simply say no tree.

Version 0.1.0
Cleaned up the user interface.
Added a filter to not include single match clusters. Set minimum cluster size to 2  me to filter small clusters.

Version 0.0.9 
Fixed some bugs that could cause crupt data to get saved to stage.
Combined the scan match infmation  tree infmation to a single button press.

Earlier Versions
Fixed a bug in the filter f clusters.  
Fixed a bug that prevented the last few ICW matches from being saved.
Modified saving of match data to stage to reduce cpu load.
Modified the expt icw matrix to reduce memy usage.  Large numbers of matches were causing out of memy crashes.
Changed extension to load into a new tab by default instead of being an iframe.  Scans now continue if you change to a new tab  window. 
Scan times greatly reduced.
Modified the In common matches download to eliminate unneeded requests.  This should speed up ICW downloads some.
Fixed a bug in sting In Common with matches
Updated match scanning f updates to Ancestry API that increased matches returned per page from 20 to 100.  This greatly reduces the time to scan matches  ICW matches.  Scans should now complete 5x faster than previously.

To Do:
I am wking on downloading matches pedigree trees  combining them into a single gedcom file.  Currently Ancestry beta allows viewing a 6 generation pedigree tree of matches even if you are not subscribed to ancestrys service.

Instructions f use:
In der f the extension to wk you must be signed in to your Ancestry account where you have access to the DNA test. 
I suggest opening a new window in chrome  then browsing to Ancestry.com.  Make sure you are logged in  then click the Extension ICON. The extension will load in a new tab  will stay active even if you switch to other tabs  windows.

1: On first use of the extension click the "Get Test IDs" button to populate the drop down with the available DNA tests on the signed in account.  The IDs will be sted locally.  You will only need to click the "Get Test IDs" the first time you run the extension unless you add me testers to your account.

2: Select the Testers name from the drop down selection box. This will populate the Number of matches field with the amount of matches currently available to scan f this tester.

Note: If you have previously scanned this tester it will also populate the number of matches previously scanned, number of matches scanned f tree infmation,  the number of matches that have been scanned f "In Common With" matches. 

3: To begin scanning the matches click the "Scan matches" button. If you have previously scanned your matches a prompt will appear to verify you wish to rescan the matches. "Match infmation scanned" will update as the matches are scanned  wks as a progress indicat. After all matches are scanned it will then scan the matches f tree infmation.  "Tree infmation scanned" will update to show progress of the scan.  Once complete Match infmation  Tree infmation numbers should match the "Number of Matches". 

Note: Ancestrys new api does not provide a means of getting only new matches so each time you wish to update the match database you must rescan all of your matches.

Note: The scan does not change the viewed status of a match. It essentially creates a list equivalent to the list of matches seen on Ancestrys site.

Note: If internet connection is lost  Ancestrys server has problems during the scan  the number of matches is different from the match infmation  tree infmation scanned you will need to rescan the matches by pressing scan matches  selecting OK from the message box.

Note: The program will retry a scan 3 times pri to giving up. 

4. The Matches in common with scan is a long scan but is required to use the clustering tool. The initial scan time will depend greatly on the number of matches you have  how interrelated those matches are.

Note: A tester that has 2000 matches where the average matches in common f each match is less than 100 will take 30 mins to complete.

Note: A tester that has 5000 matches where the average matches in common f each match is 200 will take 3 hours to complete.

5. If somehow the Matches in common scan fails (internet connection fails etc..) the last match fully scanned will be saved.  You can resume the scan as long as you have not run the Scan Matches to update your list of scanned matches. Click the resume button to continue a failed scan of ICW matches.

Note: Clicking Resume will prompt you to continue a failed scan.  Select ok to continue.

6. If you have updated your scanned matches since last running "Scan ICW" select "Update" instead of "Resume".  This will continue scanning your in common matches  will update the previously scanned matches that are in common with any new matches.

7. "Expt Matches" button will dump all the saved match infmation f the current tester in CSV fmat. 

Note: ICW match IDs are appended at the end of each row of matches.

Note: The columns labeled 1000 to 1023 represent any custom col tags that the tester has used to tag their matches.

Note: Expt may take up to 1 minute to complete if you have a large number of matches.

8. "Expt" button creates 2 CSV files.  The first containing the match infmation without the ICW data.  The second being a matrix of the testers matches with the ICW matches marked with an "X".

Note:  The 2nd file ICW Matrix may take up to 1 min to output.

9. "Cluster" button runs a clustering routine on the ICW match data. It creates clusters based on the matches that fall  "Max CM"  "Min CM".  Use the "Min percent of matches in common" to tighten up the clusters. Default is 50% however 65%  me may give better results.  The Max CM should be set below the value of any 1C1R matches f best results. The min CM will increase  decrease the number of clusters. Set minimum cluster size to 2  me to filter small clusters.

Note: The output of the Clusters is an Excel XML Spreadsheet file.  This fmat can be directly opened in Excel 2007  newer. 

Note: The XML will have 1 wksheet f each cluster  will already have the rows/columns fmatted to make viewing easier.

Note: The routine counts the number of times a match shows up as an ICW match to those in the cluster  the value shown in each column is that.

Note: The matches are sted based on that value.

Note: I hope to continue wking on the algithm  improve the cluster outputs in future versions.

Note: If a CSV file output is desired I can add this to the output.  All of the clusters would have to be on a single sheet though as CSV does not suppt multiple sheets.
                                

Ancestry Match Downloader插件离线安装方法

1.首先用户点击谷歌浏览器右上角的自定义及控制按钮，在下拉框中选择设置。

2.在打开的谷歌浏览器的扩展管理器最左侧选择扩展程序或直接输入：chrome://extensions/

3.找到自己已经下载好的Chrome离线安装文件xxx.crx，然后将其从资源管理器中拖动到Chrome的扩展管理界面中，这时候用户会发现在扩展管理器的中央部分中会多出一个”拖动以安装“的插件按钮。

4.下载 Ancestry Match DownloaderChrome插件v0.1.4版本到本地。

5.勾选开发者模式，点击加载已解压的扩展程序，将文件夹选择即可安装插件。

注意：最新版本的chrome浏览器直接拖放安装时会出现“程序包无效CRX-HEADER-INVALID”的报错信息，参照这篇文章即可解决