tulpa_check_control: Validate a 'control = list()' surface against its canonical...

In tulpa: Templated Unified Library for Posterior Approximation in Bayesian Hierarchical Models

Validate a control = list() surface against its canonical key set

Description

Front-door fitters across the ⁠tulpa*⁠ ecosystem carry their perf / numerical / tuning knobs in a single control list (design principle 6). Without a name check a misspelled knob is a silent no-op – control$adaptve_grid fits the default and reports nothing. This validates the names a caller supplied against the whitelist of what the target fitter actually reads, and errors listing the allowed set.

Usage

tulpa_check_control(control, allowed, where)

Arguments

control	The control list to validate. NULL and empty lists pass.
allowed	Character vector of accepted knob names.
where	Name of the calling fitter, used in the error message.

Details

Consumer packages (tulpaRatio, tulpaObs) call this with their own key registry rather than reimplementing the check.

Value

invisible(NULL), called for the side effect of erroring on an unknown or unnamed knob.

Examples

tulpa_check_control(list(max_iter = 50), c("max_iter", "tol"), "my_fit")
try(tulpa_check_control(list(max_itr = 50), c("max_iter", "tol"), "my_fit"))

tulpa documentation built on Oct. 19, 2026, 5:09 p.m.