<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Recent changes to wiki</title><link>https://sourceforge.net/p/picard/wiki/</link><description>Recent changes to wiki</description><atom:link href="https://sourceforge.net/p/picard/wiki/feed.rss" rel="self"/><language>en</language><lastBuildDate>Thu, 24 Sep 2015 00:57:03 -0000</lastBuildDate><atom:link href="https://sourceforge.net/p/picard/wiki/feed.rss" rel="self" type="application/rss+xml"/><item><title>Main_Page modified by Geraldine A Van der Auwera</title><link>https://sourceforge.net/p/picard/wiki/Main_Page/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v68
+++ v69
@@ -1,7 +1,9 @@
 Picard comprises Java-based command-line utilities that manipulate SAM files, and a Java API (SAM-JDK) for creating new programs that read and write SAM files. Both SAM text format and SAM binary (BAM) format are supported..

-  
+## Note that this project has moved to https://github.com/broadinstitute/picard  

+## Documentation is now at https://broadinstitute.github.io/picard/
+## Support is now at http://gatkforums.broadinstitute.org/categories/ask-the-team

 [TOC]

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Geraldine A Van der Auwera</dc:creator><pubDate>Thu, 24 Sep 2015 00:57:03 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net31f389f317aebea9814bf387bf442d9fa07b0cf6</guid></item><item><title>Main_Page modified by Alec Wysoker</title><link>https://sourceforge.net/p/picard/wiki/Main_Page/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v67
+++ v68
@@ -138,3 +138,17 @@
 ### **Q:** What is IntelDeflater and how do I control it?

 **A** libIntelDeflater.so is a library that speeds compression on some Intel processors. See [IntelDeflater] for details. 
+
+### **Q:** What is the limit for the length of a reference sequence in SAM/BAM?
+
+**A** The BAM index format imposes a limit of 512MB for a single reference sequence.  If this limit is exceeded, various errors may occur depending on what steps have been taken, including the following: 
+
+~~~~~
+bin field of BAM record does not equal value computed based on alignment start and end, and length of sequence to which read is aligned
+
+Value too large to be written as ushort.
+
+java.lang.ArrayIndexOutOfBoundsException
+~~~~~
+
+If you want to create a BAM index, you will need to ensure that each reference sequence is less than 512MB, perhaps by splitting long reference sequences.
&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alec Wysoker</dc:creator><pubDate>Mon, 28 Jul 2014 15:18:52 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net8efde7d6043bcf10acb89c95ff56bc807a408234</guid></item><item><title>Main_Page modified by Alec Wysoker</title><link>https://sourceforge.net/p/picard/wiki/Main_Page/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v66
+++ v67
@@ -98,7 +98,7 @@

 ### **Q:** What is the format of an interval list file?

