# SmartVisuals Scatter & Bubble for Power BI

> Power BI scatter and bubble chart: named quadrants, trend line with R², Pearson r with p-value and a play axis free. Premium: movement, zones, bands, 100k points.

- Page: https://www.smartvisuals.io/visuals/scatter-bubble
- Fields and settings: https://www.smartvisuals.io/visuals/scatter-bubble/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-scatter?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-scatter-bubble-1.0.0.0.pbiviz
- Price: Free tier for every viewer; premium $1.99 per user per month or $19 per user per year on Microsoft Marketplace, with a 30-day free trial. Premium works in edit mode without a licence; unlicensed viewers see the free tier, never a blocked visual.
- Certified by Microsoft: no
- Version: 1.0.0.0
- GUID (visualType and publicCustomVisuals): `smartVisualsScatter4A7F2E8C1B3D5690F2A8C4E7B1D93F56`

## What is free

- **Scatter and bubble**: Area-true bubbles, a legend, six marker shapes, Data Colors per legend value and fx colour rules.
- **Named quadrants**: Split at the median, mean, zero, a value or a benchmark measure; named, tinted, counted, points coloured by quadrant.
- **Trend line with R²**: A linear fit with its equation and R², also on a bubble chart, and a ring on points far from the trend.
- **Pearson r with its p-value**: Strength, r, p and n in a plain-language caption, with an optional 95 % confidence interval.
- **Labels that never overlap**: Top N, all that fit, extremes per quadrant or selected only, with leader lines, a halo and highlight by name.
- **Reference lines**: Constant, mean, median, minimum and maximum, percentile, a ratio line and y = x with symmetry shading.
- **Axes your way**: Logarithmic, inverted and date axes, jitter, auto-fit marker size and a Top N points filter.
- **Play axis**: One frame per period with a slider, loop and trails; statistics recomputed per frame.
- **Annotations and images**: Callouts from a text measure and images in points from inline data:image values.
- **Interaction**: Lasso selection, wheel zoom and pan, drilldown, highlight and cross-filtering, tooltips and report page tooltips.
- **Templates and setup guide**: Executive, Analyst, Presentation, Minimal and Print; a setup guide on the empty visual; on-object formatting; four themes.
- **Accessibility and 20 languages**: Keyboard navigation of every point, a screen-reader table, high contrast, shapes by series and reduce motion, in 20 languages.

## What premium adds

- **Movement vs prior period**: Arrows, lines or ghost markers from last period, improved, declined and unchanged counts, and a migration matrix.
- **Zones beyond 2×2**: Up to 8 × 8 by quantiles, equal widths or your own cuts, heat shading by better direction and a zone table.
- **Regression suite**: Quadratic, cubic, logarithmic, exponential, power and LOESS fits; 90, 95 or 99 % confidence and prediction bands; a coefficient table with p-values; per-series and weighted fits.
- **Spearman and Kendall**: Rank correlations for relationships that rise steadily but not in a straight line.
- **Outliers with a reason**: Studentized residuals, Cook's distance, leverage and Mahalanobis distance, with the reason in the tooltip.
- **Clusters and ellipses**: k-means, hierarchical (Ward) and DBSCAN with noise, hulls and confidence ellipses.
- **Small multiples**: One panel per value on shared or free axes, with statistics per panel.
- **Density and 100,000 points**: Shading, KDE contours or hexagonal bins, and up to 100,000 points.

## Fields

