.proteoform_intensities

proteopy.pl.proteoform_intensities(adata, protein_ids=None, order_by=None, order=None, groups=None, color=None, group_by=None, log_transform=None, fill_na=None, z_transform=False, show_zeros=True, xlab_rotation=0, order_by_label_rotation=0, figsize=(15, 6), show=True, save=None, ax=False, color_scheme=None)

Plot peptide intensities across samples for the requested proteins.

Parameters:

  • adata (AnnData) – Proteomics AnnData.

  • protein_ids (str | Sequence[str]) – Show peptides mapping to this protein_id.

  • order_by (str, optional) – Column in adata.obs used to group and order observations on the x-axis. When None, observations follow adata.obs_names.

  • order (Sequence[str], optional) – Explicit order of groups (when order_by is set) or observations (when order_by is None).

  • groups (str | Sequence[str], optional) – Restrict order_by to selected categorical levels (requires order_by). The provided order determines the plotting order unless order is supplied.

  • group_by (str, optional) – adata.var column whose categories are aggregated into a single line. Mutually exclusive with color; each group is colored via color_scheme.

  • log_transform (float, optional) – Logarithm base (>0 and !=1). Values are transformed as log(value + 1, base).

  • fill_na (float, optional) – Replace missing intensities before zero/log/z transformations when set.

  • z_transform (bool, optional) – Standardize each peptide across observations after optional log transform. Skips NA.

  • show_zeros (bool, optional) – Display zero intensities when True; otherwise zeros become NaN.

  • xlab_rotation (float, optional) – Rotation angle (degrees) applied to x-axis tick labels.

  • order_by_label_rotation (float, optional) – Rotation angle for the group labels drawn above grouped sections.

  • figsize (tuple[float, float], optional) – Size of each generated figure passed to matplotlib.pyplot.subplots().

  • color_scheme (Any, optional) – Palette specification forwarded to proteopy.utils.matplotlib._resolve_color_scheme() for either the per-peptide color or aggregated group_by categories.

  • show (bool, optional) – Display the generated figure(s) with matplotlib.pyplot.show().

  • save (str | os.PathLike, optional) – Path for saving the figure(s). Multi-protein selections are written to a PDF stack.

  • ax (bool, optional) – When True, return the underlying Axes objects instead of closing them.

Return type:

Axes | list[Axes] | None

Returns:

  • Axes | list[Axes] | None – Axes handle(s) when ax is True; otherwise None.

  • Note – This function is a partial of peptide_intensities, with the following arguments fixed: color=’proteoform_id’.