Difference between revisions of "SynMap3D"

Revision as of 17:57, 6 June 2016

Note: This is the documentation for SynMap3D, if you are looking for SynMap 2 look here.

Background

SynMap3D is a web-based whole-genome synteny browser that both identifies and visualizes regions of synteny (common ancestry) between three genomes. Results are displayed as a three dimensional dotplot (scatter plot), with each axis representing a linearized version of the genome. Alternating light/dark axis colors and grey grid lines distinguish between different chromosomes. Each point represents a syntenic gene pair shared between all three genomes.

Getting Started

Launching a SynMap3D Analysis

Launching SynMap3D is accomplished using the familiar CoGe "wizard" which guides through each step of selecting organisms, chosing options, reviewing selections then launching calculations and visualization.

Step 1: Select Genomes (Figure 1A)

Three genomes must be selected for a SynMap3D analysis. Start typing an organism name or a genome ID and the search will find matching genomes. After three genomes are selected, choose 'Next'.

Step 2: Choose Options (Figure 1B)

Select all desired options:

• General Options
  • Sort Contigs By: Use this option to adjust how chromosomes/scaffolds/contigs are sorted during the "linearization" of genomes (conversion to graph axes). 'Name' will use a natural sorting algorithm to order them logically by name (i.e. 1, 2A, 2B, 3, 4). "Length" will order by length of each contig (largest to smallest).
  • Minimum syntenic points per contig: Use this option to set a minimum threshold of syntenic points per chromosome/scaffold/contig for display. For example, a setting of 10 means that if a contig has less than 10 syntenic points, it will not be displayed. This is very useful for incompletely assembled genomes and those with many pieces.
  • Minimum contig length (bp): This sets the minimum chromosome/scaffold/contig length (in basepairs) for display. For example, a setting of 10,000 will remove any pieces less than 10kb. Like above, this is very useful for genomes with many small pieces.
  • Limit by mutation value: This option allows you to set minimum/maximum Kn, Ks, or Kn/Ks values for display. This is particularly useful if you are dealing with polyploid genomes with large amounts of synteny and are only interested in those points with certain evolutionary characteristics.
    • Mutation Ratio: Use this option to select the mutation value you would like to limit by (Kn, Ks or Kn/Ks).
    • Comparison: Use this option to select which pairwise or three-way calculation you would like to use to limit by.
    • Minimum log10(ratio): This is the minimum log10 transformed mutation value to consider.
    • Maximum lot10(ratio) This is the maximum, lot10 transformed mutation value to consider.
  • Limit by DBSCAN clustering: This option allows for removing of syntenic points that do not fall into larger syntenic regions. The DBSCAN algorithm is used for this filtering. For details about the specific implementation and parameters, see sklearn.
    • Maximum neighborhood distance: The maximum distance between two points for them to be consitered within the same neighborhood.
    • Minimum points per cluster: The minimum number of additional points that must fall within a points neighborhood to retain that point.
• Experimental Options
  • Enable VR mode: Select this option to enable the VR visualizer. Note, this requires a VR headset and compatible web browser (see below). If you do not meet these requirements, the visualization will load with the normal renderer and a message will be displayed with the error.

Step 3: Review Options (Figure 1C)

The final wizard step is reviewing your selections. If everything looks good here, go ahead and "Launch". Otherwise, use the "Previous" button to navigate back and adjust accordingly.

Navigating the SynMap3D Renderer

Coming Soon!

Understanding the Results

Coming Soon!

Examples

Human vs Chimp vs Orangutan: [1] A. thaliana vs A. lyrata vs B. rapa: [2]

Linking to SynMap3D

Coming Soon!

FAQ

How can I use VR-mode?

VR-mode requires both a VR-compatible web browser and a VR headset. For information on setting up a VR-compatible browser, please visit https://webvr.info/

What web-visualization technologies are used in SynMap3D?

The three-dimensional dot plot is rendered with WebGL using Three.js. Histograms are pure D3.

How many points can SynMap3D support?

This really depends on the individual user's system, but we have been able to render well over 50K points with good performance.

How can I reduce the number of points displayed?

There are two steps at which point number can be reduced: pre-visualization (through the wizard options) or post-render (by selecting histogram regions). During the wizard step, the four general options "Minimum syntenic points per contig", "Minimum contig length (bp)", "Limit by mutation value", and "Limit by DBSCAN clustering" can all be used to reduce point count (see 'Getting Started' for detailed information about each option. After rendering, data can be subsetted by selecting a region of the histogram. The visualization will live-update to display only the points falling within those values.

I'm having trouble selecting the point I want, do you have any tips?

If you are having trouble selecting a point, it frequently helps to slightly move the visualization around a bit. Some of the calculations can get confused with overlapping points or certain views, and slightly altering the view can help adjust calculations and get the correct point selected.

Is SynMap3D open source?

Absolutely! All CoGe tools are open source and can be viewed at our team's GitHub repository (https://github.com/LyonsLab/coge). If you are specifically interested in SynMap3D, most of the visualizations are controlled by the javascript files in web/js/syn3d.

Question not answered here?

Feel free to contact Asher @ ahaug (at) email (dot) arizona (dot) edu