austraits is the R interface to AusTraits,
the Australian plant trait database. It loads releases of AusTraits by
version number (load_austraits(), get_versions(),
get_version_latest()) and maps trait data over Australia
(plot_locations()).
The functions to access, explore and wrangle data (joining tables,
filtering records, combining databases and visualising data) come from
traits.use, which works
on any traits.build
relational database. austraits re-exports all of them, so
library(austraits) is all you need, and code written for earlier
versions of austraits keeps working. See the traits.use
documentation for the
generic functions.
This package is not on CRAN yet and is still under active development.
For the current stable release of austraits, which has full
capabilities of the functions used in vignettes (e.g. plotting
functions), use:
#install.packages("remotes")
remotes::install_github("traitecoevo/austraits", dependencies = TRUE, upgrade = "ask")
library(austraits) This also installs traits.use. For a lightweight installation where
dependencies for plotting and producing the vignettes will not be
installed, use:
remotes::install_github("traitecoevo/austraits", upgrade = "ask")-
For R users, the AusTraits database can be accessed through the
austraitspackage usingload_austraits() -
For Python or other users, each AusTraits release on Zenodo includes a
.zipfile containing all the data in plain text (.csvfiles) and associated meta-data
From September 2024, austraits functions were revamped to support all
traits.build compiled
databases, rather than being linked to
austraits.build. In
2026 those generic functions moved to
traits.use (version 4.0.0
of austraits).
Versions of austraits.build (the AusTraits plant trait database) <
5.0 are no longer supported by the latest version of the package. If
you are working with an older version of AusTraits, please install an
older version of austraits:
For austraits.build versions 4.2 and older:
#install.packages("remotes")
remotes::install_github("traitecoevo/austraits@v2.2.2", dependencies = TRUE, upgrade = "ask")
library(austraits)Note, if you are unsure what version of AusTraits you are working with, run:
austraits$build_info$versionWe highly recommend taking a look at our Getting Started
tutorial
on our website before jumping into the austraits R package!
If you prefer to view this vignette in R, we recommend installing the
package with build_vignettes = TRUE.
remotes::install_github("traitecoevo/austraits",
dependencies = TRUE, upgrade = "ask",
build_vignettes = TRUE)
vignette("austraits")The cheat sheet was drawn for austraits 3.0.0. Since then
plot_trait_distribution_beeswarm() has been removed (use
plot_trait_distribution()), and two names on it were always misspelt:
the functions are join_context_properties() and
lookup_location_property().
AusTraits is a relational database, you can learn more about it’s structure from the traits.build book.
You can also learn about the definitions of each plant trait with the AusTraits Plant Dictionary!
Please consider citing austraits, we would super appreciate it!
citation("austraits")
#> To cite austraits in publications use:
#>
#> Falster, D., Gallagher, R., Wenk, E.H. et al. (2021) AusTraits, a
#> curated plant trait database for the Australian flora. Scientific
#> Data 8, 254. https://doi.org/10.1038/s41597-021-01006-6
#>
#> A BibTeX entry for LaTeX users is
#>
#> @Article{,
#> title = {AusTraits, a curated plant trait database for the Australian flora},
#> author = {Daniel Falster and Rachael Gallagher and Elizabeth H. Wenk and Ian J. Wright and Dony Indiarto and Samuel C. Andrew and others},
#> journal = {Scientific Data},
#> year = {2021},
#> volume = {8},
#> number = {1},
#> pages = {254},
#> doi = {10.1038/s41597-021-01006-6},
#> url = {https://doi.org/10.1038/s41597-021-01006-6},
#> }Check out austraits.build, if you are interested in how AusTraits the database is managed and created
Thank you for finding it! Let us know on the issue tracker. If the bug is in one of the data-wrangling functions, it may belong in traits.use’s tracker instead; either place is fine.
austraits is part of the AusTraits family of packages maintained
by the AusTraits team. See
austraits.org for the project, the data,
and the people behind it.
Contributing? Issues across the family are tracked on one board,
AusTraits #9, and new
issues are auto-added. Please read the issue & labelling
guide
in austraits-meta —
the family’s cross-package knowledge and governance hub — before filing.
AusTraits is made possible by contributions from our partner organisations — the University of New South Wales, Western Sydney University, Botanic Gardens of Sydney, the University of Melbourne, the Atlas of Living Australia, and the Australian Government Department of Climate Change, Energy, the Environment and Water — and from our advisory board, data contributors, and past partners.
AusTraits is a co-investment partnership with the Australian Research Data Commons (ARDC) through the Planet Research Data Commons (DOI: 10.3565/nyk4-4r91). The ARDC is enabled by the Australian Government’s National Collaborative Research Infrastructure Strategy (NCRIS).

