dlqr — Compute a discrete-time linear-quadratic state-feedback gain.
K = dlqr(A,B,Q,R[,N]) uses the same validated DARE solver as discrete-state-space lqr; [K,S,P] additionally returns its stabilizing Riccati solution and closed-loop poles.
Syntax
K = dlqr(A,B,Q,R)
K = dlqr(A,B,Q,R,N)
[K,S] = dlqr(A,B,Q,R)
[K,S] = dlqr(A,B,Q,R,N)
[K,S,P] = dlqr(A,B,Q,R)
[K,S,P] = dlqr(A,B,Q,R,N)Inputs
A- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Finite real n-by-n discrete state matrix.
B- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Finite real n-by-m input matrix.
Q- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Symmetric n-by-n state weight.
R- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Positive-definite m-by-m input weight.
N- Type
NumericArray- Required
- No
- Default
zeros(size(B))- Description
- n-by-m cross weight.
Returns
K- Type
NumericArray- Description
- Real double m-by-n feedback gain.
S- Type
NumericArray- Description
- Stabilizing real double n-by-n DARE solution.
P- Type
Any- Description
- n-by-1 real or complex double closed-loop poles.
Returned values from dlqr depend on how many outputs the caller requests.
Errors
RunMat:dlqr:InvalidArgument- When
- The matrix form or requested output count is invalid.
- Message
dlqr: invalid argument
RunMat:dlqr:InvalidDimensions- When
- System and weight dimensions are incompatible.
- Message
dlqr: invalid dimensions
RunMat:dlqr:UnsupportedInput- When
- The matrices are not finite real host-compatible inputs.
- Message
dlqr: unsupported input
Inputs and outputs
A is real n-by-n, B real n-by-m, Q symmetric n-by-n, R symmetric positive-definite m-by-m, and optional N is n-by-m. The block cost must be positive semidefinite. Values must be finite. As with the shared lqr solver, inputs normalize to host double precision and K/S are real double; P may be complex double.
This is the explicit matrix-input discrete-time form. The state-space-object overload, complex weighting, descriptor dynamics and non-stabilizing solutions are not claimed. Failed convergence or an invalid DARE residual produces a typed solver error.
Execution
The shared QR-deflated, ordered-QZ DARE solver checks the original equation residual and closed-loop stability. Resident operands gather before host computation; managed operations lacking complete output ownership reject before gathering. No provider Riccati kernel is claimed.
Example
One-state discrete regulator
[K,S,P] = dlqr(1,1,1,1);Using dlqr with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how dlqr changes the result.
Run a small dlqr example, explain the result, then change one input and compare the output.
FAQ
What is the default cross weight?⌄
N defaults to the zero n-by-m matrix.
How does dlqr differ from lqr(A,B,Q,R)?⌄
Matrix-input lqr uses the continuous CARE; dlqr uses the discrete DARE for the same matrix inputs.
Related Control functions
Source you can read
Every RunMat function's source is public. Read exactly how dlqr is executed, line by line, in Rust.
- View the source for dlqr 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.