The revolver package implements the statistical model described in Caravagna et al; PMID: 30171232 to determine trajectories of repeated evolution from multi-region sequencing data of human cancers.

The package implements functions to process data from large cohorts, and determine different types of phylogenetic trees from the input data of each sequenced patients. The package provides also several functions to plot the data, and determine clusters of tumours that share repeated trajectories; this provides a method to stratify cancer patients for the way their tumour evolve, reconciling tumour heterogeneity both between and within patients.

revolver is part of the evoverse, a package that gathers multiple R packages to implement Cancer Evolution analyses; see more about evoverse.


If you use revolver, please cite:

  • G. Caravagna, Y. Giarratano, D. Ramazzoti, I. Tomlinson, T.A. Graham, G. Sanguinetti, A. Sottoriva. Detecting repeated cancer evolution from multi-region tumor sequencing data. Nature Methods 15, 707–714 (2018).

Help and support


You can install the released version of revolver from GitHub with:

New version. v0.3 is a fresh implementation of revolver that follows the tidy paradigm. The new implementation provides a clean interface to query and plot data; the previous package version is mirrored, but no longer maintained.