IGV 2.4.x

Jump to latest version below.

Java 8 is now required. IGV 2.4 requires Java version 8 to run. The latest version of Java can be downloaded from https://java.com/en/download/. Note that older versions of IGV are always available via the Archived Versions link on the IGV Downloads page.

IGV 2.4.0, released September 2017

1. Support for PacBio long-read sequencing data. PacBio reads are long (up to 50kb) and have a high rate of small random errors that can clutter the view. However, because the errors are random, quality is extremely high in a consensus of independent reads and a mismatch that is consistent across reads indicate biological variation. IGV has two new features to filter the errors from view:

  • Consensus Mode shows mismatches only at positions where a significant number of reads do not match the reference (Preferences > Alignments tab).
  • Hide Indels suppresses small indels, the most common error in raw PacBio reads (Preferences > Alignments tab).

Other related new features introduced in this release: 

  • Label large insertions and deletions (Preferences > Alignments tab).
  • Group alignments by base to aid in the exploration of haplotype phase (right-click popup menu in alignment tracks).

​​While the above new features were introduced to support PacBio data, they can be used when viewing alignment data from any data source.

We thank Aaron Wenger at Pacific BioSciences for his code contributions.

2. Support for 10X Genomics sequencing data. With the 10X Genomics platform, molecules are barcoded before they are sequenced with standard short read sequencing. The downstream 10X software pipeline digitally recovers the longer molecule from the short reads and their associated barcode information. IGV 2.4 includes a new feature to view aligned reads linked by the 10X barcode sequence (BX) or molecular identifier (MI) (right-click popup menu in alignment tracks). The 10X pipeline also computes the phase and IGV can separate the reads and color them by haplotype tag (HP) if present in the data file. The view in IGV is modeled on the Linked-Read view in 10X’s Loupe software.

3. Alignment coloring. Coloring by “YC” tag can now be explicitly enabled and disabled through the “Color By” option of the alignment track pop-up menu. The menu item “Color By YC Tag” will appear, selected by default, if YC tags are used

