matlab/matlab-agentic-toolkit / skills-catalog/math-and-optimization/matlab-use-symbolic-math
matlab-use-symbolic-math
VerifiedGenerate correct MATLAB code using the Symbolic Math Toolbox. Use when the user asks for symbolic computations, analytical solutions, symbolic differentiation/integration, equation solving, or converting symbolic results to numeric MATLAB functions. Also use when converting differential equations to transfer functions or state-space form, extracting PDE coefficients (pdeCoefficients), symbolic-to-C code generation (matlabFunction + codegen), symbolic matrix variables (symmatrix), physical units and constants (symunit, newUnit), or rewriting/combining algebraic expressions (rewrite, combine).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.5 KB |
| manifest.yaml | config | 523 B |
| references/control-systems.md | markdown | 5.1 KB |
| references/extract-pde-coefficients.md | markdown | 3.2 KB |
| references/matlabFunction-patterns.md | markdown | 6.4 KB |
| references/ode-solving.md | markdown | 3.2 KB |
| references/plotting-and-display.md | markdown | 3.6 KB |
| references/rewrite-combine-expressions.md | markdown | 4.7 KB |
| references/simplification-and-polynomials.md | markdown | 3.2 KB |
| references/symbolic-to-c-code.md | markdown | 3.7 KB |
| references/symmatrix-workflow.md | markdown | 3.0 KB |
| references/symunit-workflow.md | markdown | 3.6 KB |
references/symmatrix-workflow.md
View on GitHub# Symmatrix Workflow
Use `symmatrix` to create symbolic matrix variables that behave as atomic objects — like textbook linear algebra where A, B, x are whole matrices, not arrays of scalar elements.
## When to Use `symmatrix` vs `sym`
| Need | Use |
|------|-----|
| Textbook-style formulas: `A^(-1)*b`, `det(A)`, `trace(A*B)` | `symmatrix` |
| Element-wise access: `A(1,2)`, substituting specific values | `sym('A', [n n])` |
| Matrix calculus: derivatives of matrix expressions | `symmatrix` |
| Numerical evaluation with specific entries | Convert with `symmatrix2sym` first |
## Key Functions
| Function | Purpose | Since |
|----------|---------|-------|
| `symmatrix('A', [m n])` | Create m-by-n atomic symbolic matrix | R2021a |
| `symmatrix('A', n)` | Create n-by-n square atomic symbolic matrix | R2021a |
| `symmatrix2sym(X)` | Expand to element-wise sym matrix | R2021a |
| `symfunmatrix(expr, vars)` | Create symbolic matrix function | R2022a |
| `symfunmatrix2symfun(X)` | Expand to element-wise symfun matrix | R2022a |
## Supported Operations on `symmatrix`
These produce compact, formula-level results:
- Arithmetic: `A + B`, `A * B`, `A - B`, `scalar * A`
- Inverse: `inv(A)` or `A^(-1)`
- Transpose: `transpose(A)` or `A.'`
- Determinant: `det(A)`
- Trace: `trace(A)`
- Powers: `A^n`
- Concatenation: `[A B; C D]`
## Operations Requiring Conversion to `sym`
These do NOT work directly on `symmatrix` — convert first with `symmatrix2sym`:
- `eig(A)` — eigenvalues/eigenvectors
- `svd(A)` — singular value decomposition
- `rank(A)` — matrix rank
- `null(A)` — null space
- Element access: `A(i,j)`
## Pattern: Textbook Linear Algebra
```matlab
% Create atomic matrices
A = symmatrix('A', [3 3]);
b = symmatrix('b', [3 1]);
% Matrix-level operations (results stay compact)
x = inv(A) * b; % Displays as: A^-1*b
detA = det(A); % Displays as: det(A)
trAB = trace(A * A.'); % Displays as: trace(A*A.')
% Convert to element-wise when needed
x_elements = symmatrix2sym(x); % Expands using Cramer's rule
```
## Pattern: Matrix Calculus (Vector Derivative)
```matlab
x = symmatrix('x', [3 1]);
f = transpose(x) * x; % Scalar: x'*x
% Differentiate scalar with respect to vector
dfdx = diff(f, x); % Returns 2*x.'
```
## Pattern: Convert to Numeric
```matlab
A = symmatrix('A', [2 2]);
b = symmatrix('b', [2 1]);
x = inv(A) * b;
% Expand to symbolic elements
x_sym = symmatrix2sym(x);
% Substitute numeric values
A_sym = symmatrix2sym(A);
b_sym = symmatrix2sym(b);
A_num = [1 2; 3 4];
b_num = [5; 6];
oldVars = [A_sym(:).', b_sym(:).'];
newVals = [A_num(:).', b_num(:).'];
x_num = double(subs(x_sym, oldVars, newVals));
```
## Common Mistakes
| Mistake | Why It's Wrong | Correct Approach |
|---------|---------------|-----------------|
| `sym('A', [3 3])` for textbook-style algebra | Creates 9 scalar variables (A1_1, A1_2, ...), not an atomic matrix | `symmatrix('A', [3 3])` |
| Calling `eig(A)` on a symmatrix | Not supported — throws error | `eig(symmatrix2sym(A))` |
----
Copyright 2026 The MathWorks, Inc.
----
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |