tooth (version 0.5.0)

summarise_dmft: Summarise DMFT results by group

Description

Takes the output of calc_dmft() and produces a summary table with n, mean number of teeth, mean DT, mean DMFT, and optionally other columns — ready to pass directly to build_odontogram() via stats and stats_raw.

Usage

summarise_dmft(dmft_data, group_col, digits = 1)

Value

A list with two elements:

stats

Summary data frame with one row per group, containing n, mean_teeth, mean_DT, mean_DMFT. Column names match what build_odontogram() expects for stats.

raw

The input data frame, for passing to stats_raw in build_odontogram().

Arguments

dmft_data

Data frame returned by calc_dmft(), optionally merged with grouping variables (e.g. treatment arm, visit frequency).

group_col

Column name to summarise by (e.g. "treatment").

digits

Number of decimal places for means (default 1).

Examples

data(sim_exam)
dmft <- calc_dmft(sim_exam)
dmft$treatment <- ifelse(
  as.numeric(gsub("P", "", dmft$record_id)) <= 10, "SDF", "ART"
)
result <- summarise_dmft(dmft, "treatment")
result$stats
# Pass directly to build_odontogram:
# build_odontogram(d, strata = "treatment",
#   stats = result$stats, stats_raw = result$raw,
#   stats_test = "wilcox", stats_var = "DMFT")