Title: | ARAchnid KNowledge Online |
---|---|
Description: | Allows the user to connect with the World Spider Catalogue (WSC; <https://wsc.nmbe.ch/>) and the World Spider Trait (WST; <https://spidertraits.sci.muni.cz/>) databases. Also performs several basic functions such as checking names validity, retrieving coordinate data from the Global Biodiversity Information Facility (GBIF; <https://www.gbif.org/>), and mapping. |
Authors: | Pedro Cardoso [aut, cre] |
Maintainer: | Pedro Cardoso <[email protected]> |
License: | GPL-3 |
Version: | 1.3.0 |
Built: | 2024-12-08 07:19:49 UTC |
Source: | CRAN |
Get species authority from the World Spider Catalogue.
authors(tax, order = FALSE)
authors(tax, order = FALSE)
tax |
A taxon name or vector with taxa names. |
order |
Order taxa alphabetically or keep as in tax. |
This function will get species authorities from the World Spider Catalogue (2022). Higher taxa will be converted to species names.
A data.frame with species and authority names.
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: authors("Amphiledorus") authors(tax = c("Iberesia machadoi", "Nemesia bacelarae", "Amphiledorus ungoliantae"), order = TRUE) ## End(Not run)
## Not run: authors("Amphiledorus") authors(tax = c("Iberesia machadoi", "Nemesia bacelarae", "Amphiledorus ungoliantae"), order = TRUE) ## End(Not run)
Create a phylogenetic tree based on the backbone from Macias-Hernandez et al. (2020) and the species taxonomical hierarchy.
buildtree(tax, update = FALSE)
buildtree(tax, update = FALSE)
tax |
A taxon name or vector with taxa names. Should be in the general form "Family_sp" or "Genus speciesname", with family or genus name plus anything to uniquely identify the species separated by "_" or " ". |
update |
Whether to update the taxonomy of the backbone tree according to the WSC (2022). |
Based on the backbone phylogeny of Macias-Hernandez et al. (2020). All species in tax present in the backbone are included in the output tree. If the species is not in the backbone, or if only family or genus are known, species are inserted at the level of the most recent common ancestor of confamiliar or congenerics respectively. If only one congeneric or confamiliar are in the backbone, the species is inserted at half the length of the corresponding edge.
A phylo object with a phylogenetic tree for the community.
Macías-Hernández et al. (2020). Building-up of a robust, densely sampled spider tree of life for assessing phylogenetic diversity at the community level. Diversity, 12: 288. https://doi.org/10.3390/d12080288
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: spp = c("Atypus affinis", "Tenuiphantes tenuis", "Zodarion sp1", "Araneus diadematus") spp = c(spp, "Zodarion sp2", "Atypus_nsp", "Nemesia ungoliant", "Linyphiidae sp1") spp = c(spp, "Zoropsis spinimana", "Pardosa sp1", "Pardosa acorensis", "Liphistius nsp") tree = buildtree(spp) plot(tree) ## End(Not run)
## Not run: spp = c("Atypus affinis", "Tenuiphantes tenuis", "Zodarion sp1", "Araneus diadematus") spp = c(spp, "Zodarion sp2", "Atypus_nsp", "Nemesia ungoliant", "Linyphiidae sp1") spp = c(spp, "Zoropsis spinimana", "Pardosa sp1", "Pardosa acorensis", "Liphistius nsp") tree = buildtree(spp) plot(tree) ## End(Not run)
Check taxa names against the World Spider Catalogue.
checknames(tax, full = FALSE, order = FALSE)
checknames(tax, full = FALSE, order = FALSE)
tax |
A taxon name or vector with taxa names. |
full |
returns the full list of names. |
order |
Order taxa alphabetically or keep as in tax. |
This function will check if all species, genera and family names in tax are updated according to the World Spider Catalogue (2022). If not, it returns a matrix with nomenclature changes, valid synonyms or possible misspellings using fuzzy matching (Levenshtein edit distance).
If any mismatches, a matrix with taxa not found in WSC or, if full = TRUE, the full list of names.
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: tax = c("Nemesis", "Nemesia brauni", "Iberesia machadoi", "Nemesia bacelari") checknames(tax) checknames(tax, full = TRUE, order = TRUE) ## End(Not run)
## Not run: tax = c("Nemesis", "Nemesia brauni", "Iberesia machadoi", "Nemesia bacelari") checknames(tax) checknames(tax, full = TRUE, order = TRUE) ## End(Not run)
Get countries of taxa from the World Spider Catalogue textual descriptions.
countries(tax)
countries(tax)
tax |
A taxon name or vector with taxa names. |
Countries based on the interpretation of the textual descriptions available at the World Spider Catalogue (2022). These might be only approximations to country level and should be taken with caution.
A vector with country ISO codes. Family and genera names will be converted to species.
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: countries("Iberesia machadoi") countries(c("Iberesia machadoi", "Nemesia")) ## End(Not run)
## Not run: countries("Iberesia machadoi") countries(c("Iberesia machadoi", "Nemesia")) ## End(Not run)
Get species distribution from the World Spider Catalogue.
distribution(tax, order = FALSE)
distribution(tax, order = FALSE)
tax |
A taxon name or vector with taxa names. |
order |
Order taxa alphabetically or keep as in tax. |
This function will get species distributions from the World Spider Catalogue (2022).
A data.frame with species and distribution. Family and genera names will be converted to species.
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: distribution("Nemesia") distribution(tax = c("Iberesia machadoi", "Amphiledorus ungoliantae"), order = TRUE) ## End(Not run)
## Not run: distribution("Nemesia") distribution(tax = c("Iberesia machadoi", "Amphiledorus ungoliantae"), order = TRUE) ## End(Not run)
Get endemic species in any country or region from the World Spider Catalogue textual descriptions.
endemics(country)
endemics(country)
country |
The country/region name or ISO3 code. |
Species list based on the interpretation of the textual descriptions available at the World Spider Catalogue (2022). These might be only approximations to country level and should be taken with caution.
A vector with species names.
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: endemics("Portugal") endemics("Azores") endemics("FIN") ## End(Not run)
## Not run: endemics("Portugal") endemics("Azores") endemics("FIN") ## End(Not run)
From Macias-Hernandez et al. (2020) with nomenclature updated.
data(globalTree)
data(globalTree)
A phylo object with 132 families and 800+ genera, 1400+ species.
Get species LSID from the World Spider Catalogue.
lsid(tax, order = FALSE)
lsid(tax, order = FALSE)
tax |
A taxon name or vector with taxa names. |
order |
Order taxa names alphabetically or keep as in tax. |
This function will get species LSID from the World Spider Catalogue (2022). Family and genera names will be converted to species.
A data.frame with species and LSID.
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: lsid("Anapistula") lsid(tax = c("Iberesia machadoi", "Nemesia bacelarae", "Amphiledorus ungoliantae"), order = TRUE) ## End(Not run)
## Not run: lsid("Anapistula") lsid(tax = c("Iberesia machadoi", "Nemesia bacelarae", "Amphiledorus ungoliantae"), order = TRUE) ## End(Not run)
Maps species range according to the World Spider Catalogue and records according to GBIF and the World Spider Trait database.
map( tax, countries = TRUE, records = TRUE, hires = FALSE, zoom = FALSE, order = FALSE, verbose = TRUE )
map( tax, countries = TRUE, records = TRUE, hires = FALSE, zoom = FALSE, order = FALSE, verbose = TRUE )
tax |
A taxon name or vector with taxa names. |
countries |
Maps countries according to WSC. |
records |
Maps records according to GBIF and WST. |
hires |
Provides high resolution maps. Beware it might take longer to render. |
zoom |
If records is TRUE, the map will be zoomed to the region with records. |
order |
Order taxa names alphabetically or keep as in tax. |
verbose |
Display information as data are retrieved. |
Countries based on the interpretation of the textual descriptions available at the World Spider Catalogue (2022). These might be only approximations to country level and should be taken with caution.
A world map with countries and records highlighted.
Pekar et al. (2021). The World Spider Trait database: a centralized global open repository for curated data on spider traits. Database, 2021: baab064. https://doi.org/10.1093/database/baab064
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: map(c("Pardosa hyperborea")) map("Amphiledorus", zoom = TRUE, hires = TRUE) map(c("Pardosa hyperborea", "Iberesia machadoi"), countries = FALSE, hires = TRUE, zoom = TRUE) ## End(Not run)
## Not run: map(c("Pardosa hyperborea")) map("Amphiledorus", zoom = TRUE, hires = TRUE) map(c("Pardosa hyperborea", "Iberesia machadoi"), countries = FALSE, hires = TRUE, zoom = TRUE) ## End(Not run)
Downloads coordinate data from records in GBIF and the World Spider Trait database.
records(tax, order = FALSE, verbose = TRUE)
records(tax, order = FALSE, verbose = TRUE)
tax |
A taxon name or vector with taxa names. |
order |
Order taxa names alphabetically or keep as in tax. |
verbose |
Display information as data are retrieved. |
Outputs non-duplicate records with geographical (long, lat) coordinates. As always when using data from multiple sources the user should be careful and check if records "make sense" before using them.
A data.frame with species name, longitude, latitude, source database and reference.
Pekar et al. (2021). The World Spider Trait database: a centralized global open repository for curated data on spider traits. Database, 2021: baab064. https://doi.org/10.1093/database/baab064
## Not run: records("Pardosa hyperborea") records(tax = c("Pardosa hyperborea", "Anapistula"), order = TRUE) ## End(Not run)
## Not run: records("Pardosa hyperborea") records(tax = c("Pardosa hyperborea", "Anapistula"), order = TRUE) ## End(Not run)
Get species within given families or genera from the World Spider Catalogue.
species(tax, order = FALSE)
species(tax, order = FALSE)
tax |
A taxon name or vector with taxa names. |
order |
Order species names alphabetically. |
This function will get all species currently listed for given families or genera from the World Spider Catalogue (2022).
A vector with species names.
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: species("Amphiledorus") species(tax = c("Amphiledorus", "Nemesiidae"), order = TRUE) ## End(Not run)
## Not run: species("Amphiledorus") species(tax = c("Amphiledorus", "Nemesiidae"), order = TRUE) ## End(Not run)
Get species sub/infraorder, family and genus from the World Spider Catalogue.
taxonomy(tax, check = FALSE, aut = FALSE, id = FALSE, order = FALSE)
taxonomy(tax, check = FALSE, aut = FALSE, id = FALSE, order = FALSE)
tax |
A taxon name or vector with taxa names. |
check |
species names should be replaced by possible matches in the WSC if outdated. |
aut |
add species authorities. |
id |
the lsid should be returned. |
order |
Order taxa names alphabetically or keep as in tax. |
This function will get species sub/infraorder, family and genus from the World Spider Catalogue (2022). Optionally, it will correct the species names (using function checknames) and provide the lsid and authors from the WSC (using functions lsid and authors).
A data.frame with species and taxonomy.
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: taxonomy("Symphytognathidae", order = TRUE, aut = TRUE) taxonomy(c("Nemesia machadoi", "Nemesia bacelari"), check = TRUE, aut = TRUE, id = TRUE) ## End(Not run)
## Not run: taxonomy("Symphytognathidae", order = TRUE, aut = TRUE) taxonomy(c("Nemesia machadoi", "Nemesia bacelari"), check = TRUE, aut = TRUE, id = TRUE) ## End(Not run)
Downloads the most recent data from the World Spider Trait database.
traits( tax, trait = NULL, sex = NULL, life = NULL, country = NULL, habitat = NULL, user = "", key = "", order = FALSE, verbose = TRUE )
traits( tax, trait = NULL, sex = NULL, life = NULL, country = NULL, habitat = NULL, user = "", key = "", order = FALSE, verbose = TRUE )
tax |
A taxon name or vector with taxa names. |
trait |
A vector with required trait(s) as abbreviations. Valid values can be found at: https://spidertraits.sci.muni.cz/traits |
sex |
A vector with required sex(es). |
life |
A vector with required life stage(s). |
country |
A vector with required country(ies) ISO3 code(s). |
habitat |
A vector with required habitat(s). |
user |
To obtain restricted data get a user name from https://spidertraits.sci.muni.cz/api. |
key |
To obtain restricted data get an api key from https://spidertraits.sci.muni.cz/api. |
order |
Order taxa names alphabetically or keep as in tax. |
verbose |
Display information as data are retrieved. |
The World Spider Trait database (Pekar et al. 2021) has been designed to contain trait data in a broad sense, from morphological traits to ecological characteristics, ecophysiology, behavioural habits, and more (Lowe et al. 2020). This function will download everything available for the taxa given, possibly filtered to the traits given in parameter trait. Some data might be restricted access, in which case a user name and api key are needed (https://spidertraits.sci.muni.cz/api), otherwise the value will show as NA.
A matrix with trait data.
Lowe, E., Wolff, J.O., Aceves-Aparicio, A., Birkhofer, K., Branco, V.V., Cardoso, P., Chichorro, F., Fukushima, C.S., Goncalves-Souza, T., Haddad, C.R., Isaia, M., Krehenwinkel, H., Audisio, T.L., Macias-Hernandez, N., Malumbres-Olarte, J., Mammola, S., McLean, D.J., Michalko, R., Nentwig, W., Pekar, S., Petillon, J., Privet, K., Scott, C., Uhl, G., Urbano-Tenorio, F., Wong, B.H. & Herbestein, M.E. (2020). Towards establishment of a centralized spider traits database. Journal of Arachnology, 48: 103-109. https://doi.org/10.1636/0161-8202-48.2.103
Pekar et al. (2021). The World Spider Trait database: a centralized global open repository for curated data on spider traits. Database, 2021: baab064. https://doi.org/10.1093/database/baab064
## Not run: traits("Atypus affinis") traits("Atypus", order = TRUE) traits("Atypidae", country = c("PRT", "CZE"), order = TRUE) traits(c("Zodarion costapratae", "Zodarion alacre")) traits(c("Iberesia machadoi", "Zodarion costapratae"), trait = c("balo", "bole")) ## End(Not run)
## Not run: traits("Atypus affinis") traits("Atypus", order = TRUE) traits("Atypidae", country = c("PRT", "CZE"), order = TRUE) traits(c("Zodarion costapratae", "Zodarion alacre")) traits(c("Iberesia machadoi", "Zodarion costapratae"), trait = c("balo", "bole")) ## End(Not run)
Downloads the most recent data from the World Spider Catalogue.
wsc()
wsc()
The World Spider Catalog (2022) lists all currently valid species of spiders, from Clerck to date. Updated daily.
A matrix with all current species names and distribution. This should be used for other functions using wsc data.
World Spider Catalog (2022). World Spider Catalog. Version 23.0. Natural History Museum Bern, online at http://wsc.nmbe.ch. doi: 10.24436/2.
## Not run: wsc() ## End(Not run)
## Not run: wsc() ## End(Not run)
A dataset that links species distribution descriptions with the map using the ISO3 code
data(wscmap)
data(wscmap)
A matrix with regions and corresponding ISO3 codes.