Preferences

To display the Preferences window, click View>Preferences. Preferences are preserved across sessions. To override preferences during a session, use the track display pop-up menu. Each section on this page describes the options on a tab of the Preferences window: General, Tracks, Mutations, Charts, Alignments, Probes, Advanced, and Proxy.

General

Select to distinguish regions with zero values (white) from regions with missing data (gray). Clear (default) to display both regions in the same way (white). Affects only bar charts and scatter plots.
Select to display all tracks in a single panel. Clear (default) to display data tracks (e.g., expression data) in one panel and feature tracks (e.g., genes) in another.
Select (default) to show attributes and attribute values to the left of the data panel. Clear to hide the attributes. This option and View>Show Attribute Display have the same effect on attribute display.
Select to outline the boundaries of regions of interest in black. Clear (default) to leave them without black boundaries.
Zoom in on search results. When selected (default) the zoom level is automatically adjusted so that the target feature fills the view after a successful search. If not checked, the target feature of a search is centered in the view but the zoom level is unaffected.
Change this to change the resolution (in base pairs) at which the sequence track becomes visible.
Change this to define how large a flanking region (in base pairs) IGV will add before and after a feature locus when you zoom to a feature, or when you view gene/loci lists in multiple panels.
Click here to change the background color of the IGV display.
Use this to set a default font size for labeling tracks and features.

Tracks

Default track height for bar charts, scatter plots, and line plots.
Default track height for all other tracks.

Name of an attribute in the sample information file. IGV uses the corresponding attribute value as the track name.

Select to expand feature tracks by default. You may have to restart IGV for this to take effect.

Collapsed:

Expanded:

Select (default) to show the "expand/collapse" triangular icon on feature tracks.

Collapsed with the icon:                          Expanded with the icon:

                           

Select to normalize tracks containing coverage data in .tdf files that were created using igvtools.  This normalization option multiplies each value by [1,000,000 / (totalReadCount)].  This is only available for .tdf files created using igvtools builds dated 1/28/2010 or later.  Earlier versions of igvtools did not record the total read count.

Mutations

Select to overlay mutation data on other tracks. more...
Name of an attribute column in the sample information file. IGV uses the corresponding attribute values to "link" mutation tracks with other tracks. more...
Select this to show mutation tracks that are not linked to other tracks, and therefore will not be seen if the overlay option is checked.  This option has no affect if the overlay option is not selected.

Select to color-code mutation data. Click Choose Colors (or View>Color Legends) to display the Color Legends window, which allows you to view and change mutation color codes.

Charts

Select to add a border at the top to the track.
Select to add a border at the bottom of the track.

Select (default) to color the top and bottom borders (if any). Clear to show the borders in black regardless of the track color. Tip: To change the track color, use the track display pop-up menu.

Select to label the track with its name, provided the track is at least 25 pixels high.
Select to label the y-axis with its data range.
Select (default) to allow charts (barchart, scatterplot, and lineplot) to automatically adjust the plot Y scale to the data range currently in view.  As the user pans and moves, this scaling continually adjusts.  Clear to turn autoscaling off.  There is an option in the popup menu to enable autoscaling for a single track.

Select (default) to show the range of the data.

The following figures illustrate these track display options.

  • Color borders selected (default):
  • All options selected:

 

Alignments

 

 

Sets the threshold at which IGV displays reads. Reads are visible only when IGV is zoomed in to display a number of bases less than or equal to this threshold.
Sets the maximum number of vertically stacked alignments viewable at any particular locus.
Sets a threshold on alignment mapping quality. Only alignments with mapping quality greater than or equal to this threshold are shown.
Sets the mismatch threshold at which bases on an alignment coverage track are colored.  The default is 0.2, i.e., if a nucleotide differs from the reference sequence in greater than 20% of quality-weighted reads, IGV colors the bar in the coverage bar chart in proportion to the read count of each base (ACGT). The threshold for an individual track can be changed from the pop-up menu.
Clear to display alignments marked as duplicate reads.
Select (default) to filter out reads that are marked "vendor failed".
Select to draw a red box around any paired alignment whose mate is not mapped.
Select (default) to shade mismatched bases by quality.  The letters representing bases of lower quality will be more transparent, while higher-quality bases will appear more solid.
Select to hide alignments that match the read groups listed in the filter file. The filter file is a text file that lists read groups, one per line.  This option means that IGV does not load the alignments associated with these read groups.
Select to display a coverage track for each alignment track. The coverage track is visible only when alignments are visible. It displays a gray bar chart showing the depth of the reads at each locus. If a nucleotide differs from the reference sequence in greater than 20% of quality-weighted reads, IGV colors the bar in proportion to the read count of each base (A, C, G, T). Modifying this option affects the display of subsequently loaded alignment tracks. Note, to change the threshold from the default 20%, see .
Select to display the splice junction track.
Select to show the soft clipped sections of the read. 
Sets default size thresholds for color-coded flagging of paired end alignments. Only paired end alignments with insert sizes between these thresholds are flagged.  Select Compute to compute selected values from the actual size distribution of each library.

 

 

Probes

Select an option to determine how IGV places expression data on the genome:

  • Map probes to target loci: Use the probe ID to determine the probe locus and display data at that location. If that fails, map the probe ID to a gene, determine the gene locus, and display data at that location.
  • Map probes to genes: Map the probe ID to a gene, determine the gene locus, and display data at that location.

Modifying this option affects the display of subsequently loaded alignment tracks.

Advanced

Select this option to enable a port on which IGV listens for commands and http requests. Enabling the port allows control of IGV from a web browser. more...
Select this option to edit URLs for the IGV data and genome servers. These settings are rarely changed.
URL for the genome server (populates the genome drop-down list).
URL for the hosted data sets registry (populates File>Load from Server dialog).

Keep this selected to allow IGV to automatically check for updated genomes. Clear to disable this automatic check.

IGV caches each genome that it loads. On rare occasions, it may be necessary to clear the cached genome file to display an updated version of the genome.

This option applies particularly to certain Load from Server... tracks hosted at the Broad.  If you are having problems loading some files from the Broad server it may help to clear this option. To see if this option is affecting your ability to load data, try to load the phastCons conservation track under the hg18 annotations.  If you cannot load this track, then clear this option.

Proxy

Sets proxy parameters for connecting to the Internet.  IGV will use this to load hosted genomes and hosted data sets.
Select and enter values if a username and password is required for the proxy.
Clears all proxy settings.