gtsummary (version 1.6.3)

inline_text.tbl_survfit: Report statistics from survfit tables inline

Description

lifecycle::badge("maturing") Extracts and returns statistics from a tbl_survfit object for inline reporting in an R markdown document. Detailed examples in the inline_text vignette

Usage

# S3 method for tbl_survfit
inline_text(
  x,
  variable = NULL,
  level = NULL,
  pattern = NULL,
  time = NULL,
  prob = NULL,
  column = NULL,
  estimate_fun = x$inputs$estimate_fun,
  pvalue_fun = NULL,
  ...
)

Value

A string reporting results from a gtsummary table

Arguments

x

Object created from tbl_survfit

variable

Variable name of statistic to present.

level

Level of the variable to display for categorical variables. Can also specify the 'Unknown' row. Default is NULL

pattern

String indicating the statistics to return.

time

time for which to return survival probabilities.

prob

probability with values in (0,1)

column

column to print from x$table_body. Columns may be selected with time= or prob= as well.

estimate_fun

Function to round and format estimate and confidence limits. Default is the same function used in tbl_survfit()

pvalue_fun

Function to round and format p-values. Default is style_pvalue. The function must have a numeric vector input (the numeric, exact p-value), and return a string that is the rounded/formatted p-value (e.g. pvalue_fun = function(x) style_pvalue(x, digits = 2) or equivalently, purrr::partial(style_pvalue, digits = 2)).

...

Not used

Author

Daniel D. Sjoberg

See Also

Other tbl_summary tools: add_ci(), add_n.tbl_summary(), add_overall(), add_p.tbl_summary(), add_q(), add_stat_label(), bold_italicize_labels_levels, inline_text.tbl_summary(), modify, separate_p_footnotes(), tbl_custom_summary(), tbl_merge(), tbl_split(), tbl_stack(), tbl_strata(), tbl_summary()