| Field | Internal name | Takes | Needed | What it is for |
| --- | --- | --- | --- | --- |
| Details | `details` | Column | Optional | Point identity (customer, product, region…). One point per value. |
| X | `x` | Measure | Optional | Numeric value on the horizontal axis. |
| Y | `y` | Measure | Optional | Numeric value on the vertical axis. |
| Size | `size` | Measure | Optional | Bubble area proportional to the value (area-true). |
| Legend | `legend` | Column | Optional | Colour (and optional shape) by this field. |
| Label | `label` | Column | Optional | Text for data labels, when different from Details. |
| Play Axis | `playAxis` | Column | Optional | Date or ordered field: one frame per value, with play, slider and trails. |
| Annotation | `annotation` | Column | Optional | Text shown as a callout next to the point (blank = none). |
| Image | `image` | Column | Optional | Image per point as a data:image URL (base64); drawn in the marker. Web URLs are ignored (no external calls). |
| Prior X | `priorX` | Measure | Optional | Premium. X in the comparison period: draws movement and migration counts. |
| Prior Y | `priorY` | Measure | Optional | Premium. Y in the comparison period. |
| Small Multiples | `smallMultiples` | Column | Optional | Premium. One panel per value, statistics per panel. |
| Tooltips | `tooltips` | Measure | Optional, up to 10 | Extra measures in the tooltip. |
| X Split | `xSplit` | Measure | Optional | Benchmark for the vertical quadrant line (e.g. target growth). |
| Y Split | `ySplit` | Measure | Optional | Benchmark for the horizontal quadrant line (e.g. target margin). |
| Weight | `weight` | Measure | Optional | Premium. Per-point weight for weighted least squares. |

## Format pane

Each card is a key under `visual.objects` in a PBIR visual.json; each setting is a property of it. Toggles take `true`/`false`, choices and text a value in single quotes (`'auto'`), numbers a `D` suffix (`12D`).

### Theme (`theme`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Style Template: Apply a named preset to several cards at once; the dropdown shows the one in use. Edit any setting afterwards and it shows Custom. Default restores the style defaults. | `template` | `none` (Default), `executive` (Executive), `analyst` (Analyst), `presentation` (Presentation), `minimal` (Minimal), `print` (Print), `custom` (Custom) |
| Theme | `selectedTheme` | `smartvisuals` (SmartVisuals), `dark` (Dark), `clean` (Clean), `slate` (Slate) |
| Transparent Background | `transparentBg` | On / off |
| Background Color | `background` | Colour |

### Markers (`markers`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Color: Empty follows the theme palette by legend. Use fx for rules or field values. | `fill` | Colour |
| Shape | `shape` | `circle` (Circle), `square` (Square), `diamond` (Diamond), `triangle` (Triangle), `cross` (Cross), `star` (Star) |
| Size (px) | `markerSize` | Number |
| Opacity (%) | `opacity` | Number |
| Border Width | `borderWidth` | Number |
| Border Color | `borderColor` | Colour |
| Auto-Fit Marker Size: Shrink markers when many points share the plot, so dense data stays readable. | `autoFit` | On / off |
| Draw Order: Which points sit on top. Selected and highlighted points always come to the front. | `drawOrder` | `size` (Largest first (small on top)), `x` (By X), `y` (By Y), `data` (Data order) |

### Bubble Size (`bubble`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Minimum Radius (px) | `minRadius` | Number |
| Maximum Radius (px) | `maxRadius` | Number |

### X Axis (`xAxis`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Title | `title` | On / off |
| Title Text | `titleText` | Text |
| Scale | `scale` | `linear` (Linear), `log` (Logarithmic) |
| Invert | `invert` | On / off |
| Minimum | `min` | Text |
| Maximum | `max` | Text |
| Gridlines | `gridlines` | On / off |
| Grid Color | `gridColor` | Colour |
| Font Size | `fontSize` | Number |
| Font Color | `fontColor` | Colour |

### Y Axis (`yAxis`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Title | `title` | On / off |
| Title Text | `titleText` | Text |
| Scale | `scale` | `linear` (Linear), `log` (Logarithmic) |
| Invert | `invert` | On / off |
| Minimum | `min` | Text |
| Maximum | `max` | Text |
| Gridlines | `gridlines` | On / off |
| Grid Color | `gridColor` | Colour |
| Font Size | `fontSize` | Number |
| Font Color | `fontColor` | Colour |

