Validate a Frame Against a Design

Checks if a data frame contains all required variables for a sampling design and reports any issues.

validate_frame(design, frame, stage = NULL)

Arguments

design

A sampling_design object

frame

A data frame to validate

stage

Which stage(s) to validate against. Default validates all stages.

Value

Invisibly returns TRUE if validation passes. Throws an informative error if validation fails.

Details

Validation checks include:

• Presence of required stratification variables

• Presence of required clustering variables

• Presence of measure of size (MOS) variables for PPS sampling

• Non-empty frame

• Positive values for MOS variables

Examples

design <- sampling_design() |>
  stratify_by(region) |>
  draw(n = 100)

# This will pass
frame <- data.frame(id = 1:1000, region = sample(c("A", "B"), 1000, TRUE))
validate_frame(design, frame)

# This will fail (missing region)
# bad_frame <- data.frame(id = 1:1000)
# validate_frame(design, bad_frame)