161. New Picard version 1124 changes how Picard tools are invoked

IMPORTANT: This is the legacy GATK documentation. This information is only valid until Dec 31st 2019. For latest documentation and forum click here

created by Geraldine_VdAuwera

on 2014-11-05

Consider this a public service announcement, since most GATK users probably also use Picard tools routinely. The recently released version 1.124 of the Picard tools includes many lovely improvements, bug fixes and even a few new tools (see [release notes](http://sourceforge.net/p/samtools/mailman/message/32999384/) for full details) — but you’ll want to pay attention to one major change in particular.

From this version onward, the Picard release will contain a single JAR file containing all the tools, instead of one JAR file per tool as it was before. This means that when you invoke a Picar tool, you’ll invoke a single JAR, then specify which tool (which they call CLP for Command Line Program) you want to run. This should feel completely familiar if you already use GATK regularly, but it does mean you’ll need to update any scripts that use Picard tools to the new paradigm. Other than that, there’s no change of syntax; Picard will still use e.g. `I=input.bam` where GATK would use `-I input.bam`.

We will need to update some of our own documentation accordingly over the near future; please bear with us as we go through this process, and let us know by commenting in this thread if you find any docs that have yet to be updated.

Updated on 2014-11-24