The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.

flexstanr

A portable Stan-backend layer for R packages that fit a Stan model. It gives a host package one interface for fitting through either rstan or (optionally) cmdstanr, so the same code works whichever backend is installed.

flexstanr compiles no Stan of its own: the host package supplies its own compiled models, and flexstanr resolves them from the calling package at run time.

What it provides

• stan_options() collects and validates sampler arguments for the chosen backend, forwarding them verbatim so calls feel native. Mixing one backend’s argument vocabulary into the other errors with a “did you mean” hint.
• fit_model() dispatches the fit to the backend recorded on the options, resolving the compiled model by name from the calling package.
• The fit-consumption accessors read a fit backend-agnostically: backend_draws_array(), backend_extract(), backend_generate_quantities(), and backend_has_draws().

Installation

flexstanr is not yet on CRAN. Install the development version from GitHub:

# install.packages("remotes")
remotes::install_github("ACCIDDA/flexstanr")

The default backend, rstan, is a hard dependency. cmdstanr is an optional backend; it is not on CRAN, so a project that wants it installs it separately (see the cmdstanr getting-started guide).

Using it in your package

Declare flexstanr as a dependency and call it from your own fitting code:

# in your package
opts <- flexstanr::stan_options(chains = 4, iter = 2000, seed = 1)
fit  <- flexstanr::fit_model(
  "coverage",              # resolved from your package's stanmodels / inst/stan
  dat_stan  = data_list,
  init      = init_list,
  stan_opts = opts
)
draws <- flexstanr::backend_draws_array(fit)

The model name is resolved against your package’s own compiled models (stanmodels for rstan, inst/stan/<name>.stan for cmdstanr); the calling package is detected automatically. Run flexstanr::use_flexstanr() once from your package root to wire the dependencies into its DESCRIPTION.

Note. flexstanr began as a use_standalone() script vendored into the ACCIDDA Stan packages (imuGAP, hestia, SeverityEstimate). It is now a proper package those consumers import rather than copy. See the flexstanr 0.1.0 CRAN release milestone.

License

MIT (c) ACCIDDA.

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.