regvelo.plotting.plot_visits_dist_screen

regvelo.plotting.plot_visits_dist_screen(adata, terminal_states, candidate_list, tick_range, sig_to_keep=['n.s.', '*', '**', '***'], figsize=None, key='markov_density_screening')[source]

Plot a combined boxplot of visit differences across all knocked-out TFs, one panel per terminal state, filtered to a significance threshold.

Parameters:

  • adata (AnnData) – AnnData holding the screening results in adata.uns[key]. The long-form table adata.uns[key]['screen_perturbation_rate'] (columns ‘Value’, ‘Group’, ‘Factor’, ‘significance’) is populated by rgv.tl.markov_density_screening().

  • terminal_states (sequence of str) – Terminal state labels; one plot is produced per state.

  • tick_range (float) – Half-width of the y-axis range, centred at 0.5.

  • candidate_list (list of str) – TFs to include; others are filtered out.

  • sig_to_keep (list of str) – Significance labels to display. Defaults to all levels (['n.s.', '*', '**', '***']), i.e. every factor is kept.

  • figsize (tuple of float, optional) – Figure size (width, height) in inches. If None (default), the width adapts to the number of factors shown in each panel (one box per factor), clamped to a sensible range; pass a tuple to set it manually.

  • key (str, optional) – Key in adata.uns under which the screening results are stored. Default "markov_density_screening".

Return type:

None

Returns:

: None

One boxplot per terminal state is drawn; no value is returned.