Joining location properties to traits table — join_location

Function to merge metadata from the locations table of a traits.build database into the core traits table.

Usage

join_location_properties(
  database,
  format = "single_column_pretty",
  vars = "all"
)

database: traits.build database (list object)
format: Specifies whether metadata from the locations is output in a human readable format ("single_column_pretty"; default), with each location property added as a separate column ("many_columns") or using json syntax ("single_column_json").
vars: Location properties for which data is to be appended to the traits table, defaulting to all location properties (vars = "all").

traits.build list object, but location properties from the locations table appended to the traits table.

the join_ functions have been developed to join relational tables for databases built using the traits.build workflow. Learn more at: https://github.com/traitecoevo/traits.build & https://github.com/traitecoevo/traits.build-book

Note to AusTraits users:

This function works with AusTraits version >= 5.0.0 (from Nov 2023 release)
For AusTraits versions <= 4.2.0 (up to Sept 2023 release) see https://github.com/traitecoevo/austraits for how to install old versions of the package or download a newer version of the database.

if (FALSE) { # \dontrun{
(database %>% join_location_properties(format = "single_column_pretty", vars = "all"))$traits
} # }