apa_add_subplot_dat

A <code>apa_list</code>-object that was created with the
[apa_list]-function.

apa_list

A named list with datasets (<code>sf</code>-<code>data.frame</code>s)
about the subplots . Each <code>data.frame</code> in <code>subplot_dat</code> has to
have a unique name, a column with the <code>plot_id</code>, an own id-column
(specified via the <code>subplot_id_column</code> argument) and a geometry
column. The geometry column either has to contain <code>POLYGON</code>-data or
<code>POINT</code>-data (in which case APA-properties in circular neighborhoods
around the points will be calculated.)

subplot_dat

A named vector specifying the id-columns of the
subplot datasets.

subplot_id_column

If a geometry column in <code>subplot_dat</code> contains
<code>POINT</code>-data, <code>radius</code> specifies the radius of the neighborhood
analysis.

radius

Should polygons of the the APA-patches added to the
dataset?

apa_polygon

If there are subplots within the plots for which APA-characteristics should be
calculated, they may be added to the <code>apa_list</code>.

Maps of the 'area potentially available' (APA) of trees is calculated from
mapped forest stands using the approach from Gspaltl et al. (2012) <doi:10.1093/forestry/cps052>.
This is done by computing a rasterized version of
'weighted voronoi diagrams' using a an approximation of the trees competitive
ability (e.g., crown radius, leaf area) as weight. The main output are 'Raster*'-
objects from the 'raster' package that are stored together with the raw data in
apa_list's, the main class of the 'APAtree' package. Aggregation functions are
provided to calculate stand characteristics based on APA-maps such as relative
proportions according to APA-size and the neighborhood diversity index NDiv
(Glatthorn (2021) <doi:10.1016/j.ecolind.2021.108073>).

apa_add_subplot_dat: Add subplots to datasets

Description

Usage

Arguments