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

ordschur — Reorder selected eigenvalue blocks in an ordinary Schur factorization.

Apply stable, adjacent, block-preserving transformations to retained ordinary Schur factors.

Syntax

[US,TS] = ordschur(U,T,selector)

Inputs

U
Type
NumericArray
Required
Yes
Default
—
Description
Schur vectors.
T
Type
NumericArray
Required
Yes
Default
—
Description
Real quasitriangular or complex triangular Schur form.
selector
Type
Any
Required
Yes
Default
—
Description
Logical selection, lhp/rhp/udi/udo keyword, or positive-integer clusters.
NameTypeRequiredDefaultDescription
UNumericArrayYes—Schur vectors.
TNumericArrayYes—Real quasitriangular or complex triangular Schur form.
selectorAnyYes—Logical selection, lhp/rhp/udi/udo keyword, or positive-integer clusters.

Returns

US
Type
NumericArray
Description
Reordered orthogonal/unitary Schur vectors.
TS
Type
NumericArray
Description
Reordered Schur form.
NameTypeDescription
USNumericArrayReordered orthogonal/unitary Schur vectors.
TSNumericArrayReordered Schur form.

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

Errors

RunMat:ordschur:InvalidInput
When
Factor shapes, classes, structure, or selector are invalid.
Message
ordschur: invalid Schur factors or selector
RunMat:ordschur:IllConditioned
When
Selected adjacent blocks cannot be separated by a stable invariant subspace.
Message
ordschur: Schur blocks cannot be separated
RunMat:ordschur:InvalidOutputs
When
More than two outputs are requested.
Message
ordschur: at most two outputs are supported
IdentifierWhenMessage
RunMat:ordschur:InvalidInputFactor shapes, classes, structure, or selector are invalid.ordschur: invalid Schur factors or selector
RunMat:ordschur:IllConditionedSelected adjacent blocks cannot be separated by a stable invariant subspace.ordschur: Schur blocks cannot be separated
RunMat:ordschur:InvalidOutputsMore than two outputs are requested.ordschur: at most two outputs are supported

Block-preserving order

[US,TS] = ordschur(U,T,selector) moves selected eigenvalue blocks to the upper-left while preserving U*T*U' = US*TS*US'.

A logical selector selects either member of a real conjugate pair as a whole. Keywords 'lhp', 'rhp', 'udi', and 'udo' select spectral regions. Positive-integer cluster labels sort in descending order; a real pair with different labels joins the larger label.

A local block exchange that cannot certify its invariant subspace fails before publishing any factors. No generalized QZ reordering is implied.

U is expected to be the caller's orthogonal or unitary Schur factor; ordschur checks finite structural inputs but does not refactor U or recompute U'*U.

Example

Move negative eigenvalues first

A = diag([2 -3 1]); [U,T] = schur(A); [US,TS] = ordschur(U,T,'lhp');

Using ordschur with coding agents

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

Run a small ordschur 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 · pcg · qr · qz · rsf2csf · schur · 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 ordschur is executed, line by line, in Rust.

  • View the source for ordschur 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
  • Block-preserving order
  • Example
  • Move negative eigenvalues first
  • Using ordschur with coding agents
  • Related Linalg functions
  • Factor
  • Structure
  • Solve
  • Ops
  • Source you can read
  • About RunMat