VCF2Dis

VCF2Dis: A new simple and efficient software to calculate p-distance matrix and construct phylogeny based Variant Call Format input

1) Install and Parameter

1. Install

The new version will be updated and maintained in hewm2008/VCF2Dis, please click below Link to download the latest version

hewm2008/VCF2Dis

Download

Just sh make.sh to compile. The executable VCF2Dis can be found in the folder of bin/VCF2Dis
For Linux /Unix and macOS

        tar -zxvf  VCF2DisXXX.tar.gz            # if Link do not work ,Try re-install [zlib]library
        cd VCF2DisXXX;                          # [zlib] and copy them to the library Dir
        sh make.sh;                             # VCF2Dis-xx/src/include/zlib
        ./bin/VCF2Dis

Note: If fail to link,try to re-install the libraries zlib
Note:: R with ape, dplyr and ggtree are recommended

1. Main parameter description:

	Usage: VCF2Dis -InPut  <in.vcf>  -OutPut  <p_dis.mat>

		-InPut     <str>     Input one or muti GATK VCF genotype File
		-OutPut    <str>     OutPut Sample p-Distance matrix

		-InList    <str>     Input GATK muti-chr VCF Path List
		-SubPop    <str>     SubGroup SampleList of VCF File [ALLsample]
		-Rand      <float>   Probability (0-1] for each site to join Calculation [1]

		-help                Show more help [hewm2008 v1.52s]

For more details, please use -help and see the example

		-InFormat      <str>   Input File is [VCF/FA/PHY] Format,defaut: [VCF]
		-InSampleGroup <str>   InFile of sample Group info,format(sample groupA)
		-TreeMethod    <int>   Construct Tree Method,1:NJ-tree 2:UPGMA-tree [1]
		-KeepMF                Keep the Middle File diff & Use matrix

2) Example

Three examples were provided in the directory of example/Example*

1) an Example of nj-tree with no boostrap

1. To Create the p_distance matrix and construct nj-tree newick tree

# 1.1) To new all the sample p_distance matrix and newick tree based VCF, run VCF2Dis directly
      ./bin/VCF2Dis	-InPut	in.vcf.gz	-OutPut p_dis.mat
      #  ./bin/VCF2Dis     -InPut  in.fa.gz	-OutPut p_dis.mat -InFormat  FA

# 2.2) To new sub group sample p_distance matrix and and newick tree ; put their sample name into File sample.list
      ./bin/VCF2Dis	-InPut	chr1.vcf.gz chr2.vcf.gz	-OutPut p_dis.mat  -SubPop  sample.list

1. Simple tree visualization (for advanced tree display and annotation please refer to iTOL, Evolview, MEGA)
  you will obtain the p_dis.nwk tree file and neighbor-joining tree in pdf format p_dis.pdf after VCF2Dis.

Note::if you can't get the p_dis.nwk tree file but had the p_dis.mat, here are the 3 methods to get the tree file.

2) an Example of nj-tree with boostrap

1. Running multiple times by using a method of sampling with replacement. Users can randomly select a part of the sites [-Rand] and construct a new nj-tree as above, and Repeat NN times [recommand NN=100]. X=(1,2....NN);

    ./bin/VCF2Dis	-InPut	in.vcf.gz	-OutPut p_dis_X.mat    -Rand     0.25
    PHYLIPNEW-3.69.650/bin/fneighbor  -datafile p_dis_X.matrix  -outfile tree.out1_X.txt -matrixtype s -treetype n -outtreefile tree.out2_X.tre

How to Install PHYLIPNEW please Click on here or Click on here(Chinese)

1. Merge all the nj-tree and construct and display a boostrap nj-tree. (For advanced display tree and annotation please refer to iTOL, Evolview and MEGA)

	cat   tree.out2_*.tre   >  ALLtree_merge.tre
	PHYLIPNEW-3.69.650/bin/fconsense   -intreefile   ALLtree_merge.tre  -outfile out  -treeprint Y
	perl  ./bin/percentageboostrapTree.pl    ALLtree_merge.treefile    NN    Final_boostrap.tre

4) Introduction

The formula for calculating p-distance between indivisuals from VCF SNP datasets was listed below:

            D_ij=(1/L) * [(sum(d(l)_ij))]

Where L is the length of regions where SNPs can be identified, and given the alleles at position l are A/C between sample i and sample j:

            d(l)_ij=0.0     if the genotypes of the two individuals were AA and AA;
            d(l)_ij=0.5     if the genotypes of the two individuals were AA and AC;
            d(l)_ij=0.0     if the genotypes of the two individuals were AC and AC;
            d(l)_ij=1.0     if the genotypes of the two individuals were AA and CC;
            d(l)_ij=0.0     if the genotypes of the two individuals were CC and CC;

To further know about the p_distance matrix based the VCF file, please refer to this website.

5) Results

VCF2Dis have been cited in more than 150 times by searching against google scholar.
Below were some NJ-tree images that I draw in the paper before.

6) Discussing

📧 hewm2008@gmail.com / hewm2008@qq.com
join the QQ Group : 125293663

######################swimming in the sky and flying in the sea ########################### ##