taxize (version 0.7.9)

itis_downstream: Retrieve all taxa names or TSNs downstream in hierarchy from given TSN.

Description

Retrieve all taxa names or TSNs downstream in hierarchy from given TSN.

Usage

itis_downstream(tsns, downto, intermediate = FALSE, ...)

Arguments

tsns

A taxonomic serial number.

downto

The taxonomic level you want to go down to. See examples below. The taxonomic level IS case sensitive, and you do have to spell it correctly. See data(rank_ref) for spelling.

intermediate

(logical) If TRUE, return a list of length two with target taxon rank names, with additional list of data.frame's of intermediate taxonomic groups. Default: FALSE

...

Further args passed on to gettaxonomicranknamefromtsn and gethierarchydownfromtsn

Value

Data.frame of taxonomic information downstream to family from e.g., Order, Class, etc., or if intermediated=TRUE, list of length two, with target taxon rank names, and intermediate names.

Examples

## Not run: 
# ## the plant class Bangiophyceae, tsn 846509
# itis_downstream(tsns = 846509, downto="genus")
# itis_downstream(tsns = 846509, downto="genus", intermediate=TRUE)
# 
# # get families downstream from Acridoidea
# itis_downstream(tsns = 650497, "family")
# ## here, intermediate leads to the same result as the target
# itis_downstream(tsns = 650497, "family", intermediate=TRUE)
# 
# # get species downstream from Ursus
# itis_downstream(tsns = 180541, "species")
# 
# # get orders down from the Division Rhodophyta (red algae)
# itis_downstream(tsns = 660046, "order")
# itis_downstream(tsns = 660046, "order", intermediate=TRUE)
# 
# # get tribes down from the family Apidae
# itis_downstream(tsns = 154394, downto="tribe")
# itis_downstream(tsns = 154394, downto="tribe", intermediate=TRUE)
# ## End(Not run)