cond — Compute the matrix condition number with MATLAB-compatible norm choices.

k = cond(A) returns the condition number of matrix A, measuring how sensitive solutions to linear systems are to small perturbations in A or in the right-hand side. By default, cond computes the 2-norm condition number using the ratio of the largest to smallest singular values.

How cond works in RunMat

• cond(A) and cond(A, 2) use the singular values of A, so rectangular matrices are supported.
• cond(A, 1), cond(A, Inf), and cond(A, 'fro') require a square, invertible matrix and use the definition norm(A, p) * norm(inv(A), p) with MATLAB's norm semantics.
• Scalars behave like 1x1 matrices. Non-zero scalars have condition number 1, while cond(0) = Inf.
• Empty matrices return 0, matching MATLAB's convention.
• Singular or rank-deficient matrices return Inf.
• Complex inputs are handled in full complex arithmetic.

How cond runs on the GPU

When the input already lives on a GPU, RunMat first looks for an acceleration provider that exposes the custom cond hook registered below. Current providers gather the matrix to host memory, reuse the shared CPU implementation, and then re-upload the scalar so downstream GPU computations preserve residency. This mirrors MATLAB semantics while keeping the user-facing API uniform.

GPU memory and residency

G = gpuArray([]);      % Empty 0x0 matrix on the GPU
k = cond(G);           % Returns 0 and keeps residency when possible
result = gather(k);

Expected output:

result = 0

Examples

Condition number of the identity matrix

A = eye(3);
k = cond(A)

Expected output:

k = 1

Diagnosing an ill-conditioned diagonal matrix

D = diag([1, 1e-8]);
k = cond(D)

Expected output:

k = 1.0e+8

Condition number of a rectangular matrix (2-norm)

A = [1 0; 0 1; 1 1];
k = cond(A, 2)

Expected output:

k = 1.7321

Using a different norm specification

A = [4 -1; 2 3];
k1 = cond(A, 1)
kInf = cond(A, Inf)

Expected output:

k1   = 2.1429
kInf = 2.1429

Complex-valued matrices

A = [1+2i 0; 3i 4-1i];
k = cond(A)

Expected output:

k = 3.0327

Empty inputs and GPU residency

G = gpuArray([]);      % Empty 0x0 matrix on the GPU
k = cond(G);           % Returns 0 and keeps residency when possible
result = gather(k)

Expected output:

result = 0

FAQ

What does a large condition number mean?

Large condition numbers (>> 1) indicate that small perturbations in the input can produce large changes in the solution of a linear system involving A. Values close to 1 indicate a well- conditioned matrix.

Why does cond return Inf for singular matrices?

Singular matrices have at least one zero singular value (or an undefined inverse), so the condition number is mathematically infinite. RunMat mirrors MATLAB and returns Inf in these cases.

Does cond support rectangular matrices?

Yes for the default 2-norm: cond(A) uses singular values and accepts any two-dimensional matrix. Norms 1, Inf, and 'fro' require a square, invertible matrix because they are defined using the matrix inverse.

How does cond handle empty matrices?

All norm choices return 0 for empty matrices (0x0), matching MATLAB's behaviour.

Will calling cond move my data off the GPU?

Only when the active provider lacks a dedicated implementation. In that case RunMat gathers the data, computes the scalar on the host, and uploads it back so subsequent GPU operations still see a device-resident value.

Related functions to explore

These functions work well alongside cond. Each page has runnable examples you can try in the browser.

rcond, inv, pinv, linsolve, gpuArray, gather, det, norm, rank

Open-source implementation

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

• View cond.rs on GitHub
• Learn how the 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 — faster, on any GPU, with no license required.

• Simulations that took hours now take minutes. RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed.
• Start running code in seconds. Open the browser sandbox or download a single binary. No license server, no IT ticket, no setup.
• A full development environment. GPU-accelerated 2D and 3D plotting, automatic versioning on every save, and a browser IDE you can share with a link.

Getting started · Benchmarks · Pricing