create_oneAPCsummaryTable

Internal helper function to be called in <code>create_APCsummary</code>.
This function creates the summary table for one model estimated with
<code><a href="/link/gam?package=APCtools&version=1.0.4" data-mini-rdoc="APCtools::gam">gam</a></code> or <code><a href="/link/bam?package=APCtools&version=1.0.4" data-mini-rdoc="APCtools::bam">bam</a></code>.

Age-Period-Cohort (APC) analyses are used to differentiate relevant drivers for long-term developments.
The 'APCtools' package offers visualization techniques and general routines to simplify the workflow of an APC analysis.
Sophisticated functions are available both for descriptive and regression model-based analyses.
For the former, we use density (or ridgeline) matrices and (hexagonally binned) heatmaps as innovative visualization
techniques building on the concept of Lexis diagrams.
Model-based analyses build on the separation of the temporal dimensions based on generalized additive models,
where a tensor product interaction surface (usually between age and period) is utilized
to represent the third dimension (usually cohort) on its diagonal.
Such tensor product surfaces can also be estimated while accounting for
further covariates in the regression model.
See Weigert et al. (2021) <doi:10.1177/1354816620987198> for methodological details.

Alexander Bauer

APCtools

Routines for Descriptive and Model-Based APC Analysis

Maximilian Weigert

Hawre Jalal

create_oneAPCsummaryTable function

<dl><dt>model</dt>
<dd>Optional regression model estimated with <code><a href="/link/gam?package=APCtools&version=1.0.4" data-mini-rdoc="APCtools::gam">gam</a></code>
or <code><a href="/link/bam?package=APCtools&version=1.0.4" data-mini-rdoc="APCtools::bam">bam</a></code> to estimate a smoothed APC surface. Only used if
<code>y_var</code> is not
specified.</dd>
<dt>dat</dt>
<dd>Dataset with columns <code>period</code> and <code>age</code>. If <code>y_var</code>
is specified, the dataset must contain the respective column. If <code>model</code>
is specified, the dataset must have been used for model estimation with
<code>gam</code> or <code>bam</code>.</dd>
<dt>apc_range</dt>
<dd>Optional list with one or multiple elements with names
<code>"age","period","cohort"</code> to filter the data. Each element should
contain a numeric vector of values for the respective variable that should
be kept in the data. All other values are deleted.</dd></dl>

Arguments

Internal helper function to be called in <code>create_APCsummary</code>.
This function creates the summary table for one model estimated with
<code><a href='https://rdrr.io/pkg/mgcv/man/gam.html'>gam</a></code> or <code><a href='https://rdrr.io/pkg/mgcv/man/bam.html'>bam</a></code>.

Internal helper to create a summary table for one estimated GAM model — create_oneAPCsummaryTable

<dl>

<dt>model</dt>
<dd>Optional regression model estimated with <code><a href='https://rdrr.io/pkg/mgcv/man/gam.html'>gam</a></code>
or <code><a href='https://rdrr.io/pkg/mgcv/man/bam.html'>bam</a></code> to estimate a smoothed APC surface. Only used if
<code>y_var</code> is not
specified.</dd>


<dt>dat</dt>
<dd>Dataset with columns <code>period</code> and <code>age</code>. If <code>y_var</code>
is specified, the dataset must contain the respective column. If <code>model</code>
is specified, the dataset must have been used for model estimation with
<code>gam</code> or <code>bam</code>.</dd>


<dt>apc_range</dt>
<dd>Optional list with one or multiple elements with names
<code>"age","period","cohort"</code> to filter the data. Each element should
contain a numeric vector of values for the respective variable that should
be kept in the data. All other values are deleted.</dd>

</dl>

create_oneAPCsummaryTable: Internal helper to create a summary table for one estimated GAM model

Description

Usage

Value

Arguments