bird_taxa_filter: bird taxa filter

In scottfjennings/birdnames: Work with bird names

bird taxa filter

Description

Filter a list of bird species by taxonomic relationships.

Usage

bird_taxa_filter(data_file, keep_taxa)

Arguments

data_file	your bird data with at least a column containing an allowable species identifier, either AOU Alpha Code ("alpha.code"), Numeric Code ("species.number"), Common Name ("common.name"), or Scientific Name ("species")
keep_taxa	names of the taxa to want to filter to; can be names of different taxonomic levels, e.g. c("Charadriiformes", "Falconidae"); can also leave this blank to keep all species in data_file but add common names, sci names, other taxonomic info

Details

Currently uses as reference a list of species that contains both those species/ taxonomies available in the sources for full_bird_list and some customized species/ taxonomies that are useful for ACR's long term monitoring projects (dataset "combined_bird_list") and maybe other projects on waterbirds or shorebirds.

Future versions will allow the user to choose to use full_bird_list, combined_bird_list, or supply their own customized list. (I tried implementing this but there is some aspect of scoping that I don't understand and I can't get it to work.)

Value

data frame with all columns in data_file and all columns in full_bird_list except those specified in drop_cols

Examples

 sample_bird_data <- data.frame(alpha.code = c("MALL", "GRSC", "BUFF", "RTHA", "SCAUP",
 "GREG", "HOGR"))

 # using publicly available and custom bird names (dataset provided with package)

 bird_taxa_filter(sample_bird_data, c("Anseriformes", "Podicipediformes"))

scottfjennings/birdnames documentation built on July 2, 2023, 6:07 a.m.