survminer (version 0.2.1)

ggcoxfunctional: Functional Form of Continuous Variable in Cox Proportional Hazards Model

Description

Displays graphs of continuous explanatory variable against martingale residuals of null cox proportional hazards model, for each term in of the right side of formula. This might help to properly choose the functional form of continuous variable in cox model (coxph). Fitted lines with lowess function should be linear to satisfy cox proportional hazards model assumptions.

Usage

ggcoxfunctional(formula, data, iter = 0, f = 0.6, point.col = "red", point.size = 1, point.shape = 19, point.alpha = 1, font.main = c(16, "plain", "black"), font.x = c(14, "plain", "black"), font.y = c(14, "plain", "black"), font.tickslab = c(12, "plain", "black"), xlim = NULL, ylim = NULL, ylab = "Martingale Residuals \nof Null Cox Model", ggtheme = theme_classic2())
"print"(x, ...)

Arguments

formula

a formula object, with the response on the left of a ~ operator, and the terms on the right. The response must be a survival object as returned by the Surv function.

data

a data.frame in which to interpret the variables named in the formula,

iter

parameter of lowess.

f

parameter of lowess.

point.col, point.size, point.shape, point.alpha

color, size, shape and visibility to be used for points.

font.main, font.x, font.y, font.tickslab

a vector of length 3 indicating respectively the size (e.g.: 14), the style (e.g.: "plain", "bold", "italic", "bold.italic") and the color (e.g.: "red") of main title, xlab and ylab and axis tick labels, respectively. For example font.x = c(14, "bold", "red"). Use font.x = 14, to change only font size; or use font.x = "bold", to change only font face.

xlim, ylim

x and y axis limits e.g. xlim = c(0, 1000), ylim = c(0, 1).

ylab

y axis label.

ggtheme

function, ggplot2 theme name. Default value is survminer::theme_classic2(). Allowed values include ggplot2 official themes: theme_gray(), theme_bw(), theme_minimal(), theme_classic(), theme_void(), ....

x

an object of class ggcoxfunctional

...

further arguments passed to print, but really it's unused

Value

Returns an object of class ggcoxfunctional which is a list of ggplots.

Functions

• ggcoxfunctional: Functional Form of Continuous Variable in Cox Proportional Hazards Model.

Examples

library(survival)
data(mgus)
ggcoxfunctional(Surv(futime, death) ~ mspike + log(mspike) + I(mspike^2) +
                  age + I(log(age)^2) + I(sqrt(age)), data = mgus,
                point.col = "blue", point.alpha = 0.5)