Learn R Programming

galah (version 1.4.0)

galah_down_to: Specify the lowest taxonomic rank required in a downwards search

Description

atlas_taxonomy generates a downwards search of the taxonomic tree. This function can be used to specify the name of a valid taxonomic rank using non-standard evaluation (NSE), for consistency with other galah_ functions.

Usage

galah_down_to(...)

Arguments

...

the name of a single taxonomic rank

Value

A string with the named rank

Examples

An example of using galah_down_to() with atlas_taxonomy(). Return a taxonomic tree of Chordata down to the class level

galah_call() |>
    galah_identify("Chordata") |>
    galah_down_to(class) |>
    atlas_taxonomy()
#>                             levelName
#> 1  Chordata                          
#> 2   <U+00A6>--Cephalochordata               
#> 3   <U+00A6>   <U+00B0>--Amphioxi                  
#> 4   <U+00A6>--Craniata                      
#> 5   <U+00A6>   <U+00B0>--Agnatha                   
#> 6   <U+00A6>       <U+00A6>--Cephalasipidomorphi   
#> 7   <U+00A6>       <U+00B0>--Myxini                
#> 8   <U+00A6>--Tunicata                      
#> 9   <U+00A6>   <U+00A6>--Appendicularia            
#> 10  <U+00A6>   <U+00A6>--Ascidiacea                
#> 11  <U+00A6>   <U+00B0>--Thaliacea                 
#> 12  <U+00B0>--Vertebrata                    
#> 13      <U+00B0>--Gnathostomata             
#> 14          <U+00A6>--Amphibia              
#> 15          <U+00A6>--Aves                  
#> 16          <U+00A6>--Mammalia              
#> 17          <U+00A6>--Pisces                
#> 18          <U+00A6>   <U+00A6>--Actinopterygii    
#> 19          <U+00A6>   <U+00A6>--Chondrichthyes    
#> 20          <U+00A6>   <U+00A6>--Cephalaspidomorphi
#> 21          <U+00A6>   <U+00B0>--Sarcopterygii     
#> 22          <U+00B0>--Reptilia

Another example: return a taxonomic tree of Cacatuidae down to the genus level

galah_call() |>
  galah_identify("Cacatuidae") |>
  galah_down_to(genus) |>
  atlas_taxonomy()
#>                    levelName
#> 1  Cacatuidae               
#> 2   <U+00A6>--Cacatuinae           
#> 3   <U+00A6>   <U+00A6>--Cacatuini        
#> 4   <U+00A6>   <U+00A6>   <U+00A6>--Cacatua      
#> 5   <U+00A6>   <U+00A6>   <U+00A6>--Callocephalon
#> 6   <U+00A6>   <U+00A6>   <U+00A6>--Eolophus     
#> 7   <U+00A6>   <U+00A6>   <U+00B0>--Lophochroa   
#> 8   <U+00A6>   <U+00B0>--Microglossini    
#> 9   <U+00A6>       <U+00B0>--Probosciger  
#> 10  <U+00A6>--Calyptorhynchinae    
#> 11  <U+00A6>   <U+00B0>--Calyptorhynchus  
#> 12  <U+00B0>--Nymphicinae          
#> 13      <U+00B0>--Nymphicus

See Also

galah_select(), galah_filter() and galah_geolocate() for related methods.