assemble_supertree: Create a glottolog super-tree

assemble_supertreeR Documentation

Create a glottolog super-tree

Description

Combining glottolog family trees into one large tree. Families can be assembled directly below a rake structure at the root, or can be grouped, so that the root first branches into groups, and the families then branch out below the group nodes.

Usage

assemble_supertree(macro_groups, glottolog_version)

Arguments

macro_groups

A list of character vectors, in which each vector contains the names of one or more macroareas which define a group. Alternatively, setting macro_groups to NULL causes the tree to be assembled without groups.

glottolog_version

A character string, specifying which glottolog version to use. Currently available options are '4.0' through to '4.8' and '5.0'. If no value is specified then the newest available version is used.

Details

Grouping is controlled by the macro_groups parameter. Groups can comprise a single glottolog macroarea, or multiple macroareas. Current macroareas are Africa, Australia, Eurasia, North America, Papunesia and South America. Setting macro_groups to NULL causes the tree to be assembled without groups.

Examples


# Supertree whose first order branches are the glottolog macroareas
supertree <- assemble_supertree()
supertree_v.4.3 <- assemble_supertree(glottolog_version = "4.3")

# Supertree whose first order branches are glottolog families
supertree <- assemble_supertree(macro_groups = NULL)

# Supertree whose first order branches are the African & Eurasian macroareas
supertree <- assemble_supertree(macro_groups = list("Africa", "Eurasia"))

# Supertree whose first order branches are the glottolog macroareas, but
# with the Americas combined:
supertree <- assemble_supertree(
  macro_groups = list("Africa", "Australia", "Eurasia", "Papunesia", 
                      c("South America", "North America"))
  )

erichround/glottoTrees documentation built on April 17, 2025, 10:47 a.m.