Quickly plot state probabilities stored in a `stateprobs`

object.

```
# S3 method for stateprobs
autoplot(
object,
labels = NULL,
ci = FALSE,
prob = 0.95,
ci_style = c("ribbon", "line"),
geom_alpha = 0.3,
...
)
```

## Arguments

- object
A `stateprobs`

object.

- labels
A list of named vectors containing the values and labels of
variables. The elements of each vector are the values of a variable and the
names are the labels. The names of the list are the names of the variables.
See the output returned by `get_labels()`

for an example.

- ci
A logical value indicating whether confidence intervals should be
plotted. Default is `FALSE`

.

- prob
A numeric scalar in the interval `(0,1)`

giving the confidence interval.
Default is 0.95 for a 95 percent interval.

- ci_style
Style to use for the confidence interval if `ci = TRUE`

. If
`"line"`

, then dashed lines are used; if `"ribbon"`

, then shaded confidence
bands are plotted using `ggplot2::geom_ribbon()`

.

- geom_alpha
The opacity for the shaded confidence bands when
`ci_style = "ribbon"`

. This is the value of the value of the `alpha`

aesthetic
passed to `ggplot2::geom_ribbon()`

.

- ...
Further arguments passed to and from methods. Currently unused.

## Note

If there are multiple patients/groups, then state probabilities are
averaged across patients/groups (using the weights in `patient_wt`

if available)
prior to plotting.