peach.pl.archetype_positions_3d

peach.pl.archetype_positions_3d#

peach.pl.archetype_positions_3d(adata, *, coords_key='archetype_coordinates', title='Archetype Positions in 3D PCA Space', figsize=(12, 10), cmap='tab10', save_path=None, **kwargs)[source]#

Visualize archetype positions in 3D PCA space.

Creates an interactive 3D visualization of archetype positions with convex hull edges connecting the archetypes.

Parameters:

  • adata (AnnData) – Annotated data object with archetype coordinates

  • coords_key (str, default: "archetype_coordinates") – Key in adata.uns containing archetype coordinates

  • title (str, default: "Archetype Positions in 3D PCA Space") – Figure title

  • figsize (tuple, default: (12, 10)) – Figure size as (width, height)

  • cmap (str, default: 'tab10') – Colormap for archetype points

  • save_path (str | None, default: None) – Path to save the figure

  • **kwargs – Additional arguments passed to plot_archetype_distances_3d

Returns:

3D visualization of archetypes

Return type:

matplotlib.figure.Figure

Examples

>>> # Basic 3D visualization
>>> fig = pc.pl.archetype_positions_3d(adata)
>>> plt.show()

>>> # Custom visualization
>>> fig = pc.pl.archetype_positions_3d(adata, cmap="Set1", title="3D Archetype Hull")

Notes

Requires at least 3 dimensions in archetype coordinates. The visualization includes convex hull edges connecting archetypes.