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.
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.
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
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
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.