Run stanc's auto-formatter on the model code. — model-method-format • cmdstanr
Description: The $format() method of a CmdStanModel object runs stanc's auto-formatter on the model code. Either saves the formatted model directly back to the file or prints it for inspection.

# Run stanc's auto-formatter on the model code.

Source: `R/model.R`
`model-method-format.Rd`

The `$format()` method of a `CmdStanModel` object runs stanc's auto-formatter on the model code. Either saves the formatted model directly back to the file or prints it for inspection.

    format(
      overwrite_file = FALSE,
      canonicalize = FALSE,
      backup = TRUE,
      max_line_length = NULL,
      quiet = FALSE
    )

## Arguments

overwrite_file

  (logical) Should the formatted code be written back to the input model file. The default is `FALSE`.

canonicalize

  (list or logical) Defines whether or not the compiler should 'canonicalize' the Stan model, removing things like deprecated syntax. Default is `FALSE`. If `TRUE`, all canonicalizations are run. You can also supply a list of strings which represent options. In that case the options are passed to stanc (new in Stan 2.29). See the User's guide section for available canonicalization options.

backup

  (logical) If `TRUE`, create stanfile.bak backups before writing to the file. Disable this option if you're sure you have other copies of the file or are using a version control system like Git. Defaults to `TRUE`. The value is ignored if `overwrite_file = FALSE`.

max_line_length

  (integer) The maximum length of a line when formatting. The default is `NULL`, which defers to the default line length of stanc.

quiet

  (logical) Should informational messages be suppressed? The default is `FALSE`.

## Value

The `$format()` method returns `TRUE` (invisibly) if the model is valid.

## See also

The CmdStanR website (mc-stan.org/cmdstanr) for online documentation and tutorials.

The Stan and CmdStan documentation:

- Stan documentation: mc-stan.org/users/documentation

- CmdStan User’s Guide: mc-stan.org/docs/cmdstan-guide

Other CmdStanModel methods: `model-method-check_syntax`, `model-method-compile`, `model-method-diagnose`, `model-method-expose_functions`, `model-method-generate-quantities`, `model-method-optimize`, `model-method-sample_mpi`, `model-method-sample`, `model-method-variables`, `model-method-variational`

## Examples

    # \dontrun{
    file <- write_stan_file("
    data {
      int N;
      int y[N];
    }
    parameters {
      real                     lambda;
    }
    model {
      target +=
     poisson_lpmf(y | lambda);
    }
    ")
    mod <- cmdstan_model(file, compile = FALSE)
    mod$format(canonicalize = TRUE)
    #> data {
    #>   int N;
    #>   array[N] int y;
    #> }
    #> parameters {
    #>   real lambda;
    #> }
    #> model {
    #>   target += poisson_lpmf(y | lambda);
    #> }
    #>
    #>
    # }