R: Retrieve all taxa names or TSNs downstream in hierarchy from...

itis_downstream {taxize} | R Documentation

## 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 `rank_name` and `hierarchy_down`

### 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.

### Author(s)

Scott Chamberlain myrmecocystus@gmail.com

### 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)

[Package taxize version 0.9.0 Index]