RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
See all docs
Builtin Reference
    • care
    • ctrb
    • damp
    • db
    • dcgain
    • dlqr
    • feedback
    • isstable
    • lqr
    • minreal
    • pade
    • pole
    • pzmap
    • rlocus
    • stepinfo
    • zero

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.
NameTypeRequiredDefaultDescription
ANumericArrayYes—Finite real n-by-n discrete state matrix.
BNumericArrayYes—Finite real n-by-m input matrix.
QNumericArrayYes—Symmetric n-by-n state weight.
RNumericArrayYes—Positive-definite m-by-m input weight.
NNumericArrayNozeros(size(B))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.
NameTypeDescription
KNumericArrayReal double m-by-n feedback gain.
SNumericArrayStabilizing real double n-by-n DARE solution.
PAnyn-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
IdentifierWhenMessage
RunMat:dlqr:InvalidArgumentThe matrix form or requested output count is invalid.dlqr: invalid argument
RunMat:dlqr:InvalidDimensionsSystem and weight dimensions are incompatible.dlqr: invalid dimensions
RunMat:dlqr:UnsupportedInputThe matrices are not finite real host-compatible inputs.dlqr: unsupported input
RunMat:dlqr:SolverFailedNo validated stabilizing DARE solution is available.dlqr: Riccati solver failed
RunMat:dlqr:InternalOutput construction fails.dlqr: internal error

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

Analysis

care · ctrb · damp · db · dcgain · feedback · isstable · lqr · minreal · pade · pole · pzmap · rlocus · stepinfo · zero

Response

bode · evalfr · freqresp · impulse · nyquist · step

Models

series · ss2tf · tfdata

Control

ss · tf · tf.ldivide · tf.minus · tf.mldivide · tf.mpower · tf.mrdivide · tf.mtimes · tf.plus · tf.power · tf.rdivide · tf.times · tf.uminus · tf.uplus

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.

Getting started · Benchmarks · Pricing

Download RunMat

Download RunMat for full performance, or use RunMat in your browser for zero setup.

Download RunMatOpen Sandbox
On this page
  • Syntax
  • Inputs
  • Returns
  • Errors
  • Inputs and outputs
  • Execution
  • Example
  • One-state discrete regulator
  • Using dlqr with coding agents
  • FAQ
  • Related Control functions
  • Analysis
  • Response
  • Models
  • Control
  • Source you can read
  • About RunMat