Skip to contents

Run a single DGP/estimator combination for one seed

Usage

cs_run_single(
  dgp_id,
  estimator_id,
  n,
  seed,
  version = NULL,
  status = "stable",
  quiet = FALSE,
  tau = cs_tau_oracle,
  bootstrap = FALSE,
  B = 0L,
  config = list(),
  board = NULL,
  max_runtime = Inf,
  ...
)

Arguments

dgp_id

Character scalar, identifier of the DGP (e.g., "synth_baseline").

estimator_id

Character scalar, identifier of the estimator (e.g., "lm_att").

n

Integer sample size for the run.

seed

Integer seed for reproducibility.

version

Optional character version string for the DGP. Defaults to latest stable via registry.

status

Optional status filter for DGP lookup ("stable", "experimental", "deprecated", "invalidated").

quiet

Logical; if TRUE, suppress warnings from DGP lookup (use with care—defaults to FALSE to honor loud-warning protocol).

tau

Numeric vector of quantile levels used by QST-capable estimators. Defaults to cs_tau_oracle.

bootstrap

Logical; runner-level convenience flag. When TRUE and config$ci_method is missing, the runner sets it to "bootstrap" and also injects config$seed from seed (see cs_ci_methods).

B

Integer; convenience alias for config$n_boot when bootstrap=TRUE. Only used if config$n_boot is missing.

config

List of estimator configuration options. Common fields include ci_method, n_boot, and estimator-specific hyperparameters. See cs_ci_methods for CI semantics.

board

Optional pins board. If provided, the completed structured result is persisted before it is returned.

max_runtime

Numeric scalar; maximum allowed runtime (seconds) for the estimator call. Defaults to Inf.

...

Additional arguments forwarded to the estimator generator.

Value

A structured result list with outputs, canonical typed scores, compatibility projections att and qst, optional boot_draws, and separate meta and provenance components.