addData: Adding data to a phylo4 or a phylo4d object

Description

addData adds data to a phylo4 (converting it in a phylo4d object) or to a phylo4d object

Usage

## S3 method for class 'phylo4':
addData(x, tip.data, node.data, all.data,
  merge.data=TRUE, pos=c("after", "before"), ...)
## S3 method for class 'phylo4d':
addData(x, tip.data, node.data, all.data,
  merge.data=TRUE, pos=c("after", "before"), ...)

Arguments

a phylo4 or a phylo4d object

tip.data

a data frame (or object to be coerced to one) containing only tip data

node.data

a data frame (or object to be coerced to one) containing only node data

all.data

a data frame (or object to be coerced to one) containing both tip and node data

merge.data

if both tip.data and node.data are provided, it determines whether columns with common names will be merged together (default TRUE). If FALSE, columns with common names will be preserved separately, with ".tip" and ".

pos

should the new data provided be bound before or after the pre-existing data?

...

additional arguments to be passed to formatData

Value

addData returns a phylo4d object.

Details

Rules for matching data to tree nodes are identical to those used by the phylo4d constructor.

If any column names in the original data are the same as columns in the new data, ".old" is appended to the former column names and ".new" is appended to the new column names.

The option pos is ignored (silently) if x is a phylo4 object. It is provided for compatibility reasons.

Examples

Run this code

data(geospiza)
  nDt <- data.frame(a=rnorm(nNodes(geospiza)), b=1:nNodes(geospiza),
    row.names=nodeId(geospiza, "internal"))
  t1 <- addData(geospiza, node.data=nDt)