splicejac.tools.transitions

functions to identify transition driver genes

Module Contents

Functions

find_dir(w, v[, dir_method, eig_number])

Identify the unstable transition directions given the eigenspectrum of the starting cell state

find_trans_genes(adata, cluster1, cluster2[, ...])

Compute the gene instability scores for transition from cluster1 to cluster2

select_top_trans_genes(adata, cluster1, cluster2[, ...])

Returns lists of top differentially expressed genes (DEG), transition genes (TF), and both for transition from

transition_genes(adata, cluster1, cluster2[, ...])

Compute the gene instability scores for transition from cluster1 to cluster2

trans_from_PAGA(adata[, dir_method, eig_number, ...])

Compute the gene instability scores for all transitions identified with PAGA

splicejac.tools.transitions.find_dir(w, v, dir_method='top_eig', eig_number=5)

Identify the unstable transition directions given the eigenspectrum of the starting cell state

w: ~numpy.ndarray

eigenvalues of cell state Jacobian

v: ~numpy.ndarray

eigenvectors of cell state Jacobian

dir_method: str (default: ‘top_eig’)

method to select the unstable directions, choose between ‘top_eig’ and ‘positive’. ‘top_eig’ uses the largest eigenvalues irrespective of sign; ‘positive’ strictly uses positive eigenvalues

eig_number: int (default: 5)

number of largest eigenvalues to consider, required for dir_method=’top_eig’

dir: ~numpy.ndarray

set of unstable directions

splicejac.tools.transitions.find_trans_genes(adata, cluster1, cluster2, dir_method='top_eig', eig_number=5, first_moment=True)

Compute the gene instability scores for transition from cluster1 to cluster2

adata: ~anndata.AnnData

count matrix

cluster1: str

starting cell state

cluster2: str

final cell states

dir_method: str (default: ‘top_eig’)

method to select the unstable directions, choose between ‘top_eig’ and ‘positive’. ‘top_eig’ uses the largest eigenvalues irrespective of sign; ‘positive’ strictly uses positive eigenvalues

eig_number: int (default: 5)

number of largest eigenvalues to consider, required for dir_method=’top_eig’

first_moment: Bool (default: True)

if True, use first moments of unspliced/spliced counts

weight: ~numpy.ndarray

weight of each gene for the specified transition

splicejac.tools.transitions.select_top_trans_genes(adata, cluster1, cluster2, top_DEG=5, top_TG=5)

Returns lists of top differentially expressed genes (DEG), transition genes (TF), and both for transition from cluster1 to cluster2

If some genes are both top DEG and top TG, they are classified in the both_list, and n genes are selected until a total of top_DEG+top_TG genes are selected Results are stored in adata.uns[‘transitions’]

adata: ~anndata.AnnData

count matrix

cluster1: str

starting cell state

cluster2: str

final cell states

top_DEG: int (default: 5)

number of top DEG to select

top_TG: int (default: 5)

number of top TG to select

None

splicejac.tools.transitions.transition_genes(adata, cluster1, cluster2, dir_method='top_eig', eig_number=5, top_DEG=5, top_TG=5, first_moment=True)

Compute the gene instability scores for transition from cluster1 to cluster2 Results are stored in adata.uns[‘transitions’]

adata: ~anndata.AnnData

count matrix

cluster1: str

starting cell state

cluster2: str

final cell states

dir_method: str (default: ‘top_eig’)

method to select the unstable directions, choose between ‘top_eig’ and ‘positive’. ‘top_eig’ uses the largest eigenvalues irrespective of sign; ‘positive’ strictly uses positive eigenvalues

eig_number: int (default: 5)

number of largest eigenvalues to consider, required for dir_method=’top_eig’

top_DEG: int (default: 5)

number of top DEG to select

top_TG: int (default: 5)

number of top TG to select

first_moment: Bool (default: True)

if True, use first moments of unspliced/spliced counts

None

splicejac.tools.transitions.trans_from_PAGA(adata, dir_method='top_eig', eig_number=5, top_DEG=5, top_TG=5, first_moment=True)

Compute the gene instability scores for all transitions identified with PAGA PAGA transitions must be stored as a dataframe in adata.uns[‘PAGA_paths’] results are stored in adata.uns[‘transitions’]

adata: ~anndata.AnnData

count matrix

dir_method: str (default: ‘top_eig’)

method to select the unstable directions, choose between ‘top_eig’ and ‘positive’. ‘top_eig’ uses the largest eigenvalues irrespective of sign; ‘positive’ strictly uses positive eigenvalues

eig_number: int (default: 5)

number of largest eigenvalues to consider, required for dir_method=’top_eig’

top_DEG: int (default: 5)

number of top DEG to select

top_TG: int (default: 5)

number of top TG to select

first_moment: Bool (default: True)

if True, use first moments of unspliced/spliced counts

None