### Legend (`legend`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Position | `position` | `top` (Top), `bottom` (Bottom) |
| Title | `title` | On / off |
| Font Size | `fontSize` | Number |
| Font Color | `fontColor` | Colour |

### Data Labels (`labels`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `mode` | `none` (None), `topN` (Most prominent (Top N)), `all` (All that fit), `extremes` (Extremes per quadrant / zone), `selected` (Selected only) |
| Top N | `topN` | Number |
| Font Size | `fontSize` | Number |
| Font Color | `fontColor` | Colour |
| Leader Lines | `leaderLines` | On / off |
| Halo | `background` | On / off |
| Highlight Points Named: Points whose label contains this text are emphasised and always labelled; the rest are dimmed. | `highlightText` | Text |

### Top N Points (`pointFilter`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Keep | `by` | `none` (All points), `size` (Top N by size), `y` (Top N by Y), `x` (Top N by X), `bottomY` (Bottom N by Y) |
| N | `n` | Number |

### Quadrants (`quadrants`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| X Split | `xRule` | `median` (Median), `mean` (Mean), `zero` (Zero), `value` (Value), `measure` (Benchmark measure (X / Y Split role)) |
| X Value | `xValue` | Number |
| Y Split | `yRule` | `median` (Median), `mean` (Mean), `zero` (Zero), `value` (Value), `measure` (Benchmark measure (X / Y Split role)) |
| Y Value | `yValue` | Number |
| Top-Left Label | `tlLabel` | Text |
| Top-Right Label | `trLabel` | Text |
| Bottom-Left Label | `blLabel` | Text |
| Bottom-Right Label | `brLabel` | Text |
| Top-Left Fill | `tlFill` | Colour |
| Top-Right Fill | `trFill` | Colour |
| Bottom-Left Fill | `blFill` | Colour |
| Bottom-Right Fill | `brFill` | Colour |
| Default Tints: Subtle tints when no fill is set: top-right green, bottom-left orange, the others grey. | `tint` | On / off |
| Show Counts | `showCounts` | On / off |
| Label Font Size: Size of the quadrant and zone names and counts. | `fontSize` | Number |
| Label Font Color | `fontColor` | Colour |
| Color Points By Quadrant / Zone | `colorPoints` | On / off |

### Zones (Beyond 2×2) (`zones`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show: Premium. Split the plane into a grid of up to 8×8 zones with counts, heat shading and a zone table. Replaces quadrants. | `show` | On / off |
| Columns | `cols` | Number |
| Rows | `rows` | Number |
| X Cuts | `xMethod` | `quantile` (Equal count (quantiles)), `range` (Equal width), `custom` (Custom cuts) |
| X Custom Cuts | `xCuts` | Text |
| Y Cuts | `yMethod` | `quantile` (Equal count (quantiles)), `range` (Equal width), `custom` (Custom cuts) |
| Y Custom Cuts | `yCuts` | Text |
| Better Direction: Which way is good. Drives heat shading and improved / declined movement. | `better` | `upRight` (Up and right), `upLeft` (Up and left), `downRight` (Down and right), `downLeft` (Down and left), `up` (Up), `down` (Down), `right` (Right), `left` (Left) |
| Heat Shading | `heat` | `diverging` (Diverging (bad → good)), `sequential` (Sequential), `none` (None) |
| Heat Opacity (%) | `heatOpacity` | Number |
| Show Counts | `showCounts` | On / off |
| Zone Table | `table` | `off` (Off), `right` (Right), `bottom` (Bottom) |

### Side Tables (`tables`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Font Size: Zone table, coefficient table and migration matrix. | `fontSize` | Number |
| Font Color | `fontColor` | Colour |

