JAGS formula name map and fitted-object contract

JAGS_formula_name_map() returns the persisted mapping between opaque JAGS base names and semantic formula coordinates (kind, formula parameter, term and role), with an injective encoded identifier of those fields. The identifier does not replace the backend column name stored in a fit. Downstream code should use this map or parameter_coordinates() rather than parsing a JAGS name.

JAGS_fit_contract() returns the schema contract attached to a fit. JAGS_validate_fit_contract() checks the components named in requires and requires unsupported objects to be refitted rather than adapted.

Every error that asks to refit the model has class BayesTools_refit_required: these validators, and every function that reads fitted metadata, stop with it on a fit (or stored metadata or draw geometry) created by another version of BayesTools, such as BayesTools 0.3.0, or lacking fitted metadata the request requires. A fit whose posterior samples lack coordinates the request needs because of its monitoring or sampling settings (a quantity whose source coordinates were not monitored in parameter_draws(), random effects without random_monitor(latent = TRUE) or random_monitor(coefficients = TRUE) in JAGS_evaluate_formula() and JAGS_bridgesampling(), or a marginalized random-effect block) stops with the child class BayesTools_refit_monitoring (also BayesTools_refit_required): refitting with this version alone does not resolve it, and the message names the settings to refit with. Callers match these classes, never the message.

JAGS_formula_name_map(fit, parameter = NULL)

JAGS_fit_contract(fit)

JAGS_validate_fit_contract(fit, requires = character())

JAGS_fit_contract_schema()

Arguments

fit

fitted object created by JAGS_fit().

parameter

optional formula parameter selecting one name map.

requires

character vector naming required contract components.

Value

JAGS_fit_contract_schema() returns a data frame. JAGS_formula_name_map() returns a BayesTools_formula_name_map data frame (or a named list of them). JAGS_fit_contract() returns a named list, and the validator returns it invisibly.