ordeig — Extract ordinary or generalized Schur eigenvalues in factor order.
Read ordinary or generalized Schur eigenvalues in retained factor order without reordering or inverting the second factor.
Syntax
E = ordeig(T)
E = ordeig(AA,BB)Inputs
T- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Ordinary real quasitriangular or complex triangular Schur form.
AA- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- First retained generalized Schur factor.
BB- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Second retained generalized Schur factor.
Returns
E- Type
NumericArray- Description
- Eigenvalues in Schur-block order.
Errors
RunMat:ordeig:InvalidInput- When
- Input factors are not finite ordinary or generalized Schur forms.
- Message
ordeig: expected Schur-form factors
Ordered Schur spectrum
E = ordeig(T) reads 1-by-1 and 2-by-2 diagonal blocks of an ordinary Schur form in their existing order. A nonzero real subdiagonal marks an indivisible 2-by-2 block, even when it is tiny.
E = ordeig(AA,BB) reads the retained generalized Schur spectrum in block order. Singular BB can yield infinite eigenvalues; 0/0 homogeneous pairs yield indeterminate NaN. Real 2-by-2 blocks are kept together, and the pair is never reduced through B\A.
Examples
Read a Schur spectrum without sorting
T = diag([3 -1 2]); e = ordeig(T);Expected output:
e = [3; -1; 2]Read a generalized Schur spectrum with singular BB
A = [2 0; 0 3]; B = [1 0; 0 0]; [AA,BB] = qz(A,B); e = ordeig(AA,BB);Using ordeig with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how ordeig changes the result.
Run a small ordeig 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 · ordqz · 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 ordeig is executed, line by line, in Rust.
- View the source for ordeig 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.