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

ordqz — Reorder retained generalized Schur blocks.

Reorder real or complex QZ factors by logical, region, or cluster selection without refactoring the whole pencil.

Syntax

[AAS,BBS,QS,ZS] = ordqz(AA,BB,Q,Z,selector)

Inputs

AA
Type
NumericArray
Required
Yes
Default
—
Description
Triangular or real quasitriangular first QZ factor.
BB
Type
NumericArray
Required
Yes
Default
—
Description
Upper triangular second QZ factor.
Q
Type
NumericArray
Required
Yes
Default
—
Description
Left transform from the same QZ factorization.
Z
Type
NumericArray
Required
Yes
Default
—
Description
Right transform from the same QZ factorization.
selector
Type
Any
Required
Yes
Default
—
Description
Logical selection, lhp/rhp/udi/udo keyword, or positive-integer cluster vector.
NameTypeRequiredDefaultDescription
AANumericArrayYes—Triangular or real quasitriangular first QZ factor.
BBNumericArrayYes—Upper triangular second QZ factor.
QNumericArrayYes—Left transform from the same QZ factorization.
ZNumericArrayYes—Right transform from the same QZ factorization.
selectorAnyYes—Logical selection, lhp/rhp/udi/udo keyword, or positive-integer cluster vector.

Returns

AAS
Type
NumericArray
Description
Reordered first generalized Schur factor.
BBS
Type
NumericArray
Description
Reordered second generalized Schur factor.
QS
Type
NumericArray
Description
Updated left orthogonal or unitary transform.
ZS
Type
NumericArray
Description
Updated right orthogonal or unitary transform.
NameTypeDescription
AASNumericArrayReordered first generalized Schur factor.
BBSNumericArrayReordered second generalized Schur factor.
QSNumericArrayUpdated left orthogonal or unitary transform.
ZSNumericArrayUpdated right orthogonal or unitary transform.

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

Errors

RunMat:ordqz:InvalidInput
When
Factors, selector, class, shape, or placement are invalid.
Message
ordqz: invalid generalized Schur form or selector
RunMat:ordqz:IllConditioned
When
Adjacent generalized Schur blocks cannot be safely separated or swapped.
Message
ordqz: block exchange is ill-conditioned
IdentifierWhenMessage
RunMat:ordqz:InvalidInputFactors, selector, class, shape, or placement are invalid.ordqz: invalid generalized Schur form or selector
RunMat:ordqz:IllConditionedAdjacent generalized Schur blocks cannot be safely separated or swapped.ordqz: block exchange is ill-conditioned

Retained generalized Schur blocks

ordqz reorders retained QZ factors with adjacent two-sided block exchanges. It does not form B\A or re-factor the full pencil. QS*A*ZS=AAS and QS*B*ZS=BBS remain the transform authority.

A real 2-by-2 conjugate pair is indivisible: if either logical member is selected, both are selected; mismatched numeric cluster labels use the larger label. Numeric clusters appear in descending index order, while logical and region selections move selected blocks first. Region keywords are lhp (real part <0), rhp (>=0), udi (modulus <1), and udo (>=1). Nonzero/zero homogeneous pairs are infinite; 0/0 pairs cannot be classified by a region keyword.

The four factor inputs are caller-supplied generalized Schur factors. Shape, class, finite entries and triangular/quasitriangular structure are checked, but a cubic full-pair unitary/reconstruction check is not repeated for each local exchange. Unseparable or uncertifiable blocks raise an operational error before publication.

This portable sequential implementation has no provider ordqz hook or cooperative CPU-budget checkpoint; resident factors are rejected before host computation.

Example

Move an infinite generalized eigenvalue first

A = [2 0; 0 3]; B = [1 0; 0 0]; [AA,BB,Q,Z] = qz(A,B); [AAS,BBS,QS,ZS] = ordqz(AA,BB,Q,Z,[false;true]);

Using ordqz with coding agents

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

Run a small ordqz 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 · ordschur · 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 ordqz is executed, line by line, in Rust.

  • View the source for ordqz 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
  • Retained generalized Schur blocks
  • Example
  • Move an infinite generalized eigenvalue first
  • Using ordqz with coding agents
  • Related Linalg functions
  • Factor
  • Structure
  • Solve
  • Ops
  • Source you can read
  • About RunMat