xticklabels — Query or set X-axis tick labels for the current axes or a specified axes handle.

xticklabels controls the display text associated with X-axis tick marks. It supports query, explicit label assignment, automatic mode, manual mode, mode query, and explicit axes-target forms.

Syntax

labels = xticklabels()
labels = xticklabels(labels)
mode = xticklabels(mode)
labels = xticklabels(ax, labels)

Inputs

NameTypeRequiredDefaultDescription
labelsAnyYesString array or cell array of character vectors for X-axis tick labels.
modeStringScalarYesTick label mode string: 'auto', 'manual', or 'mode'.
axAxesHandleYesTarget axes handle.

Returns

NameTypeDescription
labelsAnyCurrent X-axis tick labels as a cell array of character vectors.
modeStringScalarCurrent X-axis tick label mode, 'auto' or 'manual'.

Errors

IdentifierWhenMessage
RunMat:xticklabels:InvalidArgumentArgument count, tick label values, mode, or axes handle is invalid.xticklabels: invalid argument
RunMat:xticklabels:InternalInternal plotting state update fails.xticklabels: internal operation failed

GPU memory and residency

xticklabels only reads and writes axes metadata. It does not gather GPU-resident plot data; automatic labels are generated from current tick metadata and cached display bounds.

Examples

Set X-axis tick values and labels

plot(0:10, (0:10).^2);
xticks([0 5 10]);
xticklabels({'x = 0', 'x = 5', 'x = 10'});

Expected output:

% The X-axis shows the three supplied labels

Query and reset label mode

xticklabels({'A', 'B'});
xticklabels('mode')
xticklabels('auto');

Expected output:

ans = 'manual'
% Labels return to automatic numeric formatting

Set labels on a specific axes

ax = subplot(1, 2, 1);
plot(ax, 1:3);
xticks(ax, [1 2 3]);
xticklabels(ax, {'one', 'two', 'three'});

Expected output:

% Only the target axes receives the labels

Using xticklabels with coding agents

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

Run a small xticklabels example, explain the result, then change one input and compare the output.

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

Download RunMat

Download RunMat for full performance, or use RunMat in your browser for zero setup.