barh — Create horizontal bar charts in MATLAB and RunMat.

barh creates horizontal bar charts from scalar, vector, or matrix Y data, optionally at explicit X positions. It returns one bar handle per plotted series and supports grouped and stacked forms through the shared plotting handle-property system.

Syntax

h = barh(Y)
h = barh(Y, width)
h = barh(Y, width, color)
h = barh(Y, style)
h = barh(Y, Name, Value, ...)
h = barh(X, Y)

h = barh(Y)
h = barh(Y, width)
h = barh(Y, width, color)
h = barh(Y, style)
h = barh(Y, Name, Value, ...)
h = barh(X, Y)
h = barh(X, Y, width)
h = barh(X, Y, width, color)
h = barh(X, Y, style)
h = barh(X, Y, Name, Value, ...)

Inputs

Returns

Errors

How barh works

• Vector inputs create a single horizontal bar series with implicit category positions on the y-axis.
• Matrix inputs support grouped and stacked horizontal bar rendering workflows.
• Matrix Y returns a row vector containing one opaque bar handle per series; scalar and vector Y return one handle.
• X and Y accept all eight integer classes. Exact integer X labels and uniqueness are preserved before conversion into client graphics coordinates.
• The positional bar thickness defaults to 0.8 and, like the LineWidth property, accepts real numeric scalars including every integer class.
• Display names, bar width, and face color participate in the shared plotting object/property model.
• RunMat preserves the same fast GPU-backed rendering path as bar when inputs and style options can be handled by the shared bar vertex packer.

Does RunMat run barh on the GPU?

Floating single and double Y data can use the shared horizontal WGPU vertex-packing path.

All eight resident integer classes use exact client gather before the explicit floating graphics boundary.

The builtin is a plotting sink and fusion barrier.

GPU memory and residency

barh preserves floating GPU residency where the shared bar geometry pipeline can consume exported buffers directly. Integer GPU data gathers once through its owning provider so native integer buffers are never reinterpreted by the floating vertex shader.

Examples

Create a basic horizontal bar chart from a vector

values = [3 5 2 9];
barh(values);

Create grouped horizontal bars from a matrix

Y = [3 5 2; 4 6 1; 5 4 3];
barh(Y);

Create stacked horizontal bars

Y = [8 15 25; 30 35 40; 50 55 62];
barh(Y, 'stacked');

Style a horizontal bar object and label it for the legend

h = barh([2 4 1 5]);
set(h, 'FaceColor', 'g', 'DisplayName', 'counts');
legend;

Using barh with coding agents

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

FAQ

bar([3 5 2 9]);   % vertical bars
barh([3 5 2 9]);  % horizontal bars

Y = [3 5 2; 4 6 1; 5 4 3];
barh(Y);            % grouped
barh(Y, 'stacked'); % stacked

x = [1980 1990 2000];
y = [10 20 30];
barh(x, y);

Related Plotting functions

More plotting resources

• Choosing the right plot type
• Styling plots and axes
• Plot replay and export

Open-source implementation

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

• View the source for barh 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