datSumCond: Data - Aggregates numeric condition data to plot level.

In USDAForestService/FIESTA: Forest Inventory Estimation and Analysis

Data - Aggregates numeric condition data to plot level.

Description

Aggregates CONDPROP_UNADJ variable or other continuous condition variables to plot level with option to apply condition filters. If condition variable is not CONDPROP_UNADJ the variable is multiplied by CONDPROP_UNADJ for weighted sum.

Usage

datSumCond(
  cond = NULL,
  datsource = "obj",
  dbconn = NULL,
  dsn = NULL,
  plt = NULL,
  subp_cond = NULL,
  subplot = NULL,
  bycond = FALSE,
  bysubp = FALSE,
  csumvar = NULL,
  csumvarnm = NULL,
  cfilter = NULL,
  getadjplot = FALSE,
  adjcond = FALSE,
  cround = 5,
  savedata = FALSE,
  tabIDs = tableIDs(),
  savedata_opts = NULL
)

Arguments

cond	Data frame or comma-delimited file (*.csv). Condition-level table with aggregate variable and CONDPROP_UNADJ.
datsource	String. Source of data ('obj', 'csv', 'sqlite', 'gdb').
dbconn	Open database connection.
dsn	String. If datsource='sqlite', the name of SQLite database (*.sqlite).
plt	Data frame, comma-delimited file (*.csv), shapefile (*.shp), or database file. Plot-level table to join the aggregated tree data to (if bycond=FALSE). Nonsampled plots (PLOT_STATUS_CD = 3) are removed. Optional.
subp_cond	Dataframe, comma-delimited file (*.csv), or shapefile (*.shp). Subplot condition-level table to use to sum condition proportions, if bysubp=TRUE.
subplot	Dataframe, comma-delimited file (*.csv), or shapefile (*.shp). Subplot-level table to used to calculate adjustment factors, to remove nonsampled conditions (SUBP_STATUS_CD = 3). This table is optional.
bycond	Logical. If TRUE, the data are aggregated to the condition level (by: cuniqueid, condid). If FALSE, the data are aggregated to the plot level (by: puniqueid).
bysubp	Logical. If TRUE, data are aggregated to the subplot level.
csumvar	String. One or more variable names to sum to plot level.
csumvarnm	String. Name of the resulting aggregated plot-level variable(s). Default = csumvar + '_PLT'.
cfilter	String. A filter to subset the cond data before aggregating (e.g., "COND_STATUS_CD == 1"). Must be R syntax.
getadjplot	Logical. If TRUE, adjustments are calculated for nonsampled conditions on plot.
adjcond	Logical. If TRUE, csumvar condition variables are adjusted for nonsampled conditions by plot.
cround	Number. The number of digits to round to. If NULL, default=5.
savedata	Logical. If TRUE, saves data to outfolder.
tabIDs	List of unique IDs corresponding to the tables. See See help(tableIDs) for a list of options.
savedata_opts	List. See help(savedata_options()) for a list of options. Only used when savedata = TRUE. If out_layer = NULL, default = 'condsum'.

Details

If variable = NULL, then it will prompt user for input.

Value

A list of the following items:

condsum	Data frame. Plot-level table with aggregated condition attribute.
cfilter	Condition filter.

If savedata=TRUE, condsum is saved to the outfolder.

Note

Nonsampled plots are removed from table.

Author(s)

Tracey S. Frescino

Examples

# Aggregate LIVE_CANOPY_CVR_PCT to plot, weighted by CONDPROP_UNADJ
condsum <- datSumCond(cond = FIESTA::WYcond,
                      csumvar = "LIVE_CANOPY_CVR_PCT")$condsum

# Check results
condsum[condsum$PLT_CN == 40404737010690,]
FIESTA::WYcond[FIESTA::WYcond$PLT_CN == 40404737010690,]

USDAForestService/FIESTA documentation built on April 5, 2025, 4:13 a.m.