Previous Up Next

Chapter 8  Resolve Mode

Resolve mode is only applicable to non-binary gene trees. Its function is to resolve polytomies in a non-binary gene tree by comparing it with a binary species tree, resulting in one or more binary tree(s) with minimal D/L Score.

Specifically, the Resolve function removes all polytomies in the original gene tree, and uses an algorithm similar to the rearrangement algorithm to replace them with new edges such that: 1) the new tree is binary, and 2) the new tree has optimal D/L Score. Note that each edge in the original non-binary gene tree still exists in the resulting binary gene tree.

There may be more than one binary tree that agrees with the input tree at all edges except polytomies and has minimal D/L Score. In this case, the user can investigate these optimal alternate hypotheses using a point and click interface as in Rearrange mode. See Section 7.1 - Alternate Optimal Hypotheses for a more detailed explanation of alternate hypotheses.

Selecting the “Highlight Polytomies” checkbox will highlight in cyan all vertical edges representing polytomies in the tree, allowing the user to see which nodes will be resolved. After running the resolve algorithm, the “Highlight New Edges” checkbox will be selected, and will highlight in cyan all those edges in the gene tree that were previously represented by the polytomy (see Figure 8.1). This option is only available in Resolve mode.

Click on image to see larger version


Figure 8.1: (a) Polytomies in the gene tree can be highlighted in cyan while in the Resolve task mode. (b) After the polytomies are resolved, edges that were not present in the original tree are highlighted in cyan.

To resolve the gene tree:

  1. Click the Resolve tab to enter Resolve mode.
  2. Click “Resolve Polytomies.”

    A minimum cost binary resolution of all polytomies in the tree will appear in the tree panel. Note that the new edges will not have edge weights.

    If the gene tree is binary, the “Resolve Polytomies” button will be grayed out.

NOTE: If asked to resolve a tree that has not been reconciled, Notung will first invoke the reconciliation algorithm. In this case, the user is asked to select a species tree for reconciliation.

To highlight all polytomies (default: OFF):

To highlight all new edges (default: ON, after resolving):

To view alternate optimal event histories:

  1. If more than one optimal event history exists for a resolved tree, the drop down menu “Select an optimal event history” will be enabled.
  2. From the drop-down menu, select an alternate event history.
    The tree panel will now show a new tree corresponding to the selected alternate history.

If there is only one optimal history or if the polytomies have not been resolved, the drop down menu will be grayed out.

To swap individual nodes:

  1. Click the “Examine same cost swaps” button on the Resolve task panel.
    NOTE: If there are no swappable nodes in the tree or if the polytomies have not been resolved, this button will be grayed out.
    Swappable nodes are marked with an enlarged blue and cyan square. As you pass the mouse over a swappable node, other nodes that can be interchanged with it with are temporarily highlighted with a light orange triangle. Swappable nodes that are not currently visible in the tree panel (for instance, if you have zoomed in), are indicated by arrows in the tree panel pointing in the direction of those nodes.
  2. Click a node to swap.

    The node you selected is highlighted with a blue triangle. Nodes with which it can be swapped are now highlighted with pink triangles.

  3. Click a second node to complete the swap.

    NOTE: When a different alternate event history is selected in the “Select an optimal event history” list, Notung rebuilds the tree from data saved at the time of resolution. Any manual swaps made to a previously viewed event history will be lost. Therefore, if you wish to save information after a manual swap, you must save your tree. See Chapter 3.3 - Opening and Saving Trees for more information.


Previous Up Next