### Movement vs Prior Period (`movement`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show: Premium. Needs Prior X and Prior Y. Draws where each point came from and counts zone migrations. | `show` | On / off |
| Style | `style` | `arrow` (Arrow), `line` (Line), `ghost` (Ghost marker only) |
| Color By | `colorBy` | `direction` (Improved / declined), `series` (Series) |
| Line Width | `lineWidth` | Number |
| Hide Moves Below (% of plot) | `minMove` | Number |
| Better Direction (No Zones) | `better` | `upRight` (Up and right), `upLeft` (Up and left), `downRight` (Down and right), `downLeft` (Down and left), `up` (Up), `down` (Down), `right` (Right), `left` (Left) |
| Migration Summary In Caption | `showSummary` | On / off |
| Migration Matrix | `showMatrix` | On / off |

### Trend Line (`trend`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Fit: Linear is free. Other fits are premium. | `fitType` | `linear` (Linear), `polynomial2` (Polynomial (2) — premium), `polynomial3` (Polynomial (3) — premium), `logarithmic` (Logarithmic — premium), `exponential` (Exponential — premium), `power` (Power — premium), `loess` (LOESS smoother — premium) |
| Per Series: Premium. One fit per legend value. | `perSeries` | On / off |
| Show Equation | `showEquation` | On / off |
| Show R² | `showRSquared` | On / off |
| Band: Premium. Shaded uncertainty band around the fit. | `bandType` | `none` (None), `confidence` (Confidence (mean)), `prediction` (Prediction (new point)), `both` (Both) |
| Band Level | `bandLevel` | `90` (90%), `95` (95%), `99` (99%) |
| Coefficient Table (p-values): Premium. Coefficients, standard errors, t, p, R², adjusted R², F test. | `showStats` | On / off |
| LOESS Span (%) | `loessSpan` | Number |
| Line Color | `color` | Colour |
| Line Width | `width` | Number |

### Correlation (`correlation`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show In Caption | `show` | On / off |
| Method | `method` | `pearson` (Pearson r), `spearman` (Spearman ρ — premium), `kendall` (Kendall τ-b — premium) |
| Show 95% Confidence Interval | `showCI` | On / off |

### Outliers (`outliers`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Flag Far From Trend: Ring points whose standardised residual exceeds the threshold. | `basicFlag` | On / off |
| Threshold | `basicThreshold` | `2`, `2.5`, `3` |
| Multivariate Outliers (Mahalanobis): Premium. Flag points outside the 97.5% ellipse of a bivariate normal (χ², 2 df), independent of any fit. | `mahalanobis` | On / off |
| Influence Diagnostics: Premium. Studentized residual > 3, Cook's D > 4/n, leverage > 2p/n, with the reason in the tooltip. | `diagnostics` | On / off |

### Clusters (`clusters`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show: Premium. k-means on standardised X and Y (fixed seed, reproducible). | `show` | On / off |
| Method | `method` | `kmeans` (k-means), `ward` (Hierarchical (Ward)), `dbscan` (DBSCAN (density, finds noise)) |
| DBSCAN Radius (SD units) | `eps` | Number |
| DBSCAN Minimum Points | `minSamples` | Number |
| Auto k (Silhouette) | `autoK` | On / off |
| Number Of Clusters | `k` | Number |
| Hulls | `showHulls` | On / off |
| Color Points By Cluster | `colorPoints` | On / off |

### Confidence Ellipses (`ellipses`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show: Premium. Bivariate-normal confidence ellipse (χ², 2 df) for all points, each series or each cluster. | `show` | On / off |
| One Per | `groupBy` | `all` (All points), `series` (Series), `cluster` (Cluster) |
| Level | `level` | `90` (90%), `95` (95%), `99` (99%) |

### Density Layer (`density`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show: Premium. Kernel density shading for dense or overplotted data. | `show` | On / off |
| Style | `style` | `shading` (Shading), `contours` (Contours (50/80/95% of points)), `hexbin` (Hexagonal bins) |
| Bandwidth (px) | `bandwidth` | Number |
| Hexagon Size (px) | `hexSize` | Number |
| Opacity (%) | `opacity` | Number |
| Palette | `palette` | `theme` (Theme), `heat` (Heat), `mono` (Grey) |
| Show Points | `showPoints` | On / off |

