DET_index: Compute the index of Divergent Evolutionary Trajectories.

In caravagn/revolver: REVOLVER - Repeated Evolution in Cancer

Compute the index of Divergent Evolutionary Trajectories.

Description

The index of Divergent Evolutionary Trajectories is a measure derived from Shannon's entropy to determine, for any driver event X, how heterogeneous are the trajectories that lead to X.

This is simply based on counting the number of edges Y -> X, for every Y in the data, and using the distribution of the observed frequencies to determine an entropy-derived measure (analog to species heterogeneity). This means that for values larger than 0, the model observers heterogeneous trajectories in the data.

To compute the DET the cohort must have fits available.

Usage

DET_index(x, drivers = x$variantIDs.driver, min.occurrences = 0)

Arguments

x	A REVOLVER cohort object with fits available.
drivers	The list of drivers to compute the DET for.
min.occurrences	The minimum number of occurrences for a trajectory to be considered, zero by default.

Value

The DET index for the input cohort.

See Also

Function plot_penalty plots another measure derived from the same information used to compute the DET.

Other Summary statistics: Stats_cohort(), Stats_drivers(), Stats_fits(), Stats_trees(), Stats()

Examples

# Data released in the 'evoverse.datasets'
data('TRACERx_NEJM_2017_REVOLVER', package = 'evoverse.datasets')
 
# Get the DET with all cohort
DET_index(TRACERx_NEJM_2017_REVOLVER)

# Look specifically for TP53 - the DET suggests
# heterogeneous trajectories.
DET_index(TRACERx_NEJM_2017_REVOLVER, drivers = 'TP53')

# Look specifically for drivers in at least 5 patients
DET_index(TRACERx_NEJM_2017_REVOLVER, min.occurrences = 5)

caravagn/revolver documentation built on May 21, 2022, 5:48 p.m.