RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
See all docs
Builtin Reference
    • chol
    • decomposition
    • decomposition.ctranspose
    • decomposition.mldivide
    • decomposition.mrdivide
    • decomposition.mtimes
    • decomposition.rdivide
    • decomposition.subsref
    • decomposition.times
    • decomposition.uminus
    • decomposition.uplus
    • eig
    • eigs
    • gmres
    • ichol
    • ilu
    • lu
    • ordeig
    • ordqz
    • ordschur
    • pcg
    • qr
    • qz
    • rsf2csf
    • schur
    • svd

schur — Compute an ordinary real or complex Schur factorization.

Compute a retained real quasitriangular or complex triangular factorization of a dense square matrix.

Syntax

T = schur(A)
T = schur(A,mode)
[U,T] = schur(A)
[U,T] = schur(A,mode)

Inputs

A
Type
NumericArray
Required
Yes
Default
—
Description
Dense square single or double matrix.
mode
Type
StringScalar
Required
Yes
Default
—
Description
Real or complex Schur form; complex input always yields complex form.
NameTypeRequiredDefaultDescription
ANumericArrayYes—Dense square single or double matrix.
modeStringScalarYes—Real or complex Schur form; complex input always yields complex form.

Returns

T
Type
NumericArray
Description
Real quasitriangular or complex triangular Schur form.
U
Type
NumericArray
Description
Orthogonal or unitary Schur vectors.
NameTypeDescription
TNumericArrayReal quasitriangular or complex triangular Schur form.
UNumericArrayOrthogonal or unitary Schur vectors.

Returned values from schur depend on how many outputs the caller requests.

Errors

RunMat:schur:InvalidArgument
When
Mode or output count is invalid.
Message
schur: invalid mode or output count
RunMat:schur:InvalidInput
When
Input is not a finite dense square floating matrix.
Message
schur: input must be a finite square single or double matrix
RunMat:schur:Numerical
When
Bounded Schur iteration or result materialization fails.
Message
schur: numerical factorization failed
IdentifierWhenMessage
RunMat:schur:InvalidArgumentMode or output count is invalid.schur: invalid mode or output count
RunMat:schur:InvalidInputInput is not a finite dense square floating matrix.schur: input must be a finite square single or double matrix
RunMat:schur:NumericalBounded Schur iteration or result materialization fails.schur: numerical factorization failed

Syntax

T = schur(A); [U,T] = schur(A); either form accepts an optional 'real' or 'complex' mode.

For real A, default real mode returns a real quasitriangular T. Complex mode returns triangular complex T. Complex A always uses complex form.

Behavior and placement

A must be a finite dense square single or double matrix. U and T preserve its floating class; A = U*T*U' with orthogonal or unitary U.

The portable host implementation uses a bounded nalgebra Schur iteration. Resident GPU inputs are not admitted because no Schur provider hook or transfer policy is declared.

Example

Real Schur blocks retain a complex pair

A = [0 -1; 1 0]; [U,T] = schur(A); e = ordeig(T);

Using schur with coding agents

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

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

Related Linalg functions

Factor

chol · decomposition · decomposition.ctranspose · decomposition.mldivide · decomposition.mrdivide · decomposition.mtimes · decomposition.rdivide · decomposition.subsref · decomposition.times · decomposition.uminus · decomposition.uplus · eig · eigs · gmres · ichol · ilu · lu · ordeig · ordqz · ordschur · pcg · qr · qz · rsf2csf · svd

Structure

bandwidth · isdiag · ishermitian · issymmetric · istril · istriu · symrcm

Solve

cond · det · inv · linsolve · norm · null · pinv · rank · rcond · rref · vecnorm

Ops

cross · ctranspose · dot · mldivide · mpower · mrdivide · mtimes · pagemtimes · pagetranspose · trace · transpose

Source you can read

Every RunMat function's source is public. Read exactly how schur is executed, line by line, in Rust.

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

About RunMat

RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/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.

Download RunMatOpen Sandbox
On this page
  • Syntax
  • Inputs
  • Returns
  • Errors
  • Syntax
  • Behavior and placement
  • Example
  • Real Schur blocks retain a complex pair
  • Using schur with coding agents
  • Related Linalg functions
  • Factor
  • Structure
  • Solve
  • Ops
  • Source you can read
  • About RunMat