summary_table_by

Create a summary table using multiple rows for grouping on one target column

Create high-performance clinical reporting tables (TLGs) from
ADaM-like inputs. The package provides a consistent, programmatic API
to generate common tables such as demographics, adverse event incidence,
and laboratory summaries, using 'data.table' for fast aggregation over
large populations. Functions support flexible target-variable selection,
stratification by treatment, and customizable summary statistics, and
return tidy, machine-readable results ready to render with downstream
table/formatting packages in analysis pipelines.

Ramiro Magno

dtlg

A Performance-Focused Package for Clinical Trial Tables

Max Ebenezer-Brown

Max Norman

Xinye Li

Anja Peebles-Brown

summary_table_by function

<dl><dt>dt</dt>
<dd>A <code>data.frame</code> containing, at least, the variables indicated in
<code>target</code> and <code>treat</code>.</dd>
<dt>target</dt>
<dd>Target variable passed as a string for which summary
statistics are to be calculated.</dd>
<dt>treat</dt>
<dd>A string indicating the grouping variable, e.g. the variable
specifying the treatment population.</dd>
<dt>rows_by</dt>
<dd>string, grouping variable to split events by.</dd>
<dt>indent</dt>
<dd>A string to be used as indentation of summary statistics
labels. Defaults to four HTML non-breaking spaces (<code>&amp;nbsp;</code>).</dd>
<dt>.total_dt</dt>
<dd>Separate table from <code>dt</code> from which to derive total counts
per group.</dd>
<dt>pct_dec</dt>
<dd>Decimal places for reported figures.</dd>
<dt>treat_order</dt>
<dd>Customise the column order of the output table.</dd>
<dt>skip_absent</dt>
<dd>Whether to ignore variables passed in <code>treat_order</code> that
are absent from <code>dt</code>. Default is <code>TRUE</code>; <code>FALSE</code> will throw an error in
case there are missing variables.</dd></dl>

Arguments

Create a summary table using multiple rows for grouping on one target column — summary_table_by

<dl>

<dt>dt</dt>
<dd>A <code>data.frame</code> containing, at least, the variables indicated in
<code>target</code> and <code>treat</code>.</dd>


<dt>target</dt>
<dd>Target variable passed as a string for which summary
statistics are to be calculated.</dd>


<dt>treat</dt>
<dd>A string indicating the grouping variable, e.g. the variable
specifying the treatment population.</dd>


<dt>rows_by</dt>
<dd>string, grouping variable to split events by.</dd>


<dt>indent</dt>
<dd>A string to be used as indentation of summary statistics
labels. Defaults to four HTML non-breaking spaces (<code>&amp;nbsp;</code>).</dd>


<dt>.total_dt</dt>
<dd>Separate table from <code>dt</code> from which to derive total counts
per group.</dd>


<dt>pct_dec</dt>
<dd>Decimal places for reported figures.</dd>


<dt>treat_order</dt>
<dd>Customise the column order of the output table.</dd>


<dt>skip_absent</dt>
<dd>Whether to ignore variables passed in <code>treat_order</code> that
are absent from <code>dt</code>. Default is <code>TRUE</code>; <code>FALSE</code> will throw an error in
case there are missing variables.</dd>

</dl>

summary_table_by: Create a summary table using multiple rows for grouping on one target column

Description

Usage

Value

Arguments

Examples