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.
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.
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
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
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.