phyextPlot: Plot phylo4d_ext object

In phyext: An extension of some of the classes in phylobase. Tree objects now support subnodes on branches

Description

This function plots a phylo4d_ext object. Branches and nodes in different states can be colored. If subnodes exist it also plots these on the tree, showing them on the exact position they actually occur. This plotting function is an extension to treePlot in phylobase. It was created to plot discrete data states on top of a tree.

Usage

phyextPlot(x, 
	states, 
	states.col, 
	states.na = "none", 
	usestate = 1, 
	plot.subnodes = T, 
	plot.points = T, 
	line.widths, 
	line.types, 
	...)

Arguments

x	The phylo4d_ext object
states	A vector containing all the discrete states to show on the plot.
states.col	The colors for each state. The branches are painted these colors
states.na	If states is missing, then this is used to represent the NAs in the dataset. It is mainly for internal use.
usestate	This is the column index for a discrete data column whose states will be painted onto the tree. The data column specified should contain data for every node in the tree. For any missing data the states.na will be used.
plot.subnodes	Logical specifying whether or not subnodes should be plotted (if they exist).
plot.points	Logical specifying whether or not points should be plotted at each internal node and subnode. This can help indicate where subnodes exist on a branch.
line.widths	Integer. Line widths for each state. Branches in this state will use this line width.
line.types	Integer. Line types for each state. Branches in this state will use this line type.
...	This is passed to the phylobase function treePlot, which is the function that this function uses to place the tree on the canvas.

Details

This is nearly an internal function. It basically uses treePlot (to which you can pass options via ...) to plot a phylogenetic tree (with no continuous data). It then plots discrete data on top of this plot based on the which state each branch is in. The branch is colored based on the state of the descendant node.

Note that treePlot is called first and actually drawn on the canvas before the colored branches are plotted on top. This could lead to some odd plots when the using different line.widths and line.types. To neutralize this effect try passing colors to treePlot through ... which paints the original plot the same color as the background color.

This is the default function for phylo4d_ext.

Author(s)

J. Conrad Stack

phyext documentation built on May 2, 2019, 5:19 p.m.