modify_fmt_fun {gtsummary} | R Documentation |
Modify Formatting Functions
Description
Use this function to update the way numeric columns and rows of .$table_body
are formatted
Usage
modify_fmt_fun(x, update, rows = NULL)
Arguments
x |
gtsummary object |
update |
list of formulas or a single formula specifying the updated formatting function. The LHS specifies the column(s) to be updated, and the RHS is the updated formatting function. |
rows |
predicate expression to select rows in |
Example Output
Example 1
rows argument
The rows argument accepts a predicate expression that is used to specify
rows to apply formatting. The expression must evaluate to a logical when
evaluated in x$table_body
. For example, to apply formatting to the age rows
pass rows = variable == "age"
. A vector of row numbers is NOT acceptable.
A couple of things to note when using the rows=
argument.
You can use saved objects to create the predicate argument, e.g.
rows = variable == letters[1]
.The saved object cannot share a name with a column in
x$table_body
. The reason for this is that intbl_merge()
the columns are renamed, and the renaming process cannot disambiguate thevariable
column from an external object namedvariable
in the following expressionrows = .data$variable = .env$variable
.
See Also
Review list, formula, and selector syntax used throughout gtsummary
Other Advanced modifiers:
modify_column_alignment()
,
modify_column_hide()
,
modify_column_indent()
,
modify_column_merge()
,
modify_table_body()
,
modify_table_styling()
Examples
# Example 1 ----------------------------------
# show 'grade' p-values to 3 decimal places
modify_fmt_fun_ex1 <-
lm(age ~ marker + grade, trial) %>%
tbl_regression() %>%
modify_fmt_fun(
update = p.value ~ function(x) style_pvalue(x, digits = 3),
rows = variable == "grade"
)