Skip to main content
Glama

pl_dotplot

Generate dot plots to visualize gene expression values across groups, enabling insights into single-cell RNA sequencing data through customizable visual parameters.

Instructions

Plot dot plot of expression values per gene for each group.

Input Schema

NameRequiredDescriptionDefault
color_mapNoColor map to use for continuous variables.
colorbar_titleNoTitle for the color bar. New line character (\n) can be used.Mean expression in group
dendrogramNoIf True or a valid dendrogram key, a dendrogram based on the hierarchical clustering between the groupby categories is added.
dot_maxNoThe maximum size of the dots.
dot_minNoThe minimum size of the dots.
expression_cutoffNoExpression cutoff that is used for binarizing the gene expression.
figsizeNoFigure size. Format is (width, height).
gene_symbolsNoColumn name in .var DataFrame that stores gene symbols.
groupbyYesThe key of the observation grouping to consider.
layerNoName of the AnnData object layer that wants to be plotted.
legend_fontoutlineNoLine width of the legend font outline in pt.
legend_fontsizeNoNumeric size in pt or string describing the size.
legend_fontweightNoLegend font weight. A numeric value in range 0-1000 or a string.bold
legend_locNoLocation of legend, either 'on data', 'right margin' or a valid keyword for the loc parameter.right margin
logNoPlot on logarithmic axis.
mean_only_expressedNoIf True, gene expression is averaged only over the cells expressing the given genes.
paletteNoColors to use for plotting categorical annotation groups.
size_titleNoTitle for the size legend. New line character (\n) can be used.Fraction of cells in group (%)
smallest_dotNoThe smallest dot size.
standard_scaleNoWhether or not to standardize that dimension between 0 and 1.
swap_axesNoBy default, the x axis contains var_names and the y axis the groupby categories. By setting swap_axes then x are the groupby categories and y the var_names.
use_rawNoUse raw attribute of adata if present.
var_group_labelsNoLabels for each of the var_group_positions that want to be highlighted.
var_group_positionsNoUse this parameter to highlight groups of var_names with brackets or color blocks between the given start and end positions.
var_group_rotationNoLabel rotation degrees. By default, labels larger than 4 characters are rotated 90 degrees.
var_namesNovar_names should be a valid subset of adata.var_names or a mapping where the key is used as label to group the values.
vcenterNoThe value representing the center of the color scale.
vmaxNoThe value representing the upper limit of the color scale.
vminNoThe value representing the lower limit of the color scale.

Input Schema (JSON Schema)

{ "description": "Input schema for the dotplot plotting tool.", "properties": { "color_map": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Color map to use for continuous variables.", "title": "Color Map" }, "colorbar_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": "Mean expression\nin group", "description": "Title for the color bar. New line character (\\n) can be used.", "title": "Colorbar Title" }, "dendrogram": { "anyOf": [ { "type": "boolean" }, { "type": "string" } ], "default": false, "description": "If True or a valid dendrogram key, a dendrogram based on the hierarchical clustering between the groupby categories is added.", "title": "Dendrogram" }, "dot_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "The maximum size of the dots.", "title": "Dot Max" }, "dot_min": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "The minimum size of the dots.", "title": "Dot Min" }, "expression_cutoff": { "default": 0, "description": "Expression cutoff that is used for binarizing the gene expression.", "title": "Expression Cutoff", "type": "number" }, "figsize": { "anyOf": [ { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "number" }, { "type": "number" } ], "type": "array" }, { "type": "null" } ], "default": null, "description": "Figure size. Format is (width, height).", "title": "Figsize" }, "gene_symbols": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Column name in .var DataFrame that stores gene symbols.", "title": "Gene Symbols" }, "groupby": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ], "description": "The key of the observation grouping to consider.", "title": "Groupby" }, "layer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Name of the AnnData object layer that wants to be plotted.", "title": "Layer" }, "legend_fontoutline": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Line width of the legend font outline in pt.", "title": "Legend Fontoutline" }, "legend_fontsize": { "anyOf": [ { "type": "integer" }, { "type": "number" }, { "type": "string" }, { "type": "null" } ], "default": null, "description": "Numeric size in pt or string describing the size.", "title": "Legend Fontsize" }, "legend_fontweight": { "anyOf": [ { "type": "integer" }, { "type": "string" } ], "default": "bold", "description": "Legend font weight. A numeric value in range 0-1000 or a string.", "title": "Legend Fontweight" }, "legend_loc": { "default": "right margin", "description": "Location of legend, either 'on data', 'right margin' or a valid keyword for the loc parameter.", "title": "Legend Loc", "type": "string" }, "log": { "default": false, "description": "Plot on logarithmic axis.", "title": "Log", "type": "boolean" }, "mean_only_expressed": { "default": false, "description": "If True, gene expression is averaged only over the cells expressing the given genes.", "title": "Mean Only Expressed", "type": "boolean" }, "palette": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" }, { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "default": null, "description": "Colors to use for plotting categorical annotation groups.", "title": "Palette" }, "size_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": "Fraction of cells\nin group (%)", "description": "Title for the size legend. New line character (\\n) can be used.", "title": "Size Title" }, "smallest_dot": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "The smallest dot size.", "title": "Smallest Dot" }, "standard_scale": { "anyOf": [ { "enum": [ "var", "group" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Whether or not to standardize that dimension between 0 and 1.", "title": "Standard Scale" }, "swap_axes": { "default": false, "description": "By default, the x axis contains var_names and the y axis the groupby categories. By setting swap_axes then x are the groupby categories and y the var_names.", "title": "Swap Axes", "type": "boolean" }, "use_raw": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Use raw attribute of adata if present.", "title": "Use Raw" }, "var_group_labels": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Labels for each of the var_group_positions that want to be highlighted.", "title": "Var Group Labels" }, "var_group_positions": { "anyOf": [ { "items": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "integer" }, { "type": "integer" } ], "type": "array" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Use this parameter to highlight groups of var_names with brackets or color blocks between the given start and end positions.", "title": "Var Group Positions" }, "var_group_rotation": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Label rotation degrees. By default, labels larger than 4 characters are rotated 90 degrees.", "title": "Var Group Rotation" }, "var_names": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "type": "object" } ], "default": null, "description": "var_names should be a valid subset of adata.var_names or a mapping where the key is used as label to group the values.", "title": "Var Names" }, "vcenter": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] }, "type": "array" }, { "type": "null" } ], "default": null, "description": "The value representing the center of the color scale.", "title": "Vcenter" }, "vmax": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] }, "type": "array" }, { "type": "null" } ], "default": null, "description": "The value representing the upper limit of the color scale.", "title": "Vmax" }, "vmin": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] }, "type": "array" }, { "type": "null" } ], "default": null, "description": "The value representing the lower limit of the color scale.", "title": "Vmin" } }, "required": [ "groupby" ], "title": "DotplotModel", "type": "object" }

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/huang-sh/scmcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server