|
|
| (67 intermediate revisions by 3 users not shown) |
| Line 1: |
Line 1: |
| − | '''MaCH''' (MArkov Chain Haplotyping), mostly known as a software for genotype imputation, is a Hidden Markov Model (HMM) based haplotyper that reconstructs haplotypes from genotypes of unrelated individuals. Three primary utilities of MaCH are (1) to resolve haplotypes from diploid genotypes; (2) impute missing genotypes; and (3) perform disease mapping analysis. | + | '''MaCH''' is a tool for haplotyping, genotype imputation and disease association analysis developed by Goncalo Abecasis and Yun Li. MaCH was first used to imputed missing genotypes in our FUSION genomewide association study ([http://www.sph.umich.edu/csg/abecasis/publications/17463248.html Scott et al, ''Science'', 2007]) and has since been used in the analysis of many other GWAS. |
| | | | |
| − | <br>
| + | This page includes links to several useful MaCH related resources. |
| | | | |
| − | == Input Files ==
| + | * The main MaCH webpage at http://www.sph.umich.edu/csg/abecasis/MaCH/ |
| | + | * The MaCH download page, with source code, executables and reference haplotype files at http://www.sph.umich.edu/csg/abecasis/MaCH/download/ |
| | + | * The MaCH tutorial at http://www.sph.umich.edu/csg/abecasis/MaCH/tour/ |
| | + | * [[MaCH FAQ|The MaCH FAQ]] |
| | + | * [[MaCH Options|MaCH Options]] |
| | + | * [[MaCH: Input Files|Information on MaCH input formats]] |
| | + | * [[MaCH: 1000 Genomes Imputation Cookbook|1000 Genomes Imputation Cookbook]] |
| | + | * [[MaCH: machX|Chromosome X Imputation]] |
| | + | * [[Mach2dat: Association with MACH output]] |
| | | | |
| − | Mach takes unphased genotypes of unrelated individuals as input. Two input files are mandatory: a pedigree file and a marker information file. The pedigree file stores five key pieces of information and genotypes for each individual, with missing genotypes accepted and additional phenotypes allowed. The marker information file provides the list of marker names. Note that the list must be in order according to physical positions of the markers along the chromosomes. For more details, refer to http://www.sph.umich.edu/csg/abecasis/Merlin/tour/input_files.html. <br>
| + | Currently, it also includes random notes on input file formats, but these probably need to be cleaned up! |
| | | | |
| − | === '''Pedigree File (mandatory)'''<br> ===
| + | [[Category:Software]] |
| − | | |
| − | Each person contributes to one line in a pedigree file. Required fields are (1) the first five fixed fields corresponding to five key pieces of information (namely: family person father mother sex), and (2) genotype fields. Phenotype fields are allowed inbetween but will not be used by the program. <br>
| |
| − | | |
| − | <sample.ped> <br>
| |
| − | | |
| − | fam1 indiv1 0 0 1 0/0 2/3 ./.
| |
| − | fam2 indiv2 0 0 2 1/2 2/2 1/4
| |
| − | | |
| − | <EOF sample.ped> <br>
| |
| − | | |
| − | This sample.ped contains 2 individuals. The first individual is from family fam1 with person ID indiv1 and no parental information available (father = 0, mother = 0). This person is a male (sex = 1). His genotypes are missing at the first and third markers (0/0 and ./.), and is 2/3 (C/G) at the second marker. Similarly, the second individual is from family fam2 with person ID indiv2 and no parental information available (father = 0, mother = 0). This person is a female (sex = 2). Her genotypes are 1/2 (A/C) at the first locus, 2/2 (Homozygous for C) at the second locus and 1/4 (A/T) at the third locus.
| |
| − | | |
| − | === '''Marker Information File (mandatory)'''<br> ===
| |
| − | | |
| − | <sample.dat><br>
| |
| − | | |
| − | M SNP1
| |
| − | M SNP2
| |
| − | M SNP3
| |
| − | | |
| − | <EOF sample.dat><br>
| |
| − | | |
| − | This file tells us that fields 6-8 in the pedigree file store genotypes for SNP1-3 correspondingly. Note again that the list of SNPs must be in their physical order along the chromosomes.
| |
| − | | |
| − | <br>
| |
| − | | |
| − | === '''Optional Input files'''<br> ===
| |
| − | | |
| − | ==== External/reference files ====
| |
| − | | |
| − | External/reference (e.g., HapMap) input files (snp and haplotype files) are optional. Mach 1.0 accepts two different formats: MACH format or HapMap format. <br>
| |
| − | | |
| − | ===== MACH format SNP File =====
| |
| − | | |
| − | ----
| |
| − | | |
| − | One line per SNP and one field (marker name) only.
| |
| − | | |
| − | For example:
| |
| − | | |
| − | marker1
| |
| − | marker2
| |
| − | ...
| |
| − | | |
| − | ===== MACH format Haplotype File =====
| |
| − | | |
| − | ----
| |
| − | | |
| − | One line per haplotype. <br> Heading identification fields are optional. <br> Each non-haplotype/heading field shall not start with a numeric digit. <br>
| |
| − | | |
| − | For example:
| |
| − | | |
| − | H_0001->H_0001 HAPLO1 2332323244332
| |
| − | H_0001->H_0001 HAPLO2 2332323422132
| |
| − | H_0002->H_0002 HAPLO1 3332323244332
| |
| − | H_0002->H_0002 HAPLO2 3311321242332
| |
| − | ...
| |
| − | | |
| − | ===== HapMap format reference files =====
| |
| − | | |
| − | HapMap format files can be downloaded from http://hapmap.org/downloads/phasing/2006-07_phaseII/phased/ or http://hapmap.org/downloads/phasing/2007-08_rel22/phased/
| |
| − | | |
| − | HapMap format SNP File: legend file downloaded from HapMap website <br> HapMap format Haplotype File: phase file downloaded from HapMap website <br>
| |
| − | | |
| − | <br> When using HapMap format files, turn on --hapmapFormat option.
| |
| − | | |
| − | mach1 -d sample.dat -p sample.ped -s genotypes_chr14_CEU_r21_nr_fwd_legend.txt -h genotypes_chr14_CEU_r21_nr_fwd_phased.gz --hapmapFormat ...
| |
| − | | |
| − | ==== Physical position file ====
| |
| − | | |
| − | ==== Parameter files ====
| |
| − | | |
| − | == Options ==
| |
| − | | |
| − | Input Files: --datfile Marker information file for subjects under study. --pedfile Pedigree file for subjects under study.
| |
| − | | |
| − | <br>
| |
| − | | |
| − | == FAQ ==
| |
| − | | |
| − | '''Q''': Where can I find combined HapMap reference files? <br> A: http://www.sph.umich.edu/csg/yli/mach/download/HapMap-r21.html <br><br>
| |
| − | | |
| − | Q: Where can I find HapMap III reference files? <br> A: http://www.sph.umich.edu/csg/yli/mach/download/ <br><br>
| |
| − | | |
| − | Q: Does --mle overwrite fed-in genotypes?<br> A: Yes. But rarely. --mle outputs the most likely genotype guesses by integrating over the probabilities of all possible configurations based on the reference haplotypes. The overwriting happens when the most likely guess differs from the experimental counterpart.<br><br>
| |
| − | | |
| − | Q: How do I get reference files for an region of interest? <br>
| |
| − | A: (1) For HapMapII format, download http://www.sph.umich.edu/csg/ylwtx/HapMapForMach.tgz <br>
| |
| − | | |
| − | (2) For MACH format, you can do the following:
| |
| − | | |
| − | (2-1) First, find the first and last SNP in the region you are interested in. Say "rsFIRST" and "rsLAST", defined according to position.
| |
| − | | |
| − | (2-2) Then:
| |
| − | | |
| − | @ first = `grep -n rsFIRST orig.snps | cut -f1 -d ':'`
| |
| − | @ last = `grep -n rsLAST orig.snps | cut -f1 -d ':'`
| |
| − | | |
| − | (2-3) Finally (assuming the third field contains the actual haplotypes, where alleles are separated by nothing):
| |
| − | | |
| − | awk '{print $3}' orig.hap | cut -c${first}-${last} > region.hap
| |
| − | | |
| − | <br>Q: Do I have to sort the pedigree file by physical positions? <br>
| |
| − | A: If you use external reference, you do not have to as long as the external reference is in correct order. **HOWEVER**, we strongly recommend sorting the pedigree files. <br><br>
| |
| − | | |
| − | <br>Q: What if I specified --states R where R exceeds the maximum possible (2*number diploid individuals - 2 + number_haplotypes)? <br>
| |
| − | A: mach automatically resets it to maximum possible value.
| |
| − | | |
| − | | |
| − | == Examples ==
| |
| − | | |
| − | Imputation
| |
| − | | |
| − | mach1 -d sample.dat -p sample.ped -s hapmap.snps -h hapmap.hap -r 100 -o phase
| |
