fnc_write_agg: Function to aggregate and write data from automated...

In rhabel/modLWFB90: R-package for applying LWF-Brook90 directly from FVA-BW servers

Function to aggregate and write data from automated LWFB90-Runs

Description

LWFBrook90 creates a lot of output files. In order to keep data storage to a minimum, both run_LWFB90 and run_multisite_LWFB90 provide an output_fun - argument that can be used to reduce the output and directly write it to a database. This is what this function is made for.
Since v.0.5.0 LWFBrook90R changed the output/default settings.
fnc_write reduces and aggregates all columns returned by run_LWFB90 (see help page).
fnc_write_agg enables an even more detailed selection of drought indices. See detail section for a full list. Because many indices are calculated, this function will be significantly slower, so check, if you can get the necessary information from the standard list of output variables.
Both functions write .rds files with the desired output for each point. fnc_write_to_sql can be used to convert these files into a SQLite-DB. This "step-in-between" is necessary because SQLite does not support parallel writing.

Usage

fnc_write_agg(
  x,
  aggr_tp,
  col_select_day = NA,
  col_select_mon = NA,
  col_select_vp = NA,
  col_select_yr = NA,
  dir_name = NA
)

Arguments

x	one of the intermediate producs of run_LWFB90 or run_multisite_LWFB90, which is further processed internally. Can't be adjusted.
aggr_tp	a string containing the desired aggregation time period. Can be daily, monthly, vegper, yearly, or any combination of the four (i.e. monthly_vegper). The latter creates results for all aggregation terms detectable within the string.
col_select_day	a string containing the desired columns from the daily-aggregation (see details)
col_select_mon	a string containing the desired columns from the monthly-aggregation (see details)
col_select_vp	a string containing the desired columns from the vegperiod-aggregation (see details)
col_select_yr	a string containing the desired columns from the yearly-aggregation (see details)
dir_name	directory for tmp files, if NA as in default, results are returned to console

Value

Returns the desired output to .rds files, or, the console

Output column selection

IT IS HIGHLY RECOMMENDED TO MAKE A SUBSELECTION, OR THERE WILL BE A LOT (>100) OF COLUMNS. For a complete list of possible output types plus description, see "U:/db_brook90_output/whh_db_documentation"

Examples

# for full example, see help page of ?fnc_write_to_sql

rhabel/modLWFB90 documentation built on Jan. 21, 2025, 8:04 p.m.