Skip to content

Latest commit

 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SurvScope

CI Open the app

Explore how a gene's RNA expression relates to survival in a cancer cohort, then edit and download the figure. SurvScope works in your browser, without an account or installation.

Open SurvScope → · Step-by-step guide · Statistical methods

SurvScope showing a survival comparison and the available expression groups

Make your first figure

  1. Choose a cancer cohort and enter a gene symbol, such as SRD5A1 or TP53.
  2. Choose how to compare lower and higher expression. Start with the median, or try a percentile, the lowest/highest quarters or thirds, custom extreme groups, the mean, or a TPM threshold. Check the patient counts before running.
  3. Select Create survival plot. Each panel shows a different outcome, when available.
  4. Select Edit figure to change labels, colors, fonts, dimensions, axes, panel layout, and annotations. Click and drag items directly on the figure. Optional confidence bands, censor marks, and number-at-risk tables add context.
  5. Download SVG, PDF, or PNG. Save project lets you reopen the results and keep editing; a style preset reuses the appearance for another analysis.

The original blue/red, four-panel, 6.8-inch figure remains the default. Editing the figure's appearance does not change the calculated results.

Which cancers and data are available?

The current release includes all 33 TCGA cohorts and 18 CPTAC-3 tumor groups, covering 59,317 uniquely mapped gene symbols. TCGA and CPTAC appear separately in the cohort menu, with patient counts; pancreatic cancer is one of many choices. Availability varies by gene and outcome.

TCGA provides overall survival (OS), disease-specific survival (DSS), progression-free interval (PFI), and disease-free interval (DFI), where the source supports them. CPTAC currently provides RNA expression and OS. Protein abundance and CPTAC-2 survival are not included. Some rare CPTAC groups have only one or two patients and cannot support an estimable comparison. See the coverage table and sources.

Read the results carefully

A curve estimates the fraction of patients who remain event-free over time. The legend gives patients (n) and events (e) in each group. The p-value compares the curves; the hazard ratio compares higher with lower expression. These are unadjusted associations, not proof that a gene causes a difference or predicts an individual's outcome.

Comparing expression extremes leaves out the middle patients and can increase uncertainty. Trying several genes or group definitions adds multiple comparisons; the displayed q-value adjusts only for the available outcomes within one analysis. Choose comparisons for a scientific reason and report what you explored. Learn to read the plot.

JavaScript calculations are checked against Python and independently executed R survival. Group membership, event counts, and risk counts agree exactly in the validation suite. Numerical tolerances and the preserved PAAD reference estimates are documented in methods and validation.

Use Python or the command line

Install the tested GitHub release:

python -m pip install \
  https://github.com/oncologylab/survscope/releases/download/v0.3.0/survscope-0.3.0-py3-none-any.whl
survscope plot --gene SRD5A1 --cohort PAAD --format pdf svg png --outdir plots
survscope plot --gene TP53 --cohort CPTAC-3-LUAD \
  --grouping extremes --lower-percent 25 --upper-percent 25 --json --outdir plots
import survscope
from survscope import GroupingSpec

result = survscope.analyze(
    "SRD5A1", "PAAD",
    grouping=GroupingSpec("extremes", lower_percent=25, upper_percent=25),
)
survscope.plot(result, formats=("pdf", "svg"), output_dir="plots")

The Python package shares the comparison methods and the default figure. The interactive editor and its project files are browser features. PyPI publication awaits its one-time Trusted Publisher setup; use the GitHub wheel meanwhile.

Reproducibility and further reading

The website displays its data version. Data releases are immutable; saved projects record both data and software versions. Browser calculations use static assets served with the site, with no external data-service requests or telemetry. Published assets contain no patient identifiers or raw expression matrices.

For scientific use, cite Liu et al., TCGA-CDR, Cell (2018), the GDC expression pipeline, and the source project for your cohort. SurvScope is research software, not a diagnostic or clinical decision-making tool.

Source code uses the MIT License. Bundled fonts and numerical code retain their third-party notices; data retain their original terms and citations.

About

Static, reproducible TCGA Kaplan-Meier survival plots with compact plot-only data

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages