scFates.tl.cellrank_to_tree

scFates.tl.cellrank_to_tree(adata, time, Nodes, method='ppt', ppt_lambda=100, auto_root=False, root_params={}, reassign_pseudotime=False, copy=False, **kwargs)

Converts CellRank [Lange21] fate probabilities into a principal tree that can be analysed by scFates.

It combines the projection generated by cr.pl.circular_projection with any measure of differentiation (CytoTRACE, latent time). A tree is fitted onto this new embedding.

Parameters
adata

Annotated data matrix.

time

time key to use for the additional dimension used in combination with cr.pl.circular_projection.

Nodes : int

Number of nodes that compose the principal graph.

method : {‘ppt’, ‘epg’}Literal[‘ppt’, ‘epg’] (default: 'ppt')

If ppt, uses simpleppt approach, ppt_lambda and ppt_sigma are the parameters controlling the algorithm. If epg, uses ComputeElasticPrincipalTree function from elpigraph python package, epg_lambda epg_mu and epg_trimmingradius are the parameters controlling the algorithm.

ppt_lambda : int (default: 100)

Parameter for simpleppt, penalty for the tree length [Mao15]. Usually works well at default for the conversion.

auto_root : bool (default: False)

Automatically select the root tip using the time key.

min_val

min_val parameter from scFates.tl.root()

reassign_pseudotime : bool (default: False)

whether use the time key to replace the distances comptued from the tree.

copy

Return a copy instead of writing to adata.

kwargs

arguments to pass to function scFates.tl.tree().

Returns

adata – if copy=True it returns or else add fields to adata:

.obsm[‘X_fates’]

representation generated by combining the time key with projection generated by cellrank.pl.circular_projection().

.uns[‘ppt’]

dictionnary containing information from simpelppt tree if method=’ppt’

.uns[‘epg’]

dictionnary containing information from elastic principal tree if method=’epg’

.uns[‘graph’][‘B’]

adjacency matrix of the principal points

.uns[‘graph’][‘R’]

soft assignment of cells to principal point in representation space

.uns[‘graph’][‘F’]

coordinates of principal points in representation spac

Return type

anndata.AnnData