### Small Multiples (`smallMultiples`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Columns (0 = Auto): Premium. Bind a field to Small Multiples: one panel per value, statistics per panel. | `columns` | Number |
| Shared Axes | `sharedAxes` | On / off |
| Panel Title Size | `titleSize` | Number |
| Panel Title Color | `titleColor` | Colour |

### Reference Lines (`referenceLines`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| X Constant | `xConstant` | On / off |
| X Constant Value | `xConstantValue` | Number |
| X Mean | `xMean` | On / off |
| X Median | `xMedian` | On / off |
| Y Constant | `yConstant` | On / off |
| Y Constant Value | `yConstantValue` | Number |
| Y Mean | `yMean` | On / off |
| Y Median | `yMedian` | On / off |
| X Min And Max | `xMinMax` | On / off |
| Y Min And Max | `yMinMax` | On / off |
| X Percentile | `xPercentile` | On / off |
| X Percentile (%) | `xPercentileValue` | Number |
| Y Percentile | `yPercentile` | On / off |
| Y Percentile (%) | `yPercentileValue` | Number |
| y = x Line | `symmetry` | On / off |
| Symmetry Shading: Shade the areas above and below y = x. | `symmetryShading` | On / off |
| Ratio Line (y = k·x) | `ratio` | On / off |
| Ratio k | `ratioValue` | Number |
| Line Color | `lineColor` | Colour |
| Line Width | `lineWidth` | Number |
| Style | `lineStyle` | `solid` (Solid), `dashed` (Dashed), `dotted` (Dotted) |

### Play Axis (`playAxis`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Frame Duration (ms) | `speed` | Number |
| Loop | `loop` | On / off |
| Trails | `trails` | `none` (None), `selected` (Selected points), `all` (All points) |
| Start Frame: The frame shown when the report opens (and in exports). | `startFrame` | `last` (Latest), `first` (First) |
| Font Size | `fontSize` | Number |
| Frame Name: The current frame (e.g. the year) drawn large and faint behind the points. | `frameName` | On / off |
| Frame Name Size (0 = Auto) | `frameNameSize` | Number |

### Annotations (`annotations`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show: Bind a text field to Annotation: points with a value get a callout. | `show` | On / off |
| Font Size | `fontSize` | Number |
| Font Color | `fontColor` | Colour |
| Callout Box | `background` | On / off |

### Interaction (`interaction`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Lasso Select (Shift + Drag) | `lasso` | On / off |
| Zoom (Wheel) And Pan (Drag): Double-click resets the view. | `zoom` | On / off |
| Jitter | `jitter` | On / off |
| Jitter Amount (%) | `jitterAmount` | Number |
| Zoom Hint: "Zoomed: double-click to reset" after zooming; drawn in the footnote's size and colour. | `zoomHint` | On / off |

### Caption (`caption`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Font Size | `fontSize` | Number |
| Font Color | `fontColor` | Colour |

### Footnote (`footnote`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Font Size | `fontSize` | Number |
| Font Color | `fontColor` | Colour |

### Accessibility (`accessibility`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Focus Outline Color: Empty follows the theme; high contrast always uses the system colour. | `focusColor` | Colour |
| Focus Outline Width (px) | `focusWidth` | Number |
| Minimum Text Size (px): No text is drawn smaller than this. | `minFontSize` | Number |
| Reduce Motion: With reduced motion the play axis never advances on its own; Play steps one frame. | `reduceMotion` | `system` (Follow system setting), `always` (Always), `off` (Off) |
| Shapes By Series: Distinct marker shapes per legend value, so meaning never depends on colour alone. | `nonColorCue` | On / off |

### Data Colors (`dataColors`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Color | `fill` | Colour |
