arakno (version 1.3.1)

traits: Get trait data from WST.

Description

Downloads the most recent data from the World Spider Trait database.

Usage

traits(
  tax,
  trait = NULL,
  sex = NULL,
  life = NULL,
  country = NULL,
  habitat = NULL,
  user = "",
  key = "",
  order = FALSE,
  verbose = TRUE
)

Value

A matrix with trait data.

Arguments

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.

Details

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.

References

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

Examples

if (FALSE) {
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"))
}