spateo.plotting.static.space#

Module Contents#

Functions#

space(adata[, color, genes, gene_cmaps, space, width, ...])

Scatter plot for physical coordinates of each cell.

spateo.plotting.static.space.space(adata: anndata.AnnData, color: Union[list, str, None] = None, genes: Union[list, None] = [], gene_cmaps=None, space: str = 'spatial', width: float = 6, marker: str = '.', pointsize: Union[float, None] = None, dpi: int = 100, ps_sample_num: int = 1000, alpha: float = 0.8, stack_genes: bool = False, stack_genes_threshold: float = 0.01, stack_colors_legend_size: int = 10, figsize=None, *args, **kwargs)[source]#

Scatter plot for physical coordinates of each cell. :param adata: an Annodata object that contain the physical coordinates for each bin/cell, etc. :param genes: The gene list that will be used to plot the gene expression on the same scatter plot. Each gene will have a

different color. Can be a single gene name string and we will convert it to a list.

Parameters
color : string (default: ntr)

Any or any list of column names or gene name, etc. that will be used for coloring cells. If color is not None, stack_genes will be disabled automatically because color can contain non numerical values.

space : str

The key to space coordinates.

stack_genes

whether to show all gene plots on the same plot

stack_genes_threshold

lower bound of gene values that will be drawn on the plot.

stack_colors_legend_size

control the size of legend when stacking genes

alpha : float

The alpha value of the scatter points.

width : int

marker

a string representing some marker from matplotlib https://matplotlib.org/stable/api/markers_api.html#module-matplotlib.markers

pointsize : float

The size of the points on the scatter plot.

dpi : float, (default: 100.0)

The resolution of the figure in dots-per-inch. Dots per inches (dpi) determines how many pixels the figure comprises. dpi is different from ppi or points per inches. Note that most elements like lines, markers, texts have a size given in points so you can convert the points to inches. Matplotlib figures use Points per inch (ppi) of 72. A line with thickness 1 point will be 1./72. inch wide. A text with fontsize 12 points will be 12./72. inch heigh. Of course if you change the figure size in inches, points will not change, so a larger figure in inches still has the same size of the elements.Changing the figure size is thus like taking a piece of paper of a different size. Doing so, would of course not change the width of the line drawn with the same pen. On the other hand, changing the dpi scales those elements. At 72 dpi, a line of 1 point size is one pixel strong. At 144 dpi, this line is 2 pixels strong. A larger dpi will therefore act like a magnifying glass. All elements are scaled by the magnifying power of the lens. see more details at answer 2 by @ImportanceOfBeingErnest: https://stackoverflow.com/questions/47633546/relationship-between-dpi-and-figure-size

ps_sample_num : int

The number of bins / cells that will be sampled to estimate the distance between different bin / cells.

%(scatters.parameters.no_adata|basis|figsize)s

Returns

plots gene or cell feature of the adata object on the physical spatial coordinates.