rsf2csf — Convert real Schur factors to complex triangular Schur factors.
Apply unitary transformations to a retained real Schur form and its Schur vectors.
Syntax
[Unew,Tnew] = rsf2csf(U,T)Inputs
U- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Real orthogonal Schur vectors.
T- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Real quasitriangular Schur form.
Returns
Unew- Type
NumericArray- Description
- Complex unitary Schur vectors.
Tnew- Type
NumericArray- Description
- Complex triangular Schur form.
Returned values from rsf2csf depend on how many outputs the caller requests.
Errors
RunMat:rsf2csf:InvalidInput- When
- Factors are not matching real square Schur matrices.
- Message
rsf2csf: expected matching real Schur factors
RunMat:rsf2csf:Numerical- When
- A 2-by-2 block cannot be triangularized within the bounded iteration.
- Message
rsf2csf: complex block conversion failed
Real-to-complex Schur conversion
[Unew,Tnew] = rsf2csf(U,T) converts retained real Schur factors to complex Schur factors without recomputing the source matrix.
The transformation acts on each exact structural 2-by-2 block, accumulates its unitary rotation in Unew, and keeps Unew*Tnew*Unew' equal to U*T*U'. Inputs must be real, finite, dense, and of one floating class.
U is a caller-supplied orthogonal Schur factor; the structural and class checks do not recompute U'*U before this local transformation.
Example
Triangularize a conjugate-pair block
A = [0 -1; 1 0]; [U,T] = schur(A); [Uc,Tc] = rsf2csf(U,T);Using rsf2csf with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how rsf2csf changes the result.
Run a small rsf2csf 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 · 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 rsf2csf is executed, line by line, in Rust.
- View the source for rsf2csf 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.