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.
Returns
T- Type
NumericArray- Description
- Real quasitriangular or complex triangular Schur form.
U- Type
NumericArray- Description
- Orthogonal 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
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
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.