make_tree: Convert data frame to tree structure.

In cbaumbach/treeFun: Functions for dealing with tree structures

Description

Convert data frame to tree structure.

Usage

make_tree(d, parent_sep = ",", ancestor = NULL, attrib = NULL)

Arguments

d	Data frame to be converted into a tree structure.
parent_sep	String separating parent ids in case of multiple parents.
ancestor	Random id identifying the initial tree from which the tree defined by ‘d’ was derived.
attrib	Attributes to be attached to final tree structure.

Details

The data frame must have the columns ‘id’ and ‘parents’ corresponding to node identifiers and a (by default comma-separated) list of parent node identifiers.

The ‘ancestor’ argument should not be specified unless the tree in ‘d’ was derived from another tree in which case ‘ancestor’ should be set to the latter tree's ‘ancestor’. The ‘ancestor’ id is needed to make sure that whenever we operate on more than one tree, all trees derive from the same ancestor and are thus compatible in terms of nodes, edges, and supplementary data.

Value

Returns an object of S3 class ‘tree’.

Examples

library(treeFun)

d <- read.table(textConnection("\
id parents label
0 - a
1 0 b
2 0 c
3 1 d
4 1 e
5 1 f
6 2 g
7 2 h
8 7 i
"), header = TRUE, stringsAsFactors = FALSE)

##         0a
##        / \
##      /     \
##    1b       2c
##   /|\      / \
##  / | \    /   \
## 3d 4e 5f 6g    7h
##                 \
##                  \
##                   8i

print(make_tree(d))

cbaumbach/treeFun documentation built on May 13, 2019, 1:49 p.m.