export_geoclim_month: Export monthly data in GeoCLIM format

In IDEMSInternational/cdms.products: Tool for the Analysis of Historical Climatic Data

Export monthly data in GeoCLIM format

Description

export_geoclim_month takes a data frame that is given by month. This data frame is then rearranged using prepare_geoclim_month to a format suitable for use in GeoCLIM, and then written to a file or connection.

Usage

export_geoclim_month(
  data,
  year,
  month,
  element,
  station_id,
  latitude,
  longitude,
  metadata = NULL,
  join_by = NULL,
  add_cols = NULL,
  file_path = paste0("GEOCLIM-", element, ".csv"),
  ...
)

Arguments

data	data.frame The data.frame to calculate from.
year	character(1) The name of the year column in data. If NULL it will be created using lubridate::year(data[[date_time]]).
month	character(1) The name of the month column in data. If NULL it will be created using lubridate::month(data[[date_time]]).
element	character(1) The name of the element column in data to apply the function to.
station_id	character(1) The name of the station column in metadata, or data if metadata = NULL.
latitude	character(1) The name of the latitude column in metadata, or data if metadata = NULL.
longitude	character(1) The name of the longitude column in metadata, or data if metadata = NULL.
metadata	data.frame The metadata data.frame to calculate from.
join_by	character The variable(s) to merge the data and metadata data frames.
add_cols	character Names of additional metadata columns that should be included in the output
file_path	character(1) A character specifying the file path and file name to export.
...	Other parameters passed to write.csv().

Value

Invisibly returns the file path of the saved data.

Examples

# Calculate monthly summaries for the rainfall column
summary_data <- daily_niger %>% dplyr::group_by(year, month, station_name) %>%
     dplyr::summarise(mean_rain = mean(rain))
export_geoclim_month(data = summary_data, year = "year", month = "month",
                     station_id = "station_name",
                     element = "mean_rain", metadata = stations_niger,
                     join_by = "station_name",
                     latitude = "lat", longitude = "long")

IDEMSInternational/cdms.products documentation built on July 7, 2023, 10:13 a.m.