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

care — Solve a standard continuous-time algebraic Riccati equation.

X = care(A,B,Q[,R[,S]]) solves A'*X + X*A - (X*B+S)*inv(R)*(B'*X+S') + Q = 0. Optional outputs [X,L,G] provide the solution, closed-loop eigenvalues and feedback gain.

Syntax

X = care(A,B,Q)
X = care(A,B,Q,R)
X = care(A,B,Q,R,S)
[X,L] = care(A,B,Q)
[X,L] = care(A,B,Q,R)
[X,L] = care(A,B,Q,R,S)
All supported care forms
X = care(A,B,Q)
X = care(A,B,Q,R)
X = care(A,B,Q,R,S)
[X,L] = care(A,B,Q)
[X,L] = care(A,B,Q,R)
[X,L] = care(A,B,Q,R,S)
[X,L,G] = care(A,B,Q)
[X,L,G] = care(A,B,Q,R)
[X,L,G] = care(A,B,Q,R,S)

Inputs

A
Type
NumericArray
Required
Yes
Default
—
Description
Finite real n-by-n 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
No
Default
eye(size(B,2))
Description
Symmetric nonsingular m-by-m input weight.
S
Type
NumericArray
Required
No
Default
zeros(size(B))
Description
n-by-m cross weight.
NameTypeRequiredDefaultDescription
ANumericArrayYes—Finite real n-by-n state matrix.
BNumericArrayYes—Finite real n-by-m input matrix.
QNumericArrayYes—Symmetric n-by-n state weight.
RNumericArrayNoeye(size(B,2))Symmetric nonsingular m-by-m input weight.
SNumericArrayNozeros(size(B))n-by-m cross weight.

Returns

X
Type
NumericArray
Description
Stabilizing real double n-by-n CARE solution.
L
Type
Any
Description
n-by-1 real or complex double closed-loop poles.
G
Type
NumericArray
Description
Real double m-by-n feedback gain.
NameTypeDescription
XNumericArrayStabilizing real double n-by-n CARE solution.
LAnyn-by-1 real or complex double closed-loop poles.
GNumericArrayReal double m-by-n feedback gain.

Returned values from care depend on how many outputs the caller requests.

Errors

RunMat:care:InvalidArgument
When
The standard form or requested output count is invalid.
Message
care: invalid argument
RunMat:care:UnsupportedForm
When
A descriptor, factor, or diagnosis form is requested.
Message
care: unsupported form
RunMat:care:InvalidDimensions
When
System and weight dimensions are incompatible.
Message
care: invalid dimensions
IdentifierWhenMessage
RunMat:care:InvalidArgumentThe standard form or requested output count is invalid.care: invalid argument
RunMat:care:UnsupportedFormA descriptor, factor, or diagnosis form is requested.care: unsupported form
RunMat:care:InvalidDimensionsSystem and weight dimensions are incompatible.care: invalid dimensions
RunMat:care:UnsupportedInputThe matrices are not finite real host-compatible inputs.care: unsupported input
RunMat:care:SolverFailedNo validated stabilizing CARE solution is available.care: Riccati solver failed
RunMat:care:InternalOutput construction fails.care: internal error

Supported standard form

A is nonempty real n-by-n, B real n-by-m, Q symmetric n-by-n, R symmetric nonsingular m-by-m, and S is optional n-by-m. R defaults to identity and S to zero. Inputs must be finite; calculation and outputs use host double precision. Indefinite Q or R are accepted when the equation has a finite stabilizing solution; the nonnegative-cost restrictions of lqr and dlqr do not apply to care.

The descriptor-pair E argument, factorized output form, fourth diagnosis report, complex data, and singular R are not yet supported. A missing stabilizing solution returns a typed solver error; the empty-result and report conventions of MATLAB are not yet implemented.

Execution

The standard CARE uses the shared QR-deflated, ordered-QZ Riccati solver and checks its original-equation residual and closed-loop stability. Valid resident operands gather before host computation; managed execution without a complete result owner rejects before gathering.

Example

Scalar stabilizing CARE

[X,L,G] = care(-1,1,1,1);

Using care with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how care changes the result.

Run a small care example, explain the result, then change one input and compare the output.

FAQ

What is the output order?⌄

care returns the Riccati solution X, closed-loop eigenvalues L, then feedback gain G. This differs from lqr's K,S,e order.

Does care support generalized descriptor E?⌄

Not yet. The current implementation is the standard E=I continuous-time equation only.

Related Control functions

Analysis

ctrb · damp · db · dcgain · dlqr · 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 care is executed, line by line, in Rust.

  • View the source for care 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
  • Supported standard form
  • Execution
  • Example
  • Scalar stabilizing CARE
  • Using care with coding agents
  • FAQ
  • Related Control functions
  • Analysis
  • Response
  • Models
  • Control
  • Source you can read
  • About RunMat