Difference between revisions of "Minimac3"

From Genome Analysis Wiki
Jump to navigationJump to search
Line 1: Line 1:
 +
= Useful Wiki Pages =
 +
 +
There are a few pages in this Wiki that may be useful to for '''Minimac3''' users. Here are links to a few:
 +
 +
* [[Minimac3 | Minimac3 Overview Page]]
 +
 +
* [[Minimac3 Usage | Minimac3 Usage and Documentation]]
 +
 +
* [[Minimac3 Imputation Cookbook]] ('''Recommended for New Users!!''')
 +
 +
* [[Minimac3 Examples| Minimac3 Examples]]
 +
 +
* [[M3VCF Files| M3VCF Files]]
 +
 
= Introduction =
 
= Introduction =
  
'''Minimac3 ''' is a lower memory and more computationally efficient implementation of [http://genome.sph.umich.edu/wiki/Minimac2 minimac2]. It is an algorithm for genotypic imputation that works on phased genotypes (say from [http://genome.sph.umich.edu/wiki/MaCH MaCH]). minimac3 is designed to handle very large reference panels in a more computationally efficient way with no loss of accuracy. This algorithm analyzes only the unique sets of haplotypes in small genomic segments, thereby saving on time-complexity, computational memory but no loss in degree of accuracy.
+
'''Minimac3 ''' is a lower memory and more computationally efficient implementation of the genotype imputation algorithms in [Minimac] and [Minimac2|minimac2]. minimac3 is designed to handle very large reference panels in a more computationally efficient way with no loss of accuracy. It accomplishes this by identifying repeat haplotype patterns and using these to simplify the underlying calculations, with no loss of accuracy.
  
Minimac3, apart from performing imputation, also creates [[M3VCF Files|<font face=Courier>M3VCF</font> files]] (customized minimac3 VCF files) which are able to store reference panel information in a compact form, thus saving on memory and time required to read large datasets. User will have an option to use the binary code to either just convert VCF files to <font face=Courier>M3VCF</font> files or to perform imputation as well. The code can also take a previously generated <font face=Courier>M3VCF</font> file as input for the reference panel. <font face=Courier>M3VCF</font> files can also store pre-calculated estimates of recombination fraction and error, which can be used for later runs of imputation.  The latest version of Minimac3 also allows output in the form of VCF files for easier data manipulation in downstream analysis.
+
Minimac3 uses [[M3VCF Files|<font face=Courier>M3VCF</font> files]] (customized minimac3 VCF files) to store reference panel information in a compact form, thus saving on memory and time required to read large datasets. Users can use Minimac3 to convert standard VCF files to <font face=Courier>M3VCF</font> files. <font face=Courier>M3VCF</font> files can also store pre-calculated estimates of recombination fraction and error, which speeds up later rounds of imputation.  Minimac3 outputs results in the form of standard VCF files for easy data manipulation in downstream analysis.
  
 
= Download =
 
= Download =
  
'''Minimac3 ''' is available as an undocumented release version. The source files are available for download here and commonly used reference panels in <code>M3VCF</code> format are available for download in [[Minimac3 Imputation Cookbook#Reference Panels for Download | Reference Panels]]. The authors would really appreciate if users would use it on their data set and let us know of possible bugs to be fixed.  
+
'''Minimac3 ''' is currently available as a pre-release release version. Commonly used reference panels in <code>M3VCF</code> format are available for download in [[Minimac3 Imputation Cookbook#Reference Panels for Download | Reference Panels]]. The authors would really appreciate if users report possible bugs by e-mailing [[mailto:sayantan@umich.edu|Sayantan Das]].
 
 
* To Download Minimac3
 
  
 
{| class="wikitable" border="1" cellpadding="2"
 
{| class="wikitable" border="1" cellpadding="2"
Line 47: Line 59:
  
 
   /bin/Minimac3 --help
 
   /bin/Minimac3 --help
 
= Useful Wiki Pages =
 
 
There are a few pages in this Wiki that may be useful to for '''Minimac3''' users. Here are links to a few:
 
 
* [[Minimac3 Usage | Minimac3 Usage and Documentation]]
 
 
* [[Minimac3 Imputation Cookbook]] ('''Recommended for New Users!!''')
 
 
* [[Minimac3 Examples| Minimac3 Examples]]
 
 
* [[M3VCF Files| M3VCF Files]]
 
  
 
= Contact =
 
= Contact =
  
 
In case of any queries and bugs please contact [mailto:sayantan@umich.edu Sayantan Das].
 
In case of any queries and bugs please contact [mailto:sayantan@umich.edu Sayantan Das].

Revision as of 18:44, 29 January 2015

Useful Wiki Pages

There are a few pages in this Wiki that may be useful to for Minimac3 users. Here are links to a few:

Introduction

Minimac3 is a lower memory and more computationally efficient implementation of the genotype imputation algorithms in [Minimac] and [Minimac2|minimac2]. minimac3 is designed to handle very large reference panels in a more computationally efficient way with no loss of accuracy. It accomplishes this by identifying repeat haplotype patterns and using these to simplify the underlying calculations, with no loss of accuracy.

Minimac3 uses M3VCF files (customized minimac3 VCF files) to store reference panel information in a compact form, thus saving on memory and time required to read large datasets. Users can use Minimac3 to convert standard VCF files to M3VCF files. M3VCF files can also store pre-calculated estimates of recombination fraction and error, which speeds up later rounds of imputation. Minimac3 outputs results in the form of standard VCF files for easy data manipulation in downstream analysis.

Download

Minimac3 is currently available as a pre-release release version. Commonly used reference panels in M3VCF format are available for download in Reference Panels. The authors would really appreciate if users report possible bugs by e-mailing [Das].

Description Download Link
Minimac3 Executable UNIX Users
Minimac3-omp Executable (for parallel computing) UNIX Users
Minimac3 Source Files UNIX Users

Usage

Users should follow the following steps to compile Minimac3 (if they downloaded the source files) or should skip them (if they downloaded the binary executable).

## EXTRACT MINIMAC3 AND COMPILE
 
tar -xzvf Minimac3.v1.0.0.tar.gz
cd Minimac3/
make

A typical Minimac3 command line for imputation is as follows

../bin/Minimac3 --refHaps refPanel.vcf \ 
                --haps targetStudy.vcf \
                --prefix testRun

Here refPanel.vcf is the reference panel used in VCF format (e.g. 1000 Genomes), targetStudy.vcf is the phased GWAS data in VCF format, and testRun is the prefix for the output files. Some commonly used reference panels are available for download in Reference Panels. See wiki page on Detailed Usage and Imputation Cookbook for further details on using Minimac3 for imputation analysis.

Users can always type the following for further support:

 /bin/Minimac3 --help

Contact

In case of any queries and bugs please contact Sayantan Das.