R Graphical Manual

Browse All

Last data update: 2014.03.03

R: Functional Form of Continuous Variable in Cox Proportional...

ggcoxfunctional

R Documentation

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())

## S3 method for class 'ggcoxfunctional'
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.

Author(s)

Marcin Kosinski , m.p.kosinski@gmail.com

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)