Standardise Measure Entries in Database — boilerplate_standardise

This function standardises measure entries by extracting scale information, identifying reversed items, cleaning descriptions, and ensuring consistent structure.

Usage

boilerplate_standardise_measures(
  db,
  measure_names = NULL,
  extract_scale = TRUE,
  identify_reversed = TRUE,
  clean_descriptions = TRUE,
  ensure_structure = TRUE,
  standardise_references = TRUE,
  verbose = FALSE,
  quiet = FALSE
)

Arguments

db: List. Either a single measure or a measures database to standardise.
measure_names: Character vector. Specific measures to standardise. If NULL, processes all.
extract_scale: Logical. Extract scale information from descriptions. Default is TRUE.
identify_reversed: Logical. Identify reversed items. Default is TRUE.
clean_descriptions: Logical. Clean up description text. Default is TRUE.
ensure_structure: Logical. Ensure all measures have standard fields. Default is TRUE.
standardise_references: Logical. Standardise reference format. Default is TRUE.
verbose: Logical. Show detailed progress information. Default is FALSE.
quiet: Logical. Suppress all messages. Default is FALSE.

Value

List. The standardised measure(s) or database.

Examples

if (FALSE) { # \dontrun{
# Standardise all measures in database
unified_db$measures <- boilerplate_standardise_measures(unified_db$measures)

# Standardise specific measures only
unified_db$measures <- boilerplate_standardise_measures(
  unified_db$measures,
  measure_names = c("sdo", "rwa", "self_control")
)

# Standardise a single measure
unified_db$measures$sdo <- boilerplate_standardise_measures(
  unified_db$measures$sdo
)
} # }