Skip to contents

Generates a summary of form completion status across events for longitudinal REDCap projects. Shows how many participants have completed each form at each event, useful for tracking study progress and identifying completion gaps.

Usage

get_event_completion_summary(
  project,
  forms = NULL,
  events = NULL,
  format = c("wide", "long"),
  datatable = FALSE
)

Arguments

project

A redcap_project object

forms

Character vector of form names to include. If NULL, includes all forms (default: NULL)

events

Character vector of event names to include. If NULL, includes all events (default: NULL)

format

Character. Output format: "wide" (default) or "long"

datatable

Logical. If TRUE, returns a datatable output (default: FALSE)

Value

A data frame with completion counts by event and form

Examples

if (FALSE) { # \dontrun{
project <- redcap_project()

# Get completion summary for all events and forms
completion <- get_event_completion_summary(project)

# Specific forms
completion <- get_event_completion_summary(
  project,
  forms = c("demographics", "baseline_survey", "follow_up")
)
} # }