Learn R Programming

⚠️There's a newer version (0.4.9) of this package.Take me there.

survminer: Survival Analysis and Visualization

The survminer R package provides functions for facilitating survival analysis and visualization. The current version contains three main functions including:

  • ggsurvplot(): Draws survival curves with the 'number at risk' table.

  • ggcoxzph(): Graphical test of proportional hazards.

  • ggcoxfunctional(): Displays graphs of continuous explanatory variable against martingale residuals of null cox proportional hazards model. It helps to properly choose the functional form of continuous variable in cox model.

Find out more at http://www.sthda.com/english/rpkgs/survminer/, and check out the documentation and usage examples of each of the functions in survminer package.

Installation and loading

Install from CRAN as follow:

install.packages("survminer")

Or, install the latest version from GitHub:

# Install
if(!require(devtools)) install.packages("devtools")
devtools::install_github("kassambara/survminer")

Load survminer:

library("survminer")
# Loading required package: ggplot2

ggsurvplot: Drawing survival curves

  1. Fitting survival curves
require("survival")
# Loading required package: survival
fit <- survfit(Surv(time, status) ~ sex, data = lung)
  1. Basic plots
ggsurvplot(fit)

  1. Customized survival curves
ggsurvplot(fit,  size = 1,  # change line size
           palette = c("#E7B800", "#2E9FDF"), # custom color palettes
           conf.int = TRUE, # Add confidence interval
           pval = TRUE, # Add p-value
           risk.table = TRUE, # Add risk table
           risk.table.col = "strata", # Risk table color by groups
           legend.labs = c("Male", "Female"), # Change legend labels
           risk.table.height = 0.25, # Useful to change when you have multiple groups
           ggtheme = theme_bw() # Change ggplot2 theme
           )

Note that, additional arguments are available to customize the main title, axis labels, the font style, axis limits, legends and the number at risk table. Read more: http://www.sthda.com/english/wiki/survminer.

Copy Link

Version

Install

install.packages('survminer')

Monthly Downloads

44,165

Version

0.2.1

License

GPL-2

Maintainer

Alboukadel Kassambara

Last Published

April 23rd, 2016

Functions in survminer (0.2.1)

theme_classic2

ggplot2 classic theme with axis lines
ggcoxzph

Graphical Test of Proportional Hazards using ggplot2
ggsurvplot

Drawing survival curves using ggplot2
ggcoxfunctional

Functional Form of Continuous Variable in Cox Proportional Hazards Model