median — Compute medians in MATLAB and RunMat.

median(X) returns median values along a dimension or across selected elements. Default dimension behavior and tie handling follow MATLAB semantics.

Syntax

M = median(A)
M = median(A, dim)
M = median(A, vecdim)
M = median(A, "all")
M = median(A, [])
M = median(A, nanflag)

M = median(A)
M = median(A, dim)
M = median(A, vecdim)
M = median(A, "all")
M = median(A, [])
M = median(A, nanflag)
M = median(A, axes, nanflag)
M = median(A, nanflag, axes)
M = median(A, nanflag, "all")

Inputs

Returns

Errors

How median works

• median(X) on an m × n matrix returns a row vector (1 × n) containing the column medians.
• median(X, 2) returns a column vector (m × 1) containing the row medians.
• median(X, 'all') reduces across every element in X and returns a scalar.
• median(X, vecdim) accepts a row or column vector of dimensions (for example [1 3]) and reduces each listed axis in a single call while preserving the others.
• Even-length slices return the average of the two center elements after sorting.
• Logical inputs are promoted to double precision (true → 1.0, false → 0.0) before computing the median.
• median(..., 'omitnan') ignores NaN values; if every element is NaN, the result is NaN.
• median(..., 'includenan') (default) propagates NaN when any value in the slice is NaN.
• Empty slices return NaN values that preserve MATLAB-compatible shape semantics.
• Dimensions larger than ndims(X) leave the input unchanged.

Does RunMat run median on the GPU?

When RunMat Accelerate is active, tensors that already live on the GPU remain on the device. The runtime asks providers for a dedicated median reduction. If the provider cannot supply one or cannot honour omitnan, RunMat gathers GPU data back to the host and executes the CPU path to preserve MATLAB semantics (including even-length averaging and ordering ties).

GPU memory and residency

You usually do NOT need to call gpuArray yourself in RunMat (unlike MATLAB).

In RunMat, the fusion planner keeps residency on GPU in branches of fused expressions. As such, in the above example, the result of the median call will already be on the GPU when the fusion planner has detected a net benefit to operating the fused expression it is part of on the GPU.

To preserve backwards compatibility with MathWorks MATLAB, and for when you want to explicitly bootstrap GPU residency, you can call gpuArray explicitly to move data to the GPU if you want to be explicit about the residency.

Since MathWorks MATLAB does not have a fusion planner, and they kept their parallel execution toolbox separate from the core language, as their toolbox is a separate commercial product, MathWorks MATLAB users need to call gpuArray to move data to the GPU manually whereas RunMat users can rely on the fusion planner to keep data on the GPU automatically.

Examples

Finding the median of an odd-length vector

x = [7 2 9 4 5];
m = median(x)

Expected output:

m = 5

Computing the median of an even-length vector with averaging

x = [1 4 9 10];
m = median(x)

Expected output:

m = 6.5

Column-wise median of a matrix

A = [1 3 5; 7 9 11; 2 4 6];
colMedians = median(A)

Expected output:

colMedians = [2 4 6]

Row medians while ignoring NaN values

A = [1 NaN 3; 4 5 NaN];
rowMedians = median(A, 2, 'omitnan')

Expected output:

rowMedians = [2; 4.5]

Median of all elements in a matrix

A = reshape(1:6, [3 2]);
overall = median(A, 'all')

Expected output:

overall = 3.5

Median of all elements on a GPU-backed tensor

G = gpuArray(randn(2048, 2048));
overall = median(G, 'omitnan');
result = gather(overall)

Using median with coding agents

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

FAQ

Related Math functions

Open-source implementation

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

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