Skip to main content

Squillify development is paused indefinitely. Read why, and discover what this experiment achieved. Read the story

MicroSkills Reference

Scatter plot

chart.scatter

ProductionBounded custom (Class B)Deterministicstrictmoderatev1.0.0
No network

Overview

Render supplied exact points, groups, references, and analytical overlays without estimating correlation, regression, confidence, density, or bins. svg is a complete static, script-free chart. Mark highlight, the dotted guide, and the value panel are not in that SVG, and entry motion, focus, and updates stay inactive there. Pass the entire output.behavior.artifact unchanged to SquillifyChartRuntime.mount(container, artifact, options), then call the returned handle's replay() once to play the entry. A later value change uses update(nextArtifact, {intent}). Injecting svg directly leaves hover and motion off. Interaction is on by default for every host chart: after mount, pointer and keyboard focus open the value panel and the dotted guide. Set behavior.interaction.enabled to false to turn that off. motion.preset accepts only the family's entrance.

Exact relationship graphics need deterministic scales and a refusal boundary without silently adding statistical claims.

Reliability

We preserve your input order and duplicate coordinates; exact decimals remain canonical and identical resolved input produces byte-identical safe SVG. Declared failures: SCATTER_POINT_INVALID — trigger: a point id, exact coordinate, label, or item bound is invalid; retryable: no; unchanged input: will not succeed; next: follow the recovery intent in the error details. SCATTER_GROUP_INVALID — trigger: a group id repeats or a point references an absent group; retryable: no; unchanged input: will not succeed; next: follow the recovery intent in the error details. SCATTER_SCALE_INVALID — trigger: an exact axis domain or requested scale cannot represent the supplied values; retryable: no; unchanged input: will not succeed; next: follow the recovery intent in the error details. SCATTER_REFERENCE_INVALID — trigger: a reference line or region is outside the exact axis contract; retryable: no; unchanged input: will not succeed; next: follow the recovery intent in the error details. SCATTER_OVERLAY_INVALID — trigger: an overlay type, vertex, provenance label, or item bound is invalid; retryable: no; unchanged input: will not succeed; next: follow the recovery intent in the error details. CHART_CAPACITY_EXCEEDED — trigger: the supplied points, labels, references, overlays, or targets cannot fit the requested canvas; retryable: no; unchanged input: will not succeed; next: follow the recovery intent in the error details. CHART_OUTPUT_TOO_LARGE — trigger: the inline SVG byte budget would be exceeded at the requested size and data density; retryable: no; unchanged input: will not succeed; next: follow the recovery intent in the error details. CHART_THEME_UNKNOWN — trigger: theme or surface names a visual language we do not register for this chart family; retryable: no; unchanged input: will not succeed; next: follow the recovery intent in the error details. CHART_UNSAFE_OUTPUT — trigger: the finished SVG failed our final safety re-validation (this is on us, not your data); retryable: no; unchanged input: will not succeed; next: contact support with the request id — retrying the same input will not help. CHART_OUTPUT_TOO_COMPLEX — trigger: the render hit a structural complexity ceiling (elements, depth, text volume, or path commands) separate from the byte budget; retryable: no; unchanged input: will not succeed; next: contact support with the request id — retrying the same input will not help.

Context footprint

Invalid points, groups, scales, references, and overlays return stable SCATTER_* failures. Capacity refusal occurs before expensive layout. A successful call costs 3 execution credits.

When to use it

When x/y values and any analytical overlay already exist upstream.

When the skill is expected to estimate, aggregate, or sample.

Scope

Note
One bounded exact x/y point set with optional categorical groups and caller-supplied references or analytical overlays.

Non-goals

  • Estimating correlation or regression
  • Sampling, binning, clustering, or jitter
  • Encoding quantitative mark size
  • Calculating confidence ellipses or marginals

Properties

IdempotentRetry safeStreaming supportedFile input supportedRequires external service

Capabilities

generationimage-processing

Cost & billing

Flat rate per invocation

MetercallsBillable onsuccessCost per call3 credits

File handling

Accepts file_refProduces file_refMax input1.9 MB

How we handle your data

Sensitive output possible
What this means

This skill may receive sensitive content and may return submitted, transformed, extracted, or reformatted content.

Squillify guarantees
  • Runs inside Squillify
  • This skill runs inside Squillify.
  • Payloads are not sent to an external service by this skill.
  • Squillify does not permanently store submitted payloads.
  • Telemetry records metadata only, not submitted content.
  • Submitted payloads are not used for training.
  • Submitted payloads are not reviewed by humans.
  • This skill does not target sensitive data.
  • The response may contain submitted or transformed content.
