Save a known location table — table_save • MazamaLocationUtils

Save a tibble of known locations to the preferred directory. If outputType is a vector, the known locations table will be saved to the preferred directory in multiple formats.

table_save(
  locationTbl = NULL,
  collectionName = NULL,
  backup = TRUE,
  outputType = "rda"
)

Arguments

locationTbl: Tibble of known locations.
collectionName: Character identifier for this table.
backup: Logical specifying whether to save a backup version of any existing tables sharing collectionName.
outputType: Vecctor of output formats. (Currently only "rda" or "csv" are supported.)

Value

File path of saved file.

Details

Backup files are saved with "YYYY-mm-ddTHH:MM:SS"

Examples

library(MazamaLocationUtils)

# Set the directory for saving location tables
setLocationDataDir(tempdir())

# Load an example table and check the dimensions
locationTbl <- get(data("wa_monitors_500"))
dim(locationTbl)
#> [1] 78 13

# Save it as "table_save_example"
table_save(locationTbl, "table_save_example")

# Add a column and save again 
locationTbl %>% 
  table_addColumn("my_column") %>% 
  table_save("table_save_example")
  
# Check the locationDataDir
list.files(getLocationDataDir(), pattern = "table_save_example")
#> [1] "table_save_example.2024-08-14T19:48:13.rda"
#> [2] "table_save_example.rda"