getID: get taxon IDs from taxon names

Description Usage Arguments Examples

View source: R/taxonomy.R


Returns a list or vector of taxon IDs for exact names (in ncbi file names.dmp), use grepName to find IDs from partial names or search patterns. Note that this is an ambiguous mapping, since some names occur multiple times, eg. "Proboscidea" is the name of both a genus of flowering plant and an order containing the elephants, or "Actinobacteria" is a name for both a "class" and a "phylum". If option all is set to TRUE multiple occurences will cause the function to return a named list. If set to FALSE (default), only the first or the last occurences will be reported, depending on option first, and returned as a named vector. TODO: resolve this ambiguity, eg. by checking the rank and taking the taxon ID with the lowest/highest rank.


getID(names, tax, all = TRUE, first = TRUE)



taxonomy names


NCBI taxonomy object


return all matches as a named list, if set to FALSE only the first/last matches (option first) will be reported as a vector


return the taxon ID for the first (default: TRUE) or last occurence of the name in NCBI file names.dmp


getID(c("Firmicutes","Cyanobacteria"), tax)

raim/ncbitax documentation built on Nov. 5, 2019, 2:08 a.m.