create_gazepoint_nested_folds: Create nested grouped resampling from mature outer folds

In gp3ml: Governance-First Predictive Modelling for 'Gazepoint' Research

Create nested grouped resampling from mature outer folds

Description

Inner folds are constructed only from each outer analysis partition and preserve the declared participant/stimulus generalization target. The outer assessment partition is never used for inner preprocessing or tuning.

Usage

create_gazepoint_nested_folds(
  outer_folds,
  inner_v = 3L,
  inner_repeats = 1L,
  seed = 1L,
  continue_on_error = FALSE
)

## S3 method for class 'gp3ml_nested_folds'
print(x, ...)

Arguments

outer_folds	A validated gazepoint_group_folds object.
inner_v	Number of inner folds.
inner_repeats	Number of inner repeats.
seed	Base deterministic seed.
continue_on_error	Whether infeasible outer folds are retained as failures instead of stopping immediately.
x	An object returned by the corresponding gp3ml constructor, evaluator, summarizer, or validator.
...	Additional arguments passed to the print method.

Value

A gp3ml_nested_folds object.

Examples

data <- simulate_gazepoint_governed_data(16L, 4L, 1L, 303L)
predictors <- c("tracking_ratio", "blink_rate", "gaze_dispersion")
manifest <- create_gazepoint_synthetic_manifest("quality_status", predictors)
outer <- create_gazepoint_group_folds(
  data, "quality_status", predictors, manifest,
  "new_participants", "participant_id", "trial_id", "stimulus_id",
  v = 4L, repeats = 1L, seed = 303L
)
nested <- create_gazepoint_nested_folds(
  outer,
  inner_v = 3L,
  inner_repeats = 1L,
  seed = 303L
)
nested

gp3ml documentation built on Aug. 23, 2026, 5:11 p.m.