Skip to contents

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
)
} # }