The sources that ts_load_ref() can download by name, with their licenses and how to cite them. Check the license of a source before reusing its data.

ts_show_ref_sources(versions = FALSE, tidy = FALSE)

Arguments

versions

Logical; also list the versions available to download? Needs internet. If a source cannot be reached, its versions are NA and a message says why. Default FALSE.

tidy

Logical; return a "tidy" dataframe. If versions is TRUE, returns one row per version. Default FALSE.

Value

A dataframe with one row per source and these columns: source (the name to give to the source argument of ts_load_ref()), name, description, license, citation and url.

With versions = TRUE, the versions available to download for each source are shown, newest first. Printing the result shows only the latest versions of each source. To see all of them, also use tidy = TRUE.

With tidy = TRUE, the dataframe has one row per version, unless versions = FALSE.

Details

By default no internet is used. With versions = TRUE, the versions that can be downloaded are looked up (one or two requests per source), which is useful to choose the version of ts_load_ref() to use. This can take some time (a few seconds, and longer with a slow connection).

Examples

ts_show_ref_sources()
#> wfo: World Flora Online Plant List
#>   Plants (vascular plants and bryophytes); a new version every June and December
#>   License: CC0 1.0
#>   Cite: The World Flora Online Consortium. World Flora Online Plant List. https://doi.org/10.5281/zenodo.7460141
#>   More: https://wfoplantlist.org/
#> 
#> ppg: Pteridophyte Phylogeny Group classification (PPG II)
#>   Ferns and lycophytes
#>   License: CC BY 4.0
#>   Cite: Pteridophyte Phylogeny Group. PPG taxonomic database. https://doi.org/10.5281/zenodo.22760360
#>   More: https://github.com/pteridogroup/ppg
#> 
#> itis: Integrated Taxonomic Information System (ITIS)
#>   All kingdoms, mostly North American taxa (via taxadb)
#>   License: CC0 1.0
#>   Cite: Integrated Taxonomic Information System (ITIS), https://www.itis.gov/ Accessed through taxadb: Norman, K.E.A., Chamberlain, S. & Boettiger, C. (2020) taxadb: A high-performance local taxonomic database interface. Methods in Ecology and Evolution 11: 1153-1159. https://doi.org/10.1111/2041-210X.13440
#>   More: https://www.itis.gov/
#> 
#> col: Catalogue of Life (COL)
#>   All kingdoms (via taxadb)
#>   License: CC BY 4.0
#>   Cite: Catalogue of Life (COL), https://www.catalogueoflife.org/ Accessed through taxadb: Norman, K.E.A., Chamberlain, S. & Boettiger, C. (2020) taxadb: A high-performance local taxonomic database interface. Methods in Ecology and Evolution 11: 1153-1159. https://doi.org/10.1111/2041-210X.13440
#>   More: https://www.catalogueoflife.org/
#> 
#> gbif: GBIF Backbone Taxonomy
#>   All kingdoms (via taxadb)
#>   License: CC BY 4.0
#>   Cite: GBIF Backbone Taxonomy, https://www.gbif.org/ Accessed through taxadb: Norman, K.E.A., Chamberlain, S. & Boettiger, C. (2020) taxadb: A high-performance local taxonomic database interface. Methods in Ecology and Evolution 11: 1153-1159. https://doi.org/10.1111/2041-210X.13440
#>   More: https://www.gbif.org/
#> 
#> ncbi: NCBI Taxonomy
#>   Organisms in the sequence databases (via taxadb)
#>   License: CC0 1.0
#>   Cite: NCBI Taxonomy, https://www.ncbi.nlm.nih.gov/taxonomy Accessed through taxadb: Norman, K.E.A., Chamberlain, S. & Boettiger, C. (2020) taxadb: A high-performance local taxonomic database interface. Methods in Ecology and Evolution 11: 1153-1159. https://doi.org/10.1111/2041-210X.13440
#>   More: https://www.ncbi.nlm.nih.gov/taxonomy
#> 
#> ott: Open Tree Taxonomy (OTT)
#>   All kingdoms, as used by the Open Tree of Life (via taxadb)
#>   License: CC0 1.0
#>   Cite: Open Tree Taxonomy (OTT), https://tree.opentreeoflife.org/ Accessed through taxadb: Norman, K.E.A., Chamberlain, S. & Boettiger, C. (2020) taxadb: A high-performance local taxonomic database interface. Methods in Ecology and Evolution 11: 1153-1159. https://doi.org/10.1111/2041-210X.13440
#>   More: https://tree.opentreeoflife.org/
#> 
#> fb: FishBase
#>   Fishes (via taxadb)
#>   License: CC BY-NC 4.0
#>   Cite: FishBase, https://fishbase.org/ Accessed through taxadb: Norman, K.E.A., Chamberlain, S. & Boettiger, C. (2020) taxadb: A high-performance local taxonomic database interface. Methods in Ecology and Evolution 11: 1153-1159. https://doi.org/10.1111/2041-210X.13440
#>   More: https://fishbase.org/
#> 
#> slb: SeaLifeBase
#>   Marine organisms other than fishes (via taxadb)
#>   License: CC BY-NC 4.0
#>   Cite: SeaLifeBase, https://www.sealifebase.org/ Accessed through taxadb: Norman, K.E.A., Chamberlain, S. & Boettiger, C. (2020) taxadb: A high-performance local taxonomic database interface. Methods in Ecology and Evolution 11: 1153-1159. https://doi.org/10.1111/2041-210X.13440
#>   More: https://www.sealifebase.org/

if (FALSE) { # interactive()
# Needs internet
ts_show_ref_sources(versions = TRUE)

# One row per version
ts_show_ref_sources(versions = TRUE, tidy = TRUE)
}