regvelo.metrics.cellfate_perturbation

regvelo.metrics.cellfate_perturbation(perturbed, baseline, terminal_state, method='likelihood')[source]

Compute depletion likelihood or score for TF perturbation.

Parameters:

  • perturbed (dict[str, AnnData]) – Dictionary mapping TF candidate names to their perturbed AnnData objects, each containing precomputed fate probabilities under obsm["lineages_fwd"].

  • baseline (AnnData) – Unperturbed AnnData object with precomputed fate probabilities under obsm["lineages_fwd"].

  • terminal_state (Union[str, Sequence[str]]) – One or more terminal states for which depletion scores are computed.

  • method (Literal['likelihood', 't-statistics']) –

    Scoring method to use:

    • ”t-statistics”: uses t-statistics.

    • ”likelihood”: uses ROC AUC score.

Return type:

DataFrame

Returns:

: DataFrame summarizing depletion scores and significance statistics.