Summarize a `ce`

object by producing confidence intervals for quality-adjusted
life-years (QALYs) and each cost category with `summary.ce()`

and format for
pretty printing with `format.summary.ce()`

.

```
# S3 method for ce
summary(object, prob = 0.95, labels = NULL, ...)
# S3 method for summary.ce
format(
x,
digits_qalys = 2,
digits_costs = 0,
dr_qalys = NULL,
dr_costs = NULL,
pivot_from = "strategy",
drop_grp = TRUE,
pretty_names = TRUE,
...
)
```

## Arguments

- object
A `ce`

object.

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

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

- 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.

- ...
Further arguments passed to or from other methods. Currently unused.

- x
A `summary.ce`

object.

- digits_qalys
Number of digits to use to report QALYs.

- digits_costs
Number of digits to use to report costs.

- dr_qalys
Discount rate to subset to for quality-adjusted life-years (QALYs).

- dr_costs
Discount rate to subset to for costs.

- pivot_from
Character vector denoting a column or columns used to
"widen" the data. Should either be `"strategy"`

, `"grp"`

, `"outcome"`

,
or some combination of the three. There will be one column for each value of
the variables in `pivot_from`

. Default is to widen so there is a column for each treatment
strategy. Set to `NULL`

if you do not want to widen the table.

- drop_grp
If `TRUE`

, then the group column will be removed if there is only
one subgroup; other it will be kept. If `FALSE`

, then the `grp`

column is never
removed.

- pretty_names
Logical. If `TRUE`

, then the columns `strategy`

, `grp`

,
`outcome`

, `dr`

, and `value`

are renamed (if they exist) to `Strategy`

, `Group`

,
`Outcome`

, `Discount rate`

, and `Value`

.

## Value

`summary.ce()`

returns an object of class `summary.ce`

that is a tidy
`data.table`

with the following columns:

- dr
The discount rate.

- strategy
The treatment strategy.

- grp
The patient subgroup.

- type
Either `"QALYs"`

or `"Costs"`

.

- category
Category is always `"QALYs"`

when `type == "QALYs"`

; otherwise,
it is the cost category.

- estimate
The point estimate computed as the average across the PSA samples.

- lower
The lower limit of the confidence interval.

- upper
The upper limit of the confidence interval.

`format.summary.ce()`

formats the table according to the arguments passed.