A production-ready tool to predict variant function

For the past year Funcotator has been a beta tool in GATK. With this new 4.1 release, Funcotator is (finally) out of beta and ready for use in a production environment. So... what exactly is Funcotator, and why should you care?

Funcotator is a functional annotator (FUNCtional annOTATOR) that reads in variants and adds useful information about their potential effects. It’s uses range from answering the question ‘in which gene (if any) does this variant occur’ to predicting an amino acid change string for variants that result in different protein structures. Accurate functional annotation is critical to turning vast amounts of genomic data into a better understanding of protein function.

Created to be a fast, functional, and accurate annotation tool that supports the hg38 genome, many recent updates have made Funcotator more robust and more correct. Of particular note - the protein change string algorithm can now account for protein changes that do not occur at the same amino acid position as a variant (such as when deletions occur in short tandem repeats). If you have a set of variants and wish to identify the genes affected and/or the protein amino acid sequence change, or if you simply wish to cross-reference your variants with a list of variants thought to be implicated in disease - Funcotator is the tool for you.

We publish two sets of data sources to go with Funcotator (including Gencode, ClinVar, gnomAD, and more) so it can be used out of the box and with minimal effort to add annotations to either germline or somatic variants. Best of all, it can be updated by you, the user, to include your favorite annotation data sources when you annotate your VCF files (with some caveats).

“Fun” means improved user experience and data output

A huge number of bug fixes and accuracy improvements mean output is now much better and more correct than Oncotator. As an example of improved user experience, the new FuncotatorDataSourceDownloader tool enables downloading the data sources from which annotations are created directly from the command-line. It is as simple as running ./gatk FuncotatorDataSourceDownloader --somatic to get the somatic data sources (though there are more options for the tool as well).

“Funcotator” versus “Oncotator” - very different annotator tools

A savvy user may want to compare Funcotator to the Broad’s previous functional annotation tool Oncotator. Despite similar names and purpose, they are VERY different pieces of software and a direct comparison cannot really be made. Funcotator is not Oncotator. The forum post below details some of the differences between the two tools.

Future of “Fun”

There are many features on the horizon for Funcotator (in addition to normal support and bug fixes). In the long-term, we would like greatly increase performance with a Spark version of Funcotator. Adding even more supported data formats for data sources will offer users additional options to add in annotations. Since it is in active development, there are always small features being added and bugs being fixed.

Check for current progress on the GATK Github page here: https://github.com/broadinstitute/gatk/labels/Funcotator

A forum post with a tutorial and some additional data can be found here: https://gatkforums.broadinstitute.org/dsde/discussion/11193/funcotator-information-and-tutorial

The tool documentation for Funcotator can be found here: https://software.broadinstitute.org/gatk/documentation/tooldocs/current/org_broadinstitute_hellbender_tools_funcotator_Funcotator.php

Return to top

Wed 20 Feb 2019

jmedarom on 20 Feb 2019

Hi, I am working with exome sequencing to find variants related to tuberculosis. What I understand from the tutorials is that Funcotator is used in cancer field. So, I would like to clarify whether it is correct to use Funcotator in my case. Also, I have used Variant Effector Predictor for the functional annotation before, because I like how the results are shown in this. Do you think that it is a good idea to use VEP with GATK workflows instead of Funcotator? Would I be losing something important if I do it?. Thank you so much for your support, Jenn

- Recent posts

- Upcoming events

See Events calendar for full list and dates

- Recent events

See Events calendar for full list and dates

- Follow us on Twitter

GATK Dev Team


RT @AlexNewmanUK: Had a great week learning more about #GATK from the great folks at the @broadinstitute and @gatk_dev! And thanks for the…
21 Jun 19
Thanks for hosting us, Matt! And thanks to this great group of participants... see you all on the forum! https://t.co/Ztfl03Ki4d
21 Jun 19
RT @vikkirand: @MattBashton @gatk_dev @TerraBioApp Really enjoying the course and very impressed with #GATK @TerraBioApp on google cloud ☁️🧬
20 Jun 19
Test drive GATK Best Practices workflows on @TerraBioApp -- new blog walks you through the basics at… https://t.co/brVTdHPcz7
19 Jun 19
GATK workshop in Newcastle, UK starts today! Thanks @MattBashton for hosting our team, we can’t wait to get started!
18 Jun 19

- Our favorite tweets from others

@gatk_dev would be great to have a GATK workshop!
22 Jun 19
We’ve all had a fantastic time at the #GATK @gatk_dev workshop in Newcastle, (I’m hiding at the back). Special tha… https://t.co/qeURQeJGnX
21 Jun 19
Had a great week learning more about #GATK from the great folks at the @broadinstitute and @gatk_dev! And thanks fo… https://t.co/A5b65BOmYt
21 Jun 19
Day four of the @gatk_dev workshop at Newcastle University ran by the @broadinstitute 🧬 learning how to run WDL scr… https://t.co/XnrPZEX6Yj
21 Jun 19
@MattBashton @gatk_dev @TerraBioApp Really enjoying the course and very impressed with #GATK @TerraBioApp on google cloud ☁️🧬
20 Jun 19

See more of our favorite tweets...