Author: Robin Denz
contsurvplot is an R-Package which can be used to visualize the causal effect of a continuous variable on a time-to-event outcome. It includes multiple different plot types, such as survival area plots, contour plots, heatmaps, survival quantile plots and more. All of them can be adjusted for confounders and all of them have a lot of build in options to customize them according to the users needs. Also, most of the plot functions are based on the
ggplot2 package, allowing the user to use the standard
ggplot2 syntax to customize the plots further.
The stable release version can be installed directly from CRAN using:
Alternatively, the development version can be installed using the
Bug Reports and Feature Requests
If you encounter any bugs or have any specific feature requests, please file an Issue.
Here are two quick examples using the
colon dataset from the
survival R-Package. Suppose we want to visualize the effect of the number of lymph nodes with detectable cancer (column
nodes) on the survival time. A survival area plot can be produced using the following code:
library(contsurvplot) library(ggplot2) library(survival) library(riskRegression) # load colon data data(cancer) # fit cox model, adjusting for age and sex model <- coxph(Surv(time, status) ~ age + sex + nodes, data=colon, x=TRUE) # plot survival area plot_surv_area(time="time", status="status", variable="nodes", data=colon, model=model)
Alternatively, we can plot a contour plot to visualize the effect:
plot_surv_contour(time="time", status="status", variable="nodes", data=colon, model=model)
Or we can use a simple plot of the median survival time as a function of
plot_surv_quantiles(time="time", status="status", variable="nodes", data=colon, model=model, p=0.5)
More examples can be found in the documentation and the vignette.
The main paper associated with this R-Package is:
Robin Denz, Nina Timmesfeld (2022). Visualizing the Causal Effect of a Continuous Variable on a Time-To-Event Outcome. arXiv:2208.04644v1
In addition, some relevant literature can be found in the documentation pages.
© 2022 Robin Denz
The contents of this repository are distributed under the GNU General Public License. You can find the full text of this License in this github repository. Alternatively, see http://www.gnu.org/licenses/.