-**A:** Description of this format can be found in the [[javadoc](http://picard.sourceforge.net/javadoc/net/sf/picard/util/IntervalList.html)] 
+**A:** Description of this format can be found in the [[javadoc](http://picard.sourceforge.net/javadoc/htsjdk/htsjdk/samtools/util/IntervalList.html)] 

 ### **Q:** How should I invoke a Picard program from within my Java program? I call the main() method of the Picard program, but System.exit() is called when it finishes, which is not what I want.

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alec Wysoker</dc:creator><pubDate>Mon, 30 Jun 2014 15:18:03 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net084ca41fd702ac554b903e39e0f4e74245762555</guid></item><item><title>Using_Snappy_in_Picard modified by Alec Wysoker</title><link>https://sourceforge.net/p/picard/wiki/Using_Snappy_in_Picard/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v7
+++ v8
@@ -1,4 +1,4 @@
-[Snappy](http://code.google.com/p/snappy/) is an open-source compression library that emphasizes fast compression over maximum compression. [Snappy-java](http://code.google.com/p/snappy-java/) is a Java JNI wrapper for Snappy. If the Snappy library is installed on a system and made available to the JVM then Picard programs that sort large amounts of data will use it to compress temporary data before writing it to disk. This is a performance optimization only and is entirely optional. Snappy can reduce file I/O, and in some cases the savings in file I/O more than compensates for the time spent compressing and decompressing, and results in faster execution times. We have seen sort times reduced by nearly 25%, although your mileage may vary. 
+[Snappy](http://code.google.com/p/snappy/) is an open-source compression library that emphasizes fast compression over maximum compression. [Snappy-java](http://code.google.com/p/snappy-java/) is a Java JNI wrapper for Snappy. If the Snappy-java library is installed on a system and made available to the JVM then Picard programs that sort large amounts of data will use it to compress temporary data before writing it to disk. This is a performance optimization only and is entirely optional. Snappy can reduce file I/O, and in some cases the savings in file I/O more than compensates for the time spent compressing and decompressing, and results in faster execution times. We have seen sort times reduced by nearly 25%, although your mileage may vary.

@@ -7,23 +7,22 @@

 ## Requirements for using Snappy

-In order for Picard to use Snappy, two requirements must be met: 1) the Snappy-java classes must be available on Java's classpath; and 2) the Snappy DLL (dynamic-link library) must be available to Snappy-java. 
+In order for Picard to use Snappy, two requirements must be met: 1) the Snappy-java classes must be available on Java's classpath; and 2) the Snappy-java DLL (dynamic-link library) must be available to Snappy-java. 

 ### Making Snappy-java classes available

-If you use one of the executable jars in the Picard bundle (e.g. SortSam.jar), the Snappy-java classes are included in the executable jar so you need do nothing additional. However, if you are using sam-&amp;lt;version#&amp;gt;.jar, then you must also add the Snappy-java jar to the classpath. The jar can be found in the picard-tools-&amp;lt;version#&amp;gt;.zip file. 
+On Linux only, if you use one of the executable jars in the Picard bundle (e.g. SortSam.jar), the Snappy-java classes are included in the executable jar so you need do nothing additional. However, if you are using sam-&amp;lt;version#&amp;gt;.jar, or it you are on , then you must also add the Snappy-java jar to the classpath. The jar can be found in the picard-tools-&amp;lt;version#&amp;gt;.zip file. 

-### Obtaining the Snappy DLL
+### Obtaining the Snappy-java DLL

-Currently, the Snappy project only distributes source code. You can download the Snappy sources and build for your platform. Alternately, the Snappy-java jarfile contains Snappy DLLs for the most popular platforms, so you may extract it from there. 
+TYhe Snappy-java jarfile contains Snappy DLLs for the most popular platforms, so you may extract it from there. Note that the Snappy-java DLL is not the same as the Snappy DLL, because it contains JNI (Jave native interface) code in addition to the Snappy code itself. 

 ### Making the Snappy DLL available

-If the Snappy jar is on your classpath, Snappy-java can find the Snappy (DLL) automatically. However, if you use one of the executable jars (e.g. SortSam.jar), then you must make the Snappy DLL available for Snappy-java to load. There are several ways this can be done: 
+If the Snappy jar is on your classpath, Snappy-java can find the Snappy (DLL) automatically. The Linux version of the Snappy-java DLL is included in the executable jars. On other platforms, you must make the Snappy DLL available for Snappy-java to load. There are several ways this can be done: 

-  * On Linux systems, add the path to the Snappy DLL to the LD_LIBRARY_PATH environment variable. This does not work on Mac, and I'm not sure about Windows. 
-  * Set the org.xerial.snappy.lib.path system property to point to the directory containing the Snappy DLL. E.g. add an argument like the following to your Java command line: `-Dorg.xerial.snappy.lib.path=&amp;lt;directory containing Snappy DLL&amp;gt;`. 
-  * Put the Snappy-java jar on your classpath, e.g. add an argumet like the following to your Java commane line: `-classpath snappy-java&amp;lt;version#&amp;gt;.jar`. 
+  * Set the org.xerial.snappy.lib.path system property to point to the directory containing the Snappy-java DLL. E.g. add an argument like the following to your Java command line: `-Dorg.xerial.snappy.lib.path=&amp;lt;directory containing Snappy DLL&amp;gt;`. 
+  * Put the Snappy-java jar on your classpath, e.g. add an argument like the following to your Java command line: `-classpath snappy-java&amp;lt;version#&amp;gt;.jar`. 

 ### Controlling Snappy in Picard

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alec Wysoker</dc:creator><pubDate>Mon, 30 Jun 2014 15:10:20 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net1518d6b190a80ac005182c52492b735d9922cd71</guid></item><item><title>Using_Snappy_in_Picard modified by Alec Wysoker</title><link>https://sourceforge.net/p/picard/wiki/Using_Snappy_in_Picard/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v6
+++ v7
@@ -1,4 +1,4 @@
-[[Snappy](http://code.google.com/p/snappy/)] is an open-source compression library that emphasizes fast compression over maximum compression. [[Snappy-java](http://code.google.com/p/snappy-java/)] is a Java JNI wrapper for Snappy. If the Snappy library is installed on a system and made available to the JVM then Picard programs that sort large amounts of data will use it to compress temporary data before writing it to disk. This is a performance optimization only and is entirely optional. Snappy can reduce file I/O, and in some cases the savings in file I/O more than compensates for the time spent compressing and decompressing, and results in faster execution times. We have seen sort times reduced by nearly 25%, although your mileage may vary. 
+[Snappy](http://code.google.com/p/snappy/) is an open-source compression library that emphasizes fast compression over maximum compression. [Snappy-java](http://code.google.com/p/snappy-java/) is a Java JNI wrapper for Snappy. If the Snappy library is installed on a system and made available to the JVM then Picard programs that sort large amounts of data will use it to compress temporary data before writing it to disk. This is a performance optimization only and is entirely optional. Snappy can reduce file I/O, and in some cases the savings in file I/O more than compensates for the time spent compressing and decompressing, and results in faster execution times. We have seen sort times reduced by nearly 25%, although your mileage may vary.

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alec Wysoker</dc:creator><pubDate>Mon, 30 Jun 2014 15:10:20 -0000</pubDate><guid isPermaLink="false">https://sourceforge.netde120cde02ba2b6a5c4c77d6e7a4d2c70c6ba2e6</guid></item><item><title>Using_Snappy_in_Picard modified by Alec Wysoker</title><link>https://sourceforge.net/p/picard/wiki/Using_Snappy_in_Picard/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v5
+++ v6
@@ -1,4 +1,4 @@
-[[Snappy](http://code.google.com/p/snappy/)] is an open-source compression library that emphasizes fast compression over maximum compression. [[Snappy-java](http://code.google.com/p/snappy-java/)] is a Java JNI wrapper for Snappy. The Picard library and Picard programs that use SortingCollection to sort large data sets (mostly SAMRecords) optionally use Snappy to compress temporary files written in the process of doing a disk-based merge sort. This can reduce file I/O, and in some cases the savings in file I/O more than compensates for the time spent compressing and decompressing, and results in faster execution times. We have seen sort times reduced by nearly 25%, although your mileage may vary. 
+[[Snappy](http://code.google.com/p/snappy/)] is an open-source compression library that emphasizes fast compression over maximum compression. [[Snappy-java](http://code.google.com/p/snappy-java/)] is a Java JNI wrapper for Snappy. If the Snappy library is installed on a system and made available to the JVM then Picard programs that sort large amounts of data will use it to compress temporary data before writing it to disk. This is a performance optimization only and is entirely optional. Snappy can reduce file I/O, and in some cases the savings in file I/O more than compensates for the time spent compressing and decompressing, and results in faster execution times. We have seen sort times reduced by nearly 25%, although your mileage may vary.

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alec Wysoker</dc:creator><pubDate>Mon, 30 Jun 2014 15:10:20 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net241a1dc74076710a7eebbd04341a02ae1d1fc720</guid></item><item><title>Using_Snappy_in_Picard modified by Alec Wysoker</title><link>https://sourceforge.net/p/picard/wiki/Using_Snappy_in_Picard/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v4
+++ v5
@@ -23,7 +23,7 @@

   * On Linux systems, add the path to the Snappy DLL to the LD_LIBRARY_PATH environment variable. This does not work on Mac, and I'm not sure about Windows. 
   * Set the org.xerial.snappy.lib.path system property to point to the directory containing the Snappy DLL. E.g. add an argument like the following to your Java command line: `-Dorg.xerial.snappy.lib.path=&amp;lt;directory containing Snappy DLL&amp;gt;`. 
-  * You can put the Snappy-java jar on your classpath, e.g. add an argumet like the following to your Java commane line: `-classpath snappy-java&amp;lt;version#&amp;gt;.jar`. 
+  * Put the Snappy-java jar on your classpath, e.g. add an argumet like the following to your Java commane line: `-classpath snappy-java&amp;lt;version#&amp;gt;.jar`. 

 ### Controlling Snappy in Picard

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alec Wysoker</dc:creator><pubDate>Mon, 30 Jun 2014 15:10:20 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net25b44c2415e4e19ae20777721ba9b93e7ccc549f</guid></item><item><title>Using_Snappy_in_Picard modified by Alec Wysoker</title><link>https://sourceforge.net/p/picard/wiki/Using_Snappy_in_Picard/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v3
+++ v4
@@ -21,9 +21,9 @@

 If the Snappy jar is on your classpath, Snappy-java can find the Snappy (DLL) automatically. However, if you use one of the executable jars (e.g. SortSam.jar), then you must make the Snappy DLL available for Snappy-java to load. There are several ways this can be done: 

-  * On Linux systems, if the LD_LIBRARY_PATH environment variable contains the path to the Snappy DLL, Snappy-java can find it. This does not work on Mac, and I'm not sure about Windows. 
-  * You can set the org.xerial.snappy.lib.path system property to point to the directory containing the Snappy DLL. E.g. add and argument like the following to your Java command line: `-Dorg.xerial.snappy.lib.path=&amp;lt;directory containing Snappy DLL&amp;gt;`. 
-  * You can put the Snappy-java jar on your classpath, e.g. `-classpath snappy-java&amp;lt;version#&amp;gt;.jar`. 
+  * On Linux systems, add the path to the Snappy DLL to the LD_LIBRARY_PATH environment variable. This does not work on Mac, and I'm not sure about Windows. 
+  * Set the org.xerial.snappy.lib.path system property to point to the directory containing the Snappy DLL. E.g. add an argument like the following to your Java command line: `-Dorg.xerial.snappy.lib.path=&amp;lt;directory containing Snappy DLL&amp;gt;`. 
+  * You can put the Snappy-java jar on your classpath, e.g. add an argumet like the following to your Java commane line: `-classpath snappy-java&amp;lt;version#&amp;gt;.jar`. 

 ### Controlling Snappy in Picard

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alec Wysoker</dc:creator><pubDate>Mon, 30 Jun 2014 15:10:20 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net22d33454cce45e6cba823232392ed753326a4576</guid></item><item><title>Using_Snappy_in_Picard modified by Alec Wysoker</title><link>https://sourceforge.net/p/picard/wiki/Using_Snappy_in_Picard/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v2
+++ v3
@@ -1,4 +1,4 @@
-[[Snappy](http://code.google.com/p/snappy/)] is an open-source compression library that emphasizes fast compression over maximum compression. [[Snappy-java](http://code.google.com/p/snappy-java/)] is a Java JNI wrapper for Snappy. The Picard library and Picard programs that use SortingCollection to sort large data sets (mostly SAMRecords) optionally use Snappy to compress temporary files written in the process of doing a disk-based merge sort. This can reduce file I/O, and in some cases the savings in file I/O more than compensates for the time spent compressing and decompressing, and results in faster execution times. We have seen sort times reduced by nearly 25%, although your mileage may depend on many factors. 
+[[Snappy](http://code.google.com/p/snappy/)] is an open-source compression library that emphasizes fast compression over maximum compression. [[Snappy-java](http://code.google.com/p/snappy-java/)] is a Java JNI wrapper for Snappy. The Picard library and Picard programs that use SortingCollection to sort large data sets (mostly SAMRecords) optionally use Snappy to compress temporary files written in the process of doing a disk-based merge sort. This can reduce file I/O, and in some cases the savings in file I/O more than compensates for the time spent compressing and decompressing, and results in faster execution times. We have seen sort times reduced by nearly 25%, although your mileage may vary.

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alec Wysoker</dc:creator><pubDate>Mon, 30 Jun 2014 15:10:20 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net0185602ab3b303d6e81360268b6290d1734857c9</guid></item><item><title>Using_Snappy_in_Picard modified by Alec Wysoker</title><link>https://sourceforge.net/p/picard/wiki/Using_Snappy_in_Picard/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v1
+++ v2
@@ -2,6 +2,8 @@

+
+[TOC]

 ## Requirements for using Snappy

@@ -11,6 +13,10 @@

 If you use one of the executable jars in the Picard bundle (e.g. SortSam.jar), the Snappy-java classes are included in the executable jar so you need do nothing additional. However, if you are using sam-&amp;lt;version#&amp;gt;.jar, then you must also add the Snappy-java jar to the classpath. The jar can be found in the picard-tools-&amp;lt;version#&amp;gt;.zip file. 

+### Obtaining the Snappy DLL
+
+Currently, the Snappy project only distributes source code. You can download the Snappy sources and build for your platform. Alternately, the Snappy-java jarfile contains Snappy DLLs for the most popular platforms, so you may extract it from there. 
+
 ### Making the Snappy DLL available

 If the Snappy jar is on your classpath, Snappy-java can find the Snappy (DLL) automatically. However, if you use one of the executable jars (e.g. SortSam.jar), then you must make the Snappy DLL available for Snappy-java to load. There are several ways this can be done: 
@@ -18,3 +24,9 @@
   * On Linux systems, if the LD_LIBRARY_PATH environment variable contains the path to the Snappy DLL, Snappy-java can find it. This does not work on Mac, and I'm not sure about Windows. 
   * You can set the org.xerial.snappy.lib.path system property to point to the directory containing the Snappy DLL. E.g. add and argument like the following to your Java command line: `-Dorg.xerial.snappy.lib.path=&amp;lt;directory containing Snappy DLL&amp;gt;`. 
   * You can put the Snappy-java jar on your classpath, e.g. `-classpath snappy-java&amp;lt;version#&amp;gt;.jar`. 
+
+### Controlling Snappy in Picard
+
+In order to see if Snappy has been found by Picard, pass `-Dsnappy.loader.verbosity=true` on the Java command line. When SortingCollection first tries to sort something, a message will be printed to stderr indicating whether or not Snappy-java and Snappy DLL have been found. 
+
+In order to force Snappy not to be used by Picard, pass `-Dsnappy.disable=true` on the Java command line. 
&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Alec Wysoker</dc:creator><pubDate>Mon, 30 Jun 2014 15:10:19 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net622e9ccbbdf7b66246a93f5b8d4aed7c1e815560</guid></item></channel></rss>