textscatter — Create a 2-D text scatter chart from x/y coordinates and text labels.

textscatter(x,y,str) creates a text scatter chart with labels from str at matching x/y coordinates. textscatter(xy,str) accepts an N-by-2 coordinate matrix. The returned handle provides chart data and display properties.

Syntax

ts = textscatter(x, y, str)
ts = textscatter(xy, str)
ts = textscatter(ax, ...)
ts = textscatter(..., Name, Value)

Inputs

Returns

Errors

How textscatter works

• x, y, and str must have equal element counts.
• xy must be an N-by-2 matrix whose first and second columns provide x and y coordinates.
• Coordinates can use single, double, or any of the eight integer classes. XData and YData retain their native class, shape, and exact values.
• str can be a string scalar, string array, character row, character matrix, or cell array of text scalars.
• The axes-target form textscatter(ax,...) renders into the supplied axes handle.
• TextDensityPercentage controls how many labels are visible; 0 hides all text labels and 100 shows all labels and suppresses marker creation.
• MaxTextLength truncates long labels and adds ... at the truncation point.
• MarkerColor accepts auto, none, or an RGB color. ColorData accepts an RGB triplet or N-by-3 RGB matrix for text colors.
• get supports Type, Parent, Children, TextData, XData, YData, ZData, TextDensityPercentage, MaxTextLength, MarkerColor, MarkerSize, ColorData, Colors, Visible, DisplayName, and Tag; 2-D charts report empty ZData.
• set supports TextData, XData, YData, TextDensityPercentage, MaxTextLength, MarkerColor, MarkerSize, ColorData, Colors, Visible, Color, FontSize, FontWeight, FontAngle, and Interpreter. ZData mutation is reserved for textscatter3 charts.
• Categorical ColorData, datasource properties, callbacks, app data, and interactive data-tip template objects are not implemented yet and raise explicit unsupported-property errors.
• Typed-integer numeric axes aliases and explicit gpuArray inputs are RunMat-mode extensions.

Examples

Create a 2-D text scatter chart

x = [1 2 3];
y = [4 5 6];
words = ["one" "two" "three"];
ts = textscatter(x, y, words);

Use an N-by-2 coordinate matrix

xy = [1 4; 2 5; 3 6];
textscatter(xy, ["one" "two" "three"]);

Limit label length and color each label

xy = [1 1; 2 2; 3 3];
colors = [1 0 0; 0 1 0; 0 0 1];
ts = textscatter(xy, ["alphabet" "betatron" "gamma"], 'MaxTextLength', 5, 'ColorData', colors);
get(ts, 'TextData')

Using textscatter with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how textscatter changes the result.

FAQ

Related Plotting functions

Open-source implementation

Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how textscatter is executed, line by line, in Rust.

• View the source for textscatter in Rust on GitHub
• Learn how the RunMat runtime works
• Found a bug? Open an issue with a minimal reproduction.

About RunMat

RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 license.

• RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
• Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.

Getting started · Benchmarks · Pricing