Documentation error in RNAseq workflow

We discovered today that we made an error in the documentation article that describes the RNAseq Best Practices workflow. The error is not critical but is likely to cause an increased rate of False Positive calls in your dataset.

The error was made in the description of the "Split & Trim" pre-processing step. We originally wrote that you need to reassign mapping qualities to 60 using the ReassignMappingQuality read filter. However, this causes all MAPQs in the file to be reassigned to 60, whereas what you want to do is reassign MAPQs only for good alignments which STAR identifies with MAPQ 255. This is done with a different read filter, called ReassignOneMappingQuality. The correct command is therefore:

java -jar GenomeAnalysisTK.jar -T SplitNCigarReads -R ref.fasta -I dedupped.bam -o split.bam -rf ReassignOneMappingQuality -RMQF 255 -RMQT 60 -U ALLOW_N_CIGAR_READS

In our hands we see a bump in the rate of FP calls from 4% to 8% when the wrong filter is used. We don't see any significant amount of false negatives (lost true positives) with the bad command, although we do see a few more true positives show up in the results of the bad command. So basically the effect is to excessively increase sensitivity, at the expense of specificity, because poorly mapped reads are taken into account with a "good" mapping quality, where they would normally be discarded.

This effect will be stronger in datasets with lower overall quality, so your results may vary. Let us know if you observe any really dramatic effects, but we don't expect that to happen.

To be clear, we do recommend re-processing your data if you can, but if that is not an option, keep in mind how this affects the rate of false positive discovery in your data.

We apologize for this error (which has now been corrected in the documentation) and for the inconvenience it may cause you.


Thanks for the correction! I was actually wondering a little bit why you changed every score.

Wed 11 Jun 2014


Thanks for the correction Geraldine!

Wed 11 Jun 2014

Search blog by tag

2013 acceleration ad agbt14 appistry ashg ashg2014 belgium best-practices beta blog brussels bug bug-fixed cancer catvariants challenge cloud combinegvcfs combinevariants commandline commandlinegatk commercial compbio competition conferences denovo depthofcoverage diagnosetargets downtime error fastaalternatereferencemaker fix forum gatk gatk-3-0 gatk-3-2 gatk3 genotype genotypegvcfs genotyperefinement google gsa gvcf haploid haplotypecaller hardware holiday htsjdk ibm indelrealigner job job-offer jobs joint-analysis joint-discovery key license media meetings mendelianviolations multisample multithreading mutect nt pairhmm paper patch performance phone-home picard pipeline ploidy polyploid poster presentations press printreads queue randomlysplitvariants readbackedphasing reducereads reference-model release release-notes rnaseq search selectvariants service slides snow spam speed splitncigarreads status sting support syntax talks team third-party-tools topstory trivia troll unifiedgenotyper variantannotator variantrecalibrator variantstobinaryped version-highlights versions video videos vqsr webinar workshop

GATK Dev Team

30 Jul 15
RT @fdmts: Compression, deduplication, and caching perform radically better on files made exclusively of zeroes. #protip #bestpractice #ben…
29 Jul 15
RT @dgmacarthur: Interested in using massive data sets to improve the lives of rare disease families? Work with my team:…
29 Jul 15
RT @fdmts: @gatk_dev uses CRISPR to merge collisions in the code repository. #crisprfacts
23 Jul 15
New patch version 3.4-46 released; get the latest #GATK bugfixes now now
9 Jul 15