Skip to contents

Rename Columns using Darwin Core Standard Terms

Source: R/as_dwc.R
as_dwc.Rd

as_dwc() rename columns in a tbl_df using a vector of terms defined by Darwin Core Standard.

Usage

as_dwc(dwc, data, terms)

Arguments

dwc

a list of standard terms and definitions created using get_dwc().

data

a tbl_df.

terms

a vector or list of terms to be used as replacement.

Value

an object of class tbl_df.

Details

as_dwc() will replace current column names by the ones defined in terms. For each column in data, Darwin Core equivalent terms must be informed in the same order by the user. If terms and column names do not match in length or if terms used are not found in Darwin Core standard, an error will be printed on Console.

Author

Pedro S. Bittencourt, Rupert A. Collins.

Examples


# get dwc terms and definitions
dwc <- get_dwc(type = "simple")

# create a data frame with sample metadata
my_df <- tibble::tibble(
  species = c("sp1", "sp2", "sp3"),
  location = c("loc1", "loc2", "loc3"),
  voucher = c("M01", "M02", "M03"),
  collector = c("John", "Robert", "David")
)

# rename columns
as_dwc(dwc, my_df, terms = c("scientificName", "locality", "catalogNumber", "recordedBy"))
#> # A tibble: 3 × 4
#>   scientificName locality catalogNumber recordedBy
#>   <chr>          <chr>    <chr>         <chr>     
#> 1 sp1            loc1     M01           John      
#> 2 sp2            loc2     M02           Robert    
#> 3 sp3            loc3     M03           David