build_trace_model: Build a Trace Model

In r4subtrace: Traceability Engine for Clinical Submission Readiness

Build a Trace Model

Description

Constructs a directed trace model (nodes + edges + diagnostics) from ADaM metadata, SDTM metadata, and an optional mapping sheet.

Usage

build_trace_model(
  adam_meta,
  sdtm_meta,
  mapping = NULL,
  spec = NULL,
  config = trace_config_default()
)

Arguments

adam_meta	A data.frame of ADaM variable metadata. Must contain dataset and variable columns.
sdtm_meta	A data.frame of SDTM variable metadata. Must contain dataset and variable columns.
mapping	An optional data.frame describing ADaM-to-SDTM mappings. Must contain adam_dataset, adam_var, sdtm_domain, sdtm_var.
spec	Reserved for future use (ADaM spec ingestion).
config	A trace_config object from trace_config_default().

Value

A list of class "trace_model" with elements:

• nodes: tibble of asset nodes (datasets and variables)

• edges: tibble of relationships between nodes

• diagnostics: list of tibbles (orphans, ambiguities, conflicts)

• config: the configuration used

Examples

adam_meta <- data.frame(
  dataset = "ADSL", variable = c("STUDYID", "USUBJID", "AGE"),
  label = c("Study ID", "Unique Subject ID", "Age")
)
sdtm_meta <- data.frame(
  dataset = "DM", variable = c("STUDYID", "USUBJID", "AGE"),
  label = c("Study ID", "Unique Subject ID", "Age")
)
map <- data.frame(
  adam_dataset = "ADSL", adam_var = c("STUDYID", "USUBJID", "AGE"),
  sdtm_domain = "DM",   sdtm_var = c("STUDYID", "USUBJID", "AGE")
)
tm <- build_trace_model(adam_meta, sdtm_meta, mapping = map)
tm$nodes
tm$edges

r4subtrace documentation built on March 4, 2026, 1:07 a.m.