Skip to content

sbalci/jsurvival

Repository files navigation

jsurvival

R-CMD-check pkgdown Lifecycle: stable jamovi ClinicoPath

Abstract

jsurvival is a comprehensive survival analysis module for jamovi that bridges the gap between advanced statistical methods and clinical research accessibility. As part of the ClinicoPath statistical suite, it transforms complex survival analyses into intuitive, publication-ready outputs with natural language interpretations. The module implements state-of-the-art survival analysis techniques including Kaplan-Meier estimation, Cox proportional hazards regression, and time-dependent analyses, while maintaining a user-friendly interface designed for medical researchers. By automating person-time calculations, providing automated statistical summaries in plain language, and generating high-quality visualizations, jsurvival enables clinicians and researchers to conduct sophisticated survival analyses without extensive programming knowledge, ultimately accelerating the translation of clinical data into actionable insights.

🎯 Key Features

Core Survival Analysis Capabilities

  • Kaplan-Meier Analysis: Generate survival curves with confidence intervals, risk tables, and median survival times
  • Cox Proportional Hazards Models: Both univariate and multivariable regression with hazard ratios and forest plots
  • Person-Time Calculations: Automated computation of person-years at risk with incidence rate calculations
  • Cut-point Analysis: Optimal threshold determination for continuous biomarkers using multiple methods
  • Time-Dependent Analyses: Support for time-varying covariates and landmark analysis
  • Competing Risks: Handle multiple event types with cause-specific hazard functions

Clinical Research Features

  • Natural Language Summaries: Automated generation of plain-English interpretations of results
  • Clinical Trial Metrics: 1-, 3-, and 5-year survival rates with confidence intervals
  • Stage Migration Analysis: Evaluate the Will Rogers phenomenon in cancer staging
  • Treatment Pathway Visualization: Alluvial plots for treatment sequences over time
  • Subgroup Forest Plots: Systematic evaluation of treatment effects across patient subgroups

Advanced Statistical Methods

  • Restricted Mean Survival Time (RMST): Alternative to median survival for skewed distributions
  • Time-Dependent ROC Curves: Evaluate biomarker performance over time
  • LASSO-Cox Regression: Variable selection for high-dimensional survival data
  • Integrated Discrimination Improvement (IDI): Compare predictive models
  • Schoenfeld Residual Diagnostics: Test proportional hazards assumptions

User Experience Enhancements

  • Intuitive GUI: Point-and-click interface within jamovi, no coding required
  • Smart Defaults: Evidence-based default settings for common analyses
  • Educational Tooltips: Context-sensitive help explaining statistical concepts
  • Export Options: Publication-ready tables and figures in multiple formats
  • Reproducible Reports: Generate complete analysis reports with code

πŸ“Š Available Analysis Modules

Module Description Key Features
Single Arm Survival Analyze survival in a single cohort Overall survival rates, median survival, person-time calculations
Survival Analysis Compare survival between groups Log-rank test, Cox regression, stratified analysis
Continuous Survival Analyze continuous predictors Optimal cut-point detection, tertile/quartile analysis
Multivariable Survival Adjust for multiple factors Stepwise selection, interaction terms, adjusted curves
Odds Ratio Analysis Binary outcome analysis 2x2 tables, forest plots, Mantel-Haenszel methods
Time Interval Calculator Data preparation utility Calculate follow-up times, handle date formats
Stage Migration Will Rogers phenomenon Stage-specific survival, migration matrices
Competing Risks Multiple event types Cumulative incidence functions, Fine-Gray models

πŸš€ Installation

In jamovi (Recommended)

  1. Open jamovi
  2. Click the + button β†’ jamovi library
  3. Search for "ClinicoPath" or "jsurvival"
  4. Click Install

As R Package

# Install from GitHub
devtools::install_github("sbalci/jsurvival")

# Load the package
library(jsurvival)

System Requirements

  • jamovi β‰₯ 1.8.1
  • R β‰₯ 4.1.0
  • Dependencies: survival, survminer, finalfit, ggplot2, dplyr

πŸ“– Documentation

πŸ’‘ Quick Example

In jamovi:

  1. Load your survival data
  2. Navigate to Survival β†’ ClinicoPath Survival β†’ Survival Analysis
  3. Set variables:
    • Time Elapsed: Time to event variable
    • Outcome: Event indicator (0/1)
    • Explanatory: Grouping variable
  4. Click Run

In R:

# Load example data
data("melanoma", package = "jsurvival")

# Run survival analysis
result <- jsurvival::survival(
    data = melanoma,
    elapsedtime = "time",
    outcome = "status", 
    explanatory = "sex"
)

# View results
result$run()

πŸ“ Citation

If you use jsurvival in your research, please cite:

Balci, S. (2025). jsurvival: Survival Module of ClinicoPath for jamovi. 
R package version 0.0.3.90. https://github.com/sbalci/jsurvival

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

πŸ“„ License

This project is licensed under the GPL (β‰₯ 2) License - see the LICENSE.md file for details.

πŸ’¬ Support

πŸ™ Acknowledgments

This project builds upon the excellent work of the R survival analysis community, particularly the authors of the survival, survminer, and finalfit packages. Special thanks to the jamovi team for creating an accessible statistical platform.


Part of the ClinicoPath suite of statistical modules for biomedical research.

About

survival functions in ClinicoPath jamovi module

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published

Contributors 2

  •  
  •  

Languages