Your responsibility

Squillify does not determine whether submitted content is sensitive. Your application is responsible for deciding what data it is allowed to submit. Your application is responsible for securing the response.

Read the Microskill Data Handling Policy

Input schema

FieldTypeRequiredDescription
pointsarrayYes1..20000 closed points with unique id and exact decimal-string x/y; optional group, label, meaning, and annotation.
groupsarrayNoOptional array of 0..24 objects with unique id and optional label in caller legend order; omit it when points are ungrouped.
xAxisobjectNoClosed exact quantitative axis: label, linear/log10/symlog scale, exact domain, ticks, format, grid, and reversal; omit it for an inferred linear domain.
yAxisobjectNoOptional object with label, linear/log10/symlog scale, exact domain, ticks, format, grid, and reversal; omit for an inferred linear domain.
labelsobjectNoOptional object with mode none, selected, or all and unique pointIds for selected mode; default none when omitted.
referenceLinesarrayNoCaller-supplied exact x/y reference coordinates; 24 references combined and no lines are drawn when omitted.
referenceRegionsarrayNoCaller-supplied exact bounded x/y regions; 24 references combined and no regions are drawn when omitted.
overlaysarrayNoAt most 12 supplied line, ellipse, or marginal overlays with provenanceLabel; omit it for no overlays.
legendobjectNoClosed visible setting; defaults visible with more than one group.
layoutobjectNoClosed margin, plotPadding, and reject/hideOptionalLabels policy; omit it for certified default plot geometry.
widthintegerNoCanvas width in pixels, 100..1600 (optional; default 800). Outside that range the request is refused as invalid input rather than clamped. The ceiling is the size a chart is read at — a full-HD dashboard or a report page; beyond it the canvas stops being what limits how much fits, and type sized for the canvas is illegible once the export is displayed smaller. It applies per side, so a tall portrait canvas for a long horizontal ranking is allowed.
heightintegerNoCanvas height in pixels, 100..1600 (optional; default 500). Outside that range the request is refused as invalid input rather than clamped. The ceiling is the size a chart is read at — a full-HD dashboard or a report page; beyond it the canvas stops being what limits how much fits, and type sized for the canvas is illegible once the export is displayed smaller. It applies per side, so a tall portrait canvas for a long horizontal ranking is allowed.
titlestringNoHeading drawn above the plot (optional; at most 1024 code points). Omit it and the chart renders untitled — we never invent a title from your data. One code point past that ceiling is refused as TOOL_INPUT_INVALID.
subtitlestringNoSecond line under the title, useful for the period covered or the unit (optional; at most 1024 code points). Omit it and no second line is drawn.
captionstringNoOptional bounded caption drawn below the plot; omit it and no caption is emitted.
sourcestringNoOptional bounded source attribution; omit it and no source line is emitted.
periodstringNoOptional bounded reporting-period label; omit it and no period line is emitted.
themestringNoVisual language: basic, modern or squillify (optional; default squillify). An unregistered value is rejected with the registered names listed — we never substitute silently.
surfacestringNoSurface the theme renders on: dark or light (optional; default light).
densitystringNoHow tightly the chrome is packed: compact, standard or spacious (optional; default standard). Density scales spacing only — it never lowers a legibility minimum.
visualProfilestringNoWhat the SVG promises about the host font: portable or certified (optional; default portable). The default is layout-deterministic and tolerates substitution; certified refuses text the certified metrics cannot fully measure.
localizationobjectNoOptional closed object with locale and number-format properties for visible text only; omit it for the default locale.
styleobjectNoOptional bounded paint and typography styling; omit it to use the selected theme defaults. text.size is expressed in normalized design pixels at an 800-pixel reference width, so equivalent roles match at equal CSS width. It never changes data or accessibility. 'contract' selects the published semantics. 'tokens' sets design tokens; 'rules' applies typed properties to a role and optional series/category facets; 'palette' accepts a digest-checked palette; 'css' is a bounded post-layout stylesheet. The styleCapabilities section publishes this family's accepted roles, properties and copyable examples. For Bar, target one mark with role 'bar' plus seriesIndex and categoryIndex; categoryIndex alone targets that category across series. A minimal rule is {"target":{"role":"bar"},"set":{"paint.fill":"#2563eb"}}. Unsupported typed rules are refused; unsupported CSS is dropped and reported. Do not discover the grammar through trial calls: style validation failures are currently billable. Before calling, read this contract's styleSurface and styleCapabilities sections for the complete rule shape, accepted roles and properties, limits, and copyable examples.
behaviorobjectNoOptional object for enter_points, update_points, focus_point, focus_group, or trace_points; omit for static SVG. svg is a complete static, script-free chart. Mark highlight, the dotted guide, and the value panel are not in that SVG, and entry motion, focus, and updates stay inactive there. Pass the entire output.behavior.artifact unchanged to SquillifyChartRuntime.mount(container, artifact, options), then call the returned handle's replay() once to play the entry. A later value change uses update(nextArtifact, {intent}). Injecting svg directly leaves hover and motion off. Interaction is on by default for every host chart: after mount, pointer and keyboard focus open the value panel and the dotted guide. Set behavior.interaction.enabled to false to turn that off. motion.preset accepts only the family's entrance.
accessibilityobjectNoOptional object with detail and maxItems properties; omit it for the default bounded point reading order.
outputobjectNoOutput scoping (optional). Nested key output.idNamespace ([a-z][a-z0-9-]{0,31}) is prefixed onto every generated element id when several charts share one host document; omit for a standalone chart. An invalid namespace is rejected.

