ctrb — Form the state-space controllability matrix.
ctrb(A,B) and ctrb(sys) assemble [B, A*B, ..., A^(n-1)*B] for one n-state model. The result has n rows and n*m columns when B has m inputs.
Syntax
Co = ctrb(A,B)
Co = ctrb(sys)Inputs
A- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Nonempty square real or complex single/double state matrix.
B- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Same-class input matrix with one or more columns and size(A,1) rows.
sys- Type
Any- Required
- Yes
- Default
- —
- Description
- One ordinary state-space ss model supplying A and B.
Returns
Co- Type
NumericArray- Description
- Controllability matrix [B, A*B, ..., A^(n-1)*B].
Errors
RunMat:ctrb:InvalidArgument- When
- The number or kind of arguments, or the requested output count, is invalid.
- Message
ctrb: invalid argument
RunMat:ctrb:InvalidDimensions- When
- A is not nonempty square, B has incompatible rows or no columns, or the output extent overflows.
- Message
ctrb: invalid matrix dimensions
RunMat:ctrb:UnsupportedInput- When
- The operands do not have matching finite real/complex single/double dense storage, or a product overflows that class.
- Message
ctrb: unsupported matrix input
Input and output contract
A must be a nonempty square host matrix and B must have the same row count and at least one column. One ss model supplies its stored A and B fields; model arrays, uncertain/generalized models, and sparse coefficient matrices are not yet supported.
Matching real or complex single-precision matrices produce a single-precision result; matching double-precision matrices produce double. Inputs with differing precision or real/complex storage currently return a typed unsupported-input error rather than silently converting the matrices.
Execution and placement
Resident matrix inputs gather through their provider before the host calculation. Finite-memory calls currently require host-resident inputs: result storage is reserved before computation and released if the call fails or is cancelled. The operation is a fusion boundary and has no provider-side controllability kernel.
Example
Two-state controllability
A = [0 1; -2 -3]; B = [0; 1]; Co = ctrb(A,B);Using ctrb with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how ctrb changes the result.
Run a small ctrb example, explain the result, then change one input and compare the output.
FAQ
Does ctrb test controllability?⌄
It forms the controllability matrix. Compare its rank with the number of states to test full controllability.
Can I pass an ss model?⌄
Yes, for one ordinary state-space model; ctrb reads only A and B.
Related Control functions
Source you can read
Every RunMat function's source is public. Read exactly how ctrb is executed, line by line, in Rust.
- View the source for ctrb 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.