4. Support for CRAM files. IGV 2.4 supports loading sequencing data in CRAM 3.0 format (http://samtools.github.io/hts-specs/CRAMv3.pdf). A corresponding index file is required. By convention, the index file name should be the same as the data file name, with “.crai” appended. For example, if the data file is named example_xyz.cram, the index file should be named example_xyz.cram.crai or example_xyz.crai.

Due to the nature of the CRAM format, the first time the IGV view is zoomed in to load alignments for a particular chromosome, the reference sequence for that whole chromosome is loaded into IGV memory. If loading across the internet, this may take up to 10s of seconds. IGV will cache the chromosome sequence data to optimize performance for subsequent views. Note that the alignments themselves are loaded only as required for the region in view.  The cache size is set by default to 500 MB.  To adjust the size, or disable caching, see the Preferences > CRAM tab.

Note: When viewing CRAM files, an error will result if the selected reference genome is not the same as the reference genome used in the creation of the CRAM file. The error message may refer to a “reference sequence MD5 mismatch for slice”.    

5. Managing genomes. The user interface for managing the genomes dropdown menu in the IGV window has been simplified and improved. 

  • To add a hosted genome to the menu: Either click on the 'More...' entry at the bottom of the menu or select Genomes > Load Genome from Server. This will bring up a list of all the genomes on the server to choose from. Select the one you would like to add, and optionally check the 'Download sequence' box to download a FASTA file of the whole genome sequence for offline use. All available genomes are listed, even those that have already been loaded into the local menu. This is in case you want to now download the sequence for a genome already in the menu. Note that a downloadable FASTA file is not available for all hosted genomes. A notice will pop up if you try to download a sequence that is not available.
  • Adding other genomes from a file or a URL has not changed: Select Genomes > Load Genome from File or Genomes > Load Genome from URL.
  • To remove a genome from the menu: Select Genomes > Remove genomes. This will bring up a list of all the genomes in the menu, except the currently viewed genome as it cannot be removed. To remove the currently viewed genome, first switch the view to a different genome.

IGV 2.4.1   September 2017

  • Fixed problem with the details pop-up window not showing up.

IGV 2.4.2   October 2017

  • Fixed a problem with loading genomes on Windows. The genome identifier appeared in the dropdown menu, but none of the genome data was actually loaded.
  • Fixed a problem with coloring/sorting/grouping alignments by tag. The popup window to enter the tag never appeared.
  • Updated the BED file parser to allow a period (.) in the score column.

IGV 2.4.3   October 2017

  • Fixed a problem with loading session files.

IGV 2.4.4   November 2017

  • Autoscaling merged tracks now group scales the constitutive tracks (used to autoscale each track independently).
  • Fixed a problem with loading tabix-indexed files from a URL that includes query parameters. This meant, for example, that gzipped VCF files could not be loaded with signed URLs from Amazon.

IGV 2.4.5   December 2017

  • Fixes and optimizations for very deep coverage BAM files.

IGV 2.4.6   January 2018

  • Group autoscale settings are now saved in IGV session files.
  • Fixed a problem with Sashimi Plots not appearing.

IGV 2.4.7   January 2018

  • Fixed a problem with arcs from RNA secondary structure tracks sometimes overflowing into adjacent tracks.(Git issue #511). [Only partially fixed in 2.4.7. Complete fix released in 2.4.8.]
  • Fixed a problem where junction values displayed in a Sashimi Plot would increase when settings were changed. (Git issue #510)
  • Fixed a problem where group autoscale settings in sample information files were ignored. (Git issue #508)
  • Present a warning when loading from web links if the specified genome identifier is not available in IGV. Primarily affects Galaxy users with custom genomes.  (Git issue #503)

IGV 2.4.9   March 2018

  • When loading BAM files, it is no longer necessary to provide an alias file if the sequence names in the file do not match the sequence names in the current genome. IGV now compares the chromosome lengths of the current genome with the chromsome lengths of the genome used for the BAM alignment, and if they match IGV assumes it's the same genome. Note, this only works with BAM files.

IGV 2.4.10   March 2018

  • Fixed a problem with BAM tracks not displaying correctly in multi-locus view.  (Git issue #520)
  • Allow setting a track's Data Range max value to 0.  (Git issue #517)

IGV 2.4.11   July 2018

  • Fixed a problem with Sashimi plots miscounting junctions when viewing both strands.  (Git issue #538)
  • Fixed a problem with BLATing sequences agains the mm10 mouse genome.  (Git issue #552)

IGV 2.4.14   August 2018

  • New feature for BAM tracks: "group by" and "color by" PacBio movie and ZMW. PacBio read names follow the convention "movie/zmw/qStart_qEnd" where a movie is a single run of PacBio machine with a single SMRT Cell, ZMW is a single hole/molecule on the SMRT Cell, and qStart/qEnd are coordinates for a single subread within a ZMW read.
  • Fixed problem with incorrect coloring of bisulfite sequencing reads in "CG" mode. 

IGV 2.4.15   November 2018

  • Tracks created with a BLAT search can now be saved and restored from session files. 
  • Added a new batch command: setLogScale(true | false)
  • When running IGV on the command line, the arguments now accept a space delimited file list. To also specify a viewing locus, use the “-l” option. For example: ​​igv -g genome.fa -l chr3:1000-2000 track1.bam track2.bam track3.bam (Git issue #430)
  • Added a new track line option to draw a “baseline” at a specific value using viewLimits. For example: viewLimits = 0:2:6 (Git issue #584)
  • Fixed a problem with loading VCF files from gs:// URLs.
  • Fixed the igvtools build; the genomes subdirectory was in the wrong location. (Git issue #594)

IGV 2.4.16   November 2018

  • Bug fix: Session files created with overlaid (merged tracks) could not be read. (Git issue #602)

IGV 2.4.17   January 2019

  • New feature: The CSI index type is now supported for BAM files. A CSI index accommodates large sequence lengths (greater than 2^29). (Git issues #96, #597, #598)

IGV 2.4.18   January 2019

  • Minor fix to new features introduced in version 2.4.17.

IGV 2.4.19   February 2019

  • New feature: Sort and group paired-end alignments by first/second in pair. (Git issue #623)
  • Fix: If you delete a genome from the menu, the corresponding FASTA file will only be deleted if it is in a subdirectory of IGV's folder at <user home>/igv. This is to ensure that IGV will not delete a user's own FASTA file. (Git issue #626)