Output schema

FieldTypeRequiredDescription
svgstringYesAllowlist-checked SVG document. svg is a complete static, script-free chart. Mark highlight, the dotted guide, and the value panel are not in that SVG, and entry motion, focus, and updates stay inactive there. Pass the entire output.behavior.artifact unchanged to SquillifyChartRuntime.mount(container, artifact, options), then call the returned handle's replay() once to play the entry. A later value change uses update(nextArtifact, {intent}). Injecting svg directly leaves hover and motion off. Interaction is on by default for every host chart: after mount, pointer and keyboard focus open the value panel and the dotted guide. Set behavior.interaction.enabled to false to turn that off. motion.preset accepts only the family's entrance.
widthintegerYesRendered width in pixels.
heightintegerYesRendered height in pixels.
viewBoxstringYesRendered SVG viewBox.
pointResultsarrayYesCaller-order exact point values, projected target keys, and label states.
groupResultsarrayYesArray of caller-order group objects with id, label, point count, and exact x/y extents.
axisResultsobjectYesResolved exact domains, scale types, reversal, and tick values.
overlayResultsarrayYesCaller-supplied overlay identity, type, provenance, and vertex count.
accessibilityobjectNoResolved title, detail rung, and exact-coordinate description.
renderSummaryobjectYesObject with bounded point, group, reference, overlay, label, and target counts or flags.
transformationSummaryobjectYesAlways-present adaptation summary; never reports sampling or inference.
styleReportobjectNoAlways reports the resolved typographyProfile and fontMetrics contract, plus tokensApplied, rulesApplied, typedRulesApplied, typedAssignmentsApplied, rulesDropped, declarationsDropped and, when anything was dropped, a bounded list of reasons.
warningsarrayNoPresent when the render succeeded with a known degradation. Each entry is an object with a stable code, a message and details. Every chart can emit FONT_SUBSTITUTION_POSSIBLE under visualProfile 'portable', FONT_GLYPH_UNMEASURED when a code point falls outside the certified metrics, and CHART_STYLE_PARTIALLY_APPLIED when part of your styling was dropped — styleReport then names which part and why. Codes are stable for agent routing.
behaviorobjectNoResolved default-on motion and interaction report. Includes the digest-bound host artifact when behavior is enabled and always preserves a complete script-free SVG. svg is a complete static, script-free chart. Mark highlight, the dotted guide, and the value panel are not in that SVG, and entry motion, focus, and updates stay inactive there. Pass the entire output.behavior.artifact unchanged to SquillifyChartRuntime.mount(container, artifact, options), then call the returned handle's replay() once to play the entry. A later value change uses update(nextArtifact, {intent}). Injecting svg directly leaves hover and motion off. Interaction is on by default for every host chart: after mount, pointer and keyboard focus open the value panel and the dotted guide. Set behavior.interaction.enabled to false to turn that off. motion.preset accepts only the family's entrance.

API contract

POST /v1/execute
curl
curl -sS -X POST "$BASE/v1/execute" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"skillKey":"chart.scatter","input":{"points":[{"id":"a","x":"12.5","y":"41"}],"xAxis":{"label":"Cost"},"yAxis":{"label":"Retention"}}}'
Integrations
TypeScript SDK
import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("chart.scatter", {"points":[{"x":"12.5","y":"41","label":"Belgium","id":"be-1","group":"north"},{"x":"18","y":"37.25","label":"France","id":"fr-1","group":"south"}],"xAxis":{"label":"Acquisition cost"},"groups":[{"label":"Northern market","id":"north"},{"label":"Southern market","id":"south"}],"yAxis":{"label":"Retention"},"title":"Acquisition and retention"});

