scHopfield.dynamics.calculate_perturbation_effect_scores

scHopfield.dynamics.calculate_perturbation_effect_scores(adata: AnnData, cluster_key: str = 'cell_type', method: str = 'mean') → DataFrame

Calculate perturbation effect scores per cluster.

Summarizes the delta_X values by cluster to quantify the overall effect of the perturbation on each cell population.

Parameters:

• adata (AnnData) – Annotated data object with simulation results (delta_X layer)

• cluster_key (str, optional (default: 'cell_type')) – Key in adata.obs for cluster labels

• method (str, optional (default: 'mean')) – How to summarize effects: ‘mean’, ‘median’, ‘max’, or ‘norm’ - ‘mean’: Mean absolute delta_X - ‘median’: Median absolute delta_X - ‘max’: Maximum absolute delta_X - ‘norm’: L2 norm of delta_X vector

Returns:

DataFrame with clusters as index and genes as columns, containing the summarized perturbation effects.

Return type:

pd.DataFrame