Interface: ScatterOptions
Options of scatter: px.scatter's arguments in camelCase.
Extends
CommonOptions.XYOptions.DiscreteColorOptions.ContinuousColorOptions.HoverOptions.FacetOptions.AnimationFrameOptions.AxisOptions.SymbolOptions.ErrorBarOptions.MarginalOptions.TrendlineArgs
Properties
| Property | Modifier | Type | Description | Inherited from |
|---|---|---|---|---|
animationFrame? | readonly | ColumnRef | Column of frame values: one frame per value (in categoryOrders / first-appearance order), with a Play / Pause update menu and a slider. Axis ranges are fixed across frames. | AnimationFrameOptions.animationFrame |
animationGroup? | readonly | ColumnRef | Column matching rows across frames (ids), so each object moves rather than being replaced. | AnimationFrameOptions.animationGroup |
categoryOrders? | readonly | Readonly<Record<string, readonly unknown[]>> | Value orders per column: { day: ['Thu', 'Fri', 'Sat', 'Sun'] }. They order the traces and legend (for grouping columns), facets, frames and category axes. Values not listed follow in order of first appearance; listed values without rows still take a color and a facet (as px). | CommonOptions.categoryOrders |
color? | readonly | ColumnRef | Column to color by. | DiscreteColorOptions.color |
colorContinuousMidpoint? | readonly | number | cmid: the value at the middle of a diverging colorscale. | ContinuousColorOptions.colorContinuousMidpoint |
colorContinuousScale? | readonly | ContinuousScale | Colorscale of a numeric color. Default: the template's sequential colorscale. | ContinuousColorOptions.colorContinuousScale |
colorDiscreteMap? | readonly | Readonly<Record<string, string>> | "identity" | Fixed colors per value of color ({ Asia: 'red' }); other values continue with the sequence. 'identity': the values are colors themselves (no legend entries for them). | DiscreteColorOptions.colorDiscreteMap |
colorDiscreteSequence? | readonly | readonly string[] | Colors for the values of color, in order. Default: the template's colorway. | DiscreteColorOptions.colorDiscreteSequence |
customData? | readonly | readonly ColumnRef[] | Columns put in customdata (first, before hoverData's), e.g. for click handlers. | HoverOptions.customData |
errorX? | readonly | ColumnRef | Column of x error sizes (error_x.array). | ErrorBarOptions.errorX |
errorXMinus? | readonly | ColumnRef | Column of x error sizes below (error_x.arrayminus). | ErrorBarOptions.errorXMinus |
errorY? | readonly | ColumnRef | Column of y error sizes (error_y.array). | ErrorBarOptions.errorY |
errorYMinus? | readonly | ColumnRef | Column of y error sizes below (error_y.arrayminus). | ErrorBarOptions.errorYMinus |
facetCol? | readonly | ColumnRef | Column whose values make the columns of subplots. | FacetOptions.facetCol |
facetColSpacing? | readonly | number | Space between facet columns, as a fraction of the plot width. Default 0.02. | FacetOptions.facetColSpacing |
facetColWrap? | readonly | number | Wrap facetCol after this many columns (row by row from the top). Ignored with facetRow or a marginal. Default 0 (no wrapping). | FacetOptions.facetColWrap |
facetRow? | readonly | ColumnRef | Column whose values make the rows of subplots (first value at the top). | FacetOptions.facetRow |
facetRowSpacing? | readonly | number | Space between facet rows, as a fraction of the plot height. Default 0.03 (0.07 wrapped). | FacetOptions.facetRowSpacing |
height? | readonly | number | Figure height in px (layout.height). | CommonOptions.height |
hoverData? | readonly | | readonly ColumnRef[] | Readonly<Record<string, string | boolean>> | More columns for the hover label, through customdata: a list of columns, or an object that adds columns (true), removes lines (false, e.g. { x: false }) or formats them (':.2f', `' | %Y'`). |
hoverName? | readonly | ColumnRef | Column shown in bold at the top of the hover label (hovertext). | HoverOptions.hoverName |
labels? | readonly | Readonly<Record<string, string>> | Display names of columns: { gdpPercap: 'GDP per capita' }. Used for axis titles, hover lines, the legend title, facet labels, the colorbar title and the animation slider. | CommonOptions.labels |
logX? | readonly | boolean | Log x axis (type: 'log', on every facet). | AxisOptions.logX |
logY? | readonly | boolean | Log y axis. | AxisOptions.logY |
marginalX? | readonly | MarginalKind | Distribution of x drawn above the plot, sharing its x axis. | MarginalOptions.marginalX |
marginalY? | readonly | MarginalKind | Distribution of y drawn right of the plot, sharing its y axis. | MarginalOptions.marginalY |
opacity? | readonly | number | Marker opacity, 0–1. | - |
orientation? | readonly | "v" | "h" | 'v' or 'h'. Default as px: 'h' when only the value column of a horizontal chart is given or when x is numeric and y is not, else 'v'. | XYOptions.orientation |
rangeColor? | readonly | readonly [number, number] | [cmin, cmax] of the colorscale. | ContinuousColorOptions.rangeColor |
rangeX? | readonly | readonly [unknown, unknown] | Fixed x range, in data units (log axes take data units too, as px). | AxisOptions.rangeX |
rangeY? | readonly | readonly [unknown, unknown] | Fixed y range, in data units. | AxisOptions.rangeY |
size? | readonly | ColumnRef | Column of marker sizes (area-proportional, the largest sizeMax px across). | - |
sizeMax? | readonly | number | Diameter of the largest marker with size, in px. Default 20. | - |
symbol? | readonly | ColumnRef | Column whose values get different marker symbols (one trace per value). | SymbolOptions.symbol |
symbolMap? | readonly | Readonly<Record<string, string>> | "identity" | Fixed symbols per value; 'identity': the values are symbols. | SymbolOptions.symbolMap |
symbolSequence? | readonly | readonly string[] | Symbols in order. Default: the template's scatter symbols, else circle, diamond, square, x, cross. | SymbolOptions.symbolSequence |
template? | readonly | string | Template | layout.template: a registered name ('plotly-classic') or a template object. Default: unset, so the chart's default template applies (Holochart's holochart look); its colorway, symbol and dash cycles and sequential colorscale are what the figure's colors are taken from. | CommonOptions.template |
text? | readonly | ColumnRef | Column of text drawn at the points (mode: 'markers+text'). | - |
title? | readonly | string | Figure title (layout.title.text). | CommonOptions.title |
trendline? | readonly | TrendlineKind | Draw a trendline of each group (or of all rows, see trendlineScope). | TrendlineArgs.trendline |
trendlineColorOverride? | readonly | string | One color for every trendline (line.color) instead of the group colors. | TrendlineArgs.trendlineColorOverride |
trendlineOptions? | readonly | TrendlineOptions | Options of the trendline kind (px's trendline_options). | TrendlineArgs.trendlineOptions |
trendlineScope? | readonly | "trace" | "overall" | 'trace' (default): one trendline per group; 'overall': one fit over all rows, drawn in every subplot as Overall Trendline (one legend entry), in the next color of the sequence. | TrendlineArgs.trendlineScope |
width? | readonly | number | Figure width in px (layout.width). | CommonOptions.width |
x? | readonly | ColumnRef | Column of x values. | XYOptions.x |
y? | readonly | ColumnRef | Column of y values. | XYOptions.y |