scHopfield.dynamics.calculate_cell_transition_scores

scHopfield.dynamics.calculate_cell_transition_scores(adata: AnnData, cluster_key: str = 'cell_type', basis: str = 'umap') → DataFrame

Calculate cell transition scores based on delta_X magnitude.

This measures how much each cell’s state changes due to perturbation, which can indicate cells most affected by the perturbation.

Parameters:

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

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

• basis (str, optional (default: 'umap')) – Embedding basis for potential vector field visualization

Returns:

DataFrame with cell-level transition scores

Return type:

pd.DataFrame