Errors

CodeHTTPRetryableDescription
VALIDATION_ERROR400NoThe request payload failed schema validation.
UNAUTHORIZED401NoMissing or invalid API key.
SKILL_NOT_ACCESSIBLE403NoThe API key is not granted access to this skill.
SKILL_NOT_AVAILABLE_FOR_PLAN403NoThis skill is not included in your current plan.
PLAN_ELIGIBILITY_UNAVAILABLE503YesPlan eligibility could not be decided. Retry after backoff.
SKILL_NOT_FOUND404NoThe requested skill or version does not exist.
TENANT_RATE_LIMITED429YesRequest rate limit exceeded. Retry after backoff.
QUOTA_EXCEEDED429YesPlan quota exhausted. Retryable once the quota period resets.
EXECUTION_TIMEOUT504YesExecution exceeded the allowed time budget.
SCATTER_POINT_INVALID400NoThe request payload failed this skill's input validation.
SCATTER_GROUP_INVALID400NoThe request payload failed this skill's input validation.
SCATTER_SCALE_INVALID400NoThe request payload failed this skill's input validation.
SCATTER_REFERENCE_INVALID400NoThe request payload failed this skill's input validation.
SCATTER_OVERLAY_INVALID400NoThe request payload failed this skill's input validation.
CHART_CAPACITY_EXCEEDED429NoA size, quota, rate, or time limit was exceeded.
CHART_OUTPUT_TOO_LARGE429NoA size, quota, rate, or time limit was exceeded.
CHART_THEME_UNKNOWN400NoThe request payload failed this skill's input validation.
CHART_UNSAFE_OUTPUT500NoThe skill encountered an unexpected execution failure.
CHART_OUTPUT_TOO_COMPLEX500NoThe skill encountered an unexpected execution failure.

Other limits

LimitValue
Recommended inline bytes32 KiB

Limitations

  • Estimating correlation or regression
  • Sampling, binning, clustering, or jitter
  • Encoding quantitative mark size
  • Calculating confidence ellipses or marginals
  • A third quantitative size variable
  • Ordered continuity
  • Upstream aggregation or inferred statistics

How to call

POST /v1/execute (requires authentication)

Request bodyjson
{
  "skillKey": "chart.scatter",
  "input": {
    "points": [
      {
        "x": "12.5",
        "y": "41",
        "label": "Belgium",
        "id": "be-1",
        "group": "north"
      },
      {
        "x": "18",
        "y": "37.25",
        "label": "France",
        "id": "fr-1",
        "group": "south"
      }
    ],
    "xAxis": {
      "label": "Acquisition cost"
    },
    "groups": [
      {
        "label": "Northern market",
        "id": "north"
      },
      {
        "label": "Southern market",
        "id": "south"
      }
    ],
    "yAxis": {
      "label": "Retention"
    },
    "title": "Acquisition and retention"
  }
}

Examples

Acquisition and retention

Inputjson
{
  "points": [
    {
      "x": "12.5",
      "y": "41",
      "label": "Belgium",
      "id": "be-1",
      "group": "north"
    },
    {
      "x": "18",
      "y": "37.25",
      "label": "France",
      "id": "fr-1",
      "group": "south"
    }
  ],
  "xAxis": {
    "label": "Acquisition cost"
  },
  "groups": [
    {
      "label": "Northern market",
      "id": "north"
    },
    {
      "label": "Southern market",
      "id": "south"
    }
  ],
  "yAxis": {
    "label": "Retention"
  },
  "title": "Acquisition and retention"
}
Expected outputjson
{
  "axisResults": {
    "x": {
      "min": "12.225",
      "reversed": false,
      "label": "Acquisition cost",
      "max": "18.275",
      "grid": true,
      "ticks": [
        "12.225",
        "13.435",
        "14.645",
        "15.855",
        "17.065",
        "18.275"
      ],
      "explicitDomain": false,
      "scale": "linear"
    },
    "y": {
      "min": "37.0625",
      "reversed": false,
      "label": "Retention",
      "max": "41.1875",
      "grid": true,
      "ticks": [
        "37.0625",
        "37.8875",
        "38.7125",
        "39.5375",
        "40.3625",
        "41.1875"
      ],
      "explicitDomain": false,
      "scale": "linear"
    }
  },
  "pointResults": [
    {
      "id": "be-1",
      "x": "12.5",
      "y": "41",
      "group": "north",
      "inputIndex": 0,
      "targetKey": "t-scatter-point-c632ba047683bc57",
      "labelState": "notRequested",
      "meaning": null,
      "projectedX": 178.864,
      "projectedY": 53.182
    },
    {
      "id": "fr-1",
      "x": "18",
      "y": "37.25",
      "group": "south",
      "inputIndex": 1,
      "targetKey": "t-scatter-point-49424593e0c987a6",
      "labelState": "notRequested",
      "meaning": null,
      "projectedX": 616.136,
      "projectedY": 436.818
    }
  ],
  "overlayResults": [],
  "accessibility": {
    "title": "Acquisition and retention",
    "detail": "full",
    "description": "Scatter plot. 2 exact observations; x scale linear, y scale linear; 2 declared groups. Points: Belgium x 12.5 y 41 41, France x 18 y 37.25 37.25. All values are listed."
  },
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"800\" height=\"500\" viewBox=\"0 0 800 500\" role=\"img\" class=\"sq-chart sq-chart--scatter sq-family--cartesian sq-theme--squillify sq-surface--light sq-density--standard\" data-sq-style-contract=\"CHART_STYLE@1\" data-sq-chart=\"scatter\" data-sq-family=\"cartesian\" data-sq-theme=\"squillify\" data-sq-theme-version=\"1\" data-sq-surface=\"light\" data-sq-density=\"standard\" data-sq-a11y-detail=\"full\" aria-labelledby=\"sq-ff36662e9ae1-title-0 sq-ff36662e9ae1-desc-1\"><title id=\"sq-ff36662e9ae1-title-0\">Acquisition and retention</title><desc id=\"sq-ff36662e9ae1-desc-1\">Scatter plot. 2 exact observations; x scale linear, y scale linear; 2 declared groups. Points: Belgium x 12.5 y 41 41, France x 18 y 37.25 37.25. All values are listed.</desc><style>.sq-chart{--sq-chart-axis:#c9d1df;--sq-chart-font-family:'Squillify Mono', 'IBM Plex Mono', monospace;--sq-chart-grid:#d8dee9;--sq-chart-surface:#ffffff;--sq-chart-text-muted:#667085;--sq-chart-text-primary:#101828;--sq-series-1:#2563eb;--sq-series-2:#6d5ce7;--sq-series-3:#168a5b;--sq-series-4:#c45412;--sq-series-5:#d92d20;--sq-series-6:#667085;font-family:var(--sq-chart-font-family);font-weight:500;}.sq-chart .sq-background{fill:var(--sq-chart-surface);}.sq-chart .sq-grid{stroke:var(--sq-chart-grid);}.sq-chart .sq-axis{stroke:var(--sq-chart-axis);}.sq-chart .sq-title{fill:var(--sq-chart-text-primary);}.sq-chart .sq-tick-label{fill:var(--sq-chart-text-muted);}.sq-chart .sq-legend-label{fill:var(--sq-chart-text-primary);}.sq-chart .sq-point[data-sq-palette-index=\"0\"]{fill:var(--sq-series-1);}.sq-chart .sq-point[data-sq-palette-index=\"1\"]{fill:var(--sq-series-2);}</style><rect x=\"0\" y=\"0\" width=\"800\" height=\"500\" fill=\"#ffffff\" class=\"sq-background\" data-sq-role=\"background\"/><g class=\"sq-plot\" data-sq-role=\"plot\"><line x1=\"157\" y1=\"34\" x2=\"157\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"157\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"36\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">12.225</text><line x1=\"253.2\" y1=\"34\" x2=\"253.2\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"253.2\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"36\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">13.435</text><line x1=\"349.4\" y1=\"34\" x2=\"349.4\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"349.4\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"36\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">14.645</text><line x1=\"445.6\" y1=\"34\" x2=\"445.6\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"445.6\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"36\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">15.855</text><line x1=\"541.8\" y1=\"34\" x2=\"541.8\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"541.8\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"36\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">17.065</text><line x1=\"638\" y1=\"34\" x2=\"638\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"638\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"36\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">18.275</text><line x1=\"157\" y1=\"456\" x2=\"638\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"459.5\" font-size=\"10\" text-anchor=\"end\" textLength=\"42\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">37.0625</text><line x1=\"157\" y1=\"371.6\" x2=\"638\" y2=\"371.6\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"375.1\" font-size=\"10\" text-anchor=\"end\" textLength=\"42\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">37.8875</text><line x1=\"157\" y1=\"287.2\" x2=\"638\" y2=\"287.2\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"290.7\" font-size=\"10\" text-anchor=\"end\" textLength=\"42\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">38.7125</text><line x1=\"157\" y1=\"202.8\" x2=\"638\" y2=\"202.8\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"206.3\" font-size=\"10\" text-anchor=\"end\" textLength=\"42\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">39.5375</text><line x1=\"157\" y1=\"118.4\" x2=\"638\" y2=\"118.4\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"121.9\" font-size=\"10\" text-anchor=\"end\" textLength=\"42\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">40.3625</text><line x1=\"157\" y1=\"34\" x2=\"638\" y2=\"34\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"37.5\" font-size=\"10\" text-anchor=\"end\" textLength=\"42\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">41.1875</text><line x1=\"157\" y1=\"456\" x2=\"638\" y2=\"456\" stroke=\"#c9d1df\" stroke-width=\"1\" class=\"sq-axis\" data-sq-role=\"axis-line\"/><line x1=\"157\" y1=\"34\" x2=\"157\" y2=\"456\" stroke=\"#c9d1df\" stroke-width=\"1\" class=\"sq-axis\" data-sq-role=\"axis-line\"/><text x=\"397.5\" y=\"488\" font-size=\"10\" text-anchor=\"middle\" textLength=\"96\" lengthAdjust=\"spacing\" fill=\"#101828\" class=\"sq-label\" data-sq-role=\"axis-title\">Acquisition cost</text><text x=\"12\" y=\"29\" font-size=\"10\" text-anchor=\"start\" textLength=\"54\" lengthAdjust=\"spacing\" fill=\"#101828\" class=\"sq-label\" data-sq-role=\"axis-title\">Retention</text><rect x=\"175.364\" y=\"49.682\" width=\"7\" height=\"7\" rx=\"3.5\" fill=\"#2563eb\" class=\"sq-mark sq-point\" data-sq-role=\"point\" data-sq-target-key=\"t-scatter-point-c632ba047683bc57\" data-sq-series-index=\"0\" data-sq-point-index=\"0\" data-sq-palette-index=\"0\"/><path d=\"M 616.136 433.318 L 619.636 436.818 L 616.136 440.318 L 612.636 436.818 Z\" fill=\"#6d5ce7\" class=\"sq-mark sq-point\" data-sq-role=\"point\" data-sq-target-key=\"t-scatter-point-49424593e0c987a6\" data-sq-series-index=\"1\" data-sq-point-index=\"1\" data-sq-palette-index=\"1\"/><rect x=\"651\" y=\"35\" width=\"6\" height=\"6\" rx=\"3\" fill=\"#2563eb\" class=\"sq-mark sq-point\" data-sq-role=\"legend-swatch\" data-sq-series-index=\"0\" data-sq-palette-index=\"0\"/><text x=\"662\" y=\"44\" font-size=\"10\" text-anchor=\"start\" textLength=\"90\" lengthAdjust=\"spacing\" fill=\"#101828\" class=\"sq-legend-label\" data-sq-role=\"legend-label\" data-sq-series-index=\"0\">Northern market</text><path d=\"M 654 52 L 657 55 L 654 58 L 651 55 Z\" fill=\"#6d5ce7\" class=\"sq-mark sq-point\" data-sq-role=\"legend-swatch\" data-sq-series-index=\"1\" data-sq-palette-index=\"1\"/><text x=\"662\" y=\"61\" font-size=\"10\" text-anchor=\"start\" textLength=\"90\" lengthAdjust=\"spacing\" fill=\"#101828\" class=\"sq-legend-label\" data-sq-role=\"legend-label\" data-sq-series-index=\"1\">Southern market</text><text x=\"400\" y=\"28\" font-size=\"16\" text-anchor=\"middle\" fill=\"#101828\" class=\"sq-title\" data-sq-role=\"title\">Acquisition and retention</text></g></svg>",
  "renderSummary": {
    "variation": "scatter",
    "pointCount": 2,
    "groupCount": 2,
    "referenceCount": 0,
    "overlayCount": 0,
    "visibleLabelCount": 0,
    "xScale": "linear",
    "yScale": "linear",
    "overplotRisk": false
  },
  "viewBox": "0 0 800 500",
  "width": 800,
  "groupResults": [
    {
      "id": "north",
      "label": "Northern market",
      "count": 1,
      "xMin": "12.5",
      "xMax": "12.5",
      "yMin": "41",
      "yMax": "41"
    },
    {
      "id": "south",
      "label": "Southern market",
      "count": 1,
      "xMin": "18",
      "xMax": "18",
      "yMin": "37.25",
      "yMax": "37.25"
    }
  ],
  "transformationSummary": {
    "applied": false,
    "operations": [],
    "affectedCategoryCount": 0,
    "affectedPointCount": 0,
    "affectedLabelCount": 0
  },
  "height": 500
}

Exact duplicate coordinates

Inputjson
{
  "points": [
    {
      "x": "10",
      "id": "first",
      "y": "20"
    },
    {
      "x": "10",
      "id": "second",
      "y": "20"
    }
  ]
}
Expected outputjson
{
  "axisResults": {
    "x": {
      "min": "9",
      "reversed": false,
      "label": "",
      "max": "11",
      "grid": true,
      "ticks": [
        "9",
        "9.4",
        "9.8",
        "10.2",
        "10.6",
        "11"
      ],
      "explicitDomain": false,
      "scale": "linear"
    },
    "y": {
      "min": "18",
      "reversed": false,
      "label": "",
      "max": "22",
      "grid": true,
      "ticks": [
        "18",
        "18.8",
        "19.6",
        "20.4",
        "21.2",
        "22"
      ],
      "explicitDomain": false,
      "scale": "linear"
    }
  },
  "pointResults": [
    {
      "id": "first",
      "x": "10",
      "y": "20",
      "group": null,
      "inputIndex": 0,
      "targetKey": "t-scatter-point-45b8c57eef511f43",
      "labelState": "notRequested",
      "meaning": null,
      "projectedX": 472.5,
      "projectedY": 234
    },
    {
      "id": "second",
      "x": "10",
      "y": "20",
      "group": null,
      "inputIndex": 1,
      "targetKey": "t-scatter-point-619b9d1ef7661fdf",
      "labelState": "notRequested",
      "meaning": null,
      "projectedX": 472.5,
      "projectedY": 234
    }
  ],
  "overlayResults": [],
  "accessibility": {
    "title": "Scatter plot with 2 points",
    "detail": "full",
    "description": "Scatter plot. 2 exact observations; x scale linear, y scale linear; 0 declared groups. Points: first x 10 y 20 20, second x 10 y 20 20. All values are listed."
  },
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"800\" height=\"500\" viewBox=\"0 0 800 500\" role=\"img\" class=\"sq-chart sq-chart--scatter sq-family--cartesian sq-theme--squillify sq-surface--light sq-density--standard\" data-sq-style-contract=\"CHART_STYLE@1\" data-sq-chart=\"scatter\" data-sq-family=\"cartesian\" data-sq-theme=\"squillify\" data-sq-theme-version=\"1\" data-sq-surface=\"light\" data-sq-density=\"standard\" data-sq-a11y-detail=\"full\" aria-labelledby=\"sq-ec57d4fb0181-title-0 sq-ec57d4fb0181-desc-1\"><title id=\"sq-ec57d4fb0181-title-0\">Scatter plot with 2 points</title><desc id=\"sq-ec57d4fb0181-desc-1\">Scatter plot. 2 exact observations; x scale linear, y scale linear; 0 declared groups. Points: first x 10 y 20 20, second x 10 y 20 20. All values are listed.</desc><style>.sq-chart{--sq-chart-axis:#c9d1df;--sq-chart-font-family:'Squillify Mono', 'IBM Plex Mono', monospace;--sq-chart-grid:#d8dee9;--sq-chart-surface:#ffffff;--sq-chart-text-muted:#667085;--sq-chart-text-primary:#101828;--sq-series-1:#2563eb;--sq-series-2:#6d5ce7;--sq-series-3:#168a5b;--sq-series-4:#c45412;--sq-series-5:#d92d20;--sq-series-6:#667085;font-family:var(--sq-chart-font-family);font-weight:500;}.sq-chart .sq-background{fill:var(--sq-chart-surface);}.sq-chart .sq-grid{stroke:var(--sq-chart-grid);}.sq-chart .sq-axis{stroke:var(--sq-chart-axis);}.sq-chart .sq-tick-label{fill:var(--sq-chart-text-muted);}.sq-chart .sq-point[data-sq-palette-index=\"0\"]{fill:var(--sq-series-1);}</style><rect x=\"0\" y=\"0\" width=\"800\" height=\"500\" fill=\"#ffffff\" class=\"sq-background\" data-sq-role=\"background\"/><g class=\"sq-plot\" data-sq-role=\"plot\"><line x1=\"157\" y1=\"12\" x2=\"157\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"157\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"6\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">9</text><line x1=\"283.2\" y1=\"12\" x2=\"283.2\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"283.2\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"18\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">9.4</text><line x1=\"409.4\" y1=\"12\" x2=\"409.4\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"409.4\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"18\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">9.8</text><line x1=\"535.6\" y1=\"12\" x2=\"535.6\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"535.6\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"24\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">10.2</text><line x1=\"661.8\" y1=\"12\" x2=\"661.8\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"661.8\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"24\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">10.6</text><line x1=\"788\" y1=\"12\" x2=\"788\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"788\" y=\"470\" font-size=\"10\" text-anchor=\"middle\" textLength=\"12\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">11</text><line x1=\"157\" y1=\"456\" x2=\"788\" y2=\"456\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"459.5\" font-size=\"10\" text-anchor=\"end\" textLength=\"12\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">18</text><line x1=\"157\" y1=\"367.2\" x2=\"788\" y2=\"367.2\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"370.7\" font-size=\"10\" text-anchor=\"end\" textLength=\"24\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">18.8</text><line x1=\"157\" y1=\"278.4\" x2=\"788\" y2=\"278.4\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"281.9\" font-size=\"10\" text-anchor=\"end\" textLength=\"24\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">19.6</text><line x1=\"157\" y1=\"189.6\" x2=\"788\" y2=\"189.6\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"193.1\" font-size=\"10\" text-anchor=\"end\" textLength=\"24\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">20.4</text><line x1=\"157\" y1=\"100.8\" x2=\"788\" y2=\"100.8\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"104.3\" font-size=\"10\" text-anchor=\"end\" textLength=\"24\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">21.2</text><line x1=\"157\" y1=\"12\" x2=\"788\" y2=\"12\" stroke=\"#d8dee9\" stroke-width=\"1\" class=\"sq-grid\" data-sq-role=\"grid-line\"/><text x=\"152\" y=\"15.5\" font-size=\"10\" text-anchor=\"end\" textLength=\"12\" lengthAdjust=\"spacing\" fill=\"#667085\" class=\"sq-label sq-tick-label\" data-sq-role=\"tick-label\">22</text><line x1=\"157\" y1=\"456\" x2=\"788\" y2=\"456\" stroke=\"#c9d1df\" stroke-width=\"1\" class=\"sq-axis\" data-sq-role=\"axis-line\"/><line x1=\"157\" y1=\"12\" x2=\"157\" y2=\"456\" stroke=\"#c9d1df\" stroke-width=\"1\" class=\"sq-axis\" data-sq-role=\"axis-line\"/><rect x=\"469\" y=\"230.5\" width=\"7\" height=\"7\" rx=\"3.5\" fill=\"#2563eb\" class=\"sq-mark sq-point\" data-sq-role=\"point\" data-sq-target-key=\"t-scatter-point-45b8c57eef511f43\" data-sq-series-index=\"0\" data-sq-point-index=\"0\" data-sq-palette-index=\"0\"/><rect x=\"469\" y=\"230.5\" width=\"7\" height=\"7\" rx=\"3.5\" fill=\"#2563eb\" class=\"sq-mark sq-point\" data-sq-role=\"point\" data-sq-target-key=\"t-scatter-point-619b9d1ef7661fdf\" data-sq-series-index=\"0\" data-sq-point-index=\"1\" data-sq-palette-index=\"0\"/></g></svg>",
  "renderSummary": {
    "variation": "scatter",
    "pointCount": 2,
    "groupCount": 0,
    "referenceCount": 0,
    "overlayCount": 0,
    "visibleLabelCount": 0,
    "xScale": "linear",
    "yScale": "linear",
    "overplotRisk": false
  },
  "viewBox": "0 0 800 500",
  "width": 800,
  "groupResults": [],
  "transformationSummary": {
    "applied": false,
    "operations": [],
    "affectedCategoryCount": 0,
    "affectedPointCount": 0,
    "affectedLabelCount": 0
  },
  "height": 500
}
  • Compare two supplied quantitative variables
  • Show exact grouped observations
  • Overlay caller-calculated analysis

Avoid for

  • A third quantitative size variable
  • Ordered continuity
  • Upstream aggregation or inferred statistics

Composable with

Safety & privacy

  • Runs without calling any external service.
  • Your payloads are never stored permanently.
  • Telemetry captures metadata only — never your payload contents.
  • We never train models on your payloads.
  • No human reviews your payloads.

Tags

svgrelationshipchartscattermultivariatevisualization