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/symunit-workflow.md
View on GitHub# Symunit Workflow
Use `symunit` to work with physical units and constants symbolically. Never hard-code physical constants as numbers.
## Key Functions
| Function | Purpose | Since |
|----------|---------|-------|
| `u = symunit` | Access the unit system | R2017a |
| `newUnit(name, definition)` | Create a custom unit | R2017a |
| `removeUnit(name)` | Remove a custom unit | R2017a |
| `unitConvert(expr, targetUnit)` | Convert to target units | R2017a |
| `separateUnits(expr)` | Split into numeric value and unit | R2017a |
| `unitConversionFactor(from, to)` | Get scalar conversion factor | R2017a |
| `checkUnits(expr)` | Verify dimensional consistency | R2017a |
## Physical Constants
Access constants via `u = symunit`:
| Constant | symunit name | Description |
|----------|-------------|-------------|
| Planck constant | `u.hc` | h |
| Reduced Planck constant | `u.hbar` | h-bar |
| Speed of light | `u.c_0` | c in vacuum |
| Electron mass | `u.m_e` | m_e |
| Proton mass | `u.m_p` | m_p |
| Elementary charge | `u.e_SI` | e |
| Boltzmann constant | `u.kB` | k_B |
| Gravitational constant | `u.G_SI` | G |
| Avogadro number | `u.N_A` | N_A |
| Vacuum permittivity | `u.epsilon_0` | epsilon_0 |
| Vacuum permeability | `u.mu_0` | mu_0 |
**Important:** Do NOT guess constant names. If unsure, check with:
```matlab
u = symunit;
disp(u.hc) % Planck constant
```
## Pattern: Basic Computation with Units
```matlab
u = symunit;
% Define quantities with units
mass = 5 * u.kg;
velocity = 10 * u.m / u.s;
% Compute kinetic energy
KE = 0.5 * mass * velocity^2;
% Convert to desired units
KE_joules = unitConvert(KE, u.J);
% Extract numeric value
[num, unit] = separateUnits(KE_joules);
fprintf('KE = %g J\n', double(num))
```
## Pattern: Create a Custom Dimensionless Unit
```matlab
u = symunit;
% Create a dimensionless custom unit (e.g., photon, count, particle)
newUnit('photon', 1);
% Refresh symunit to pick up the new unit
u = symunit;
flux = 1e15 * u.photon / (u.cm^2 * u.s);
% Convert and extract numeric result
flux_SI = unitConvert(flux, u.photon / (u.m^2 * u.s));
% Clean up when done (pass the symbolic unit, not a string)
removeUnit(u.photon);
```
## Pattern: Photon Energy Calculation
```matlab
u = symunit;
% Physical constants from symunit (NOT hard-coded)
h = u.hc; % Planck constant
c = u.c_0; % Speed of light
% Wavelength
lambda = 532 * u.nm;
% Energy per photon: E = hc/lambda
E = h * c / lambda;
E_eV = unitConvert(E, u.eV);
[numE, ~] = separateUnits(E_eV);
fprintf('Photon energy: %.4f eV\n', double(numE))
```
## Pattern: Unit Conversion
```matlab
u = symunit;
% Length conversion
dist = 26.2 * u.mi;
dist_km = unitConvert(dist, u.km);
% Get just the conversion factor
factor = unitConversionFactor(u.mi, u.km);
% factor = 1.609344
```
## Common Mistakes
| Mistake | Why It's Wrong | Correct Approach |
|---------|---------------|-----------------|
| `hbar = 1.0546e-34` | Loses symbolic precision, error-prone value | `u = symunit; hbar = u.hbar;` |
| `u.planck_constant` | Invalid name — will error | `u.hc` (Planck constant) or `u.hbar` (reduced) |
| `u.speed_of_light` | Invalid name | `u.c_0` |
| `newUnit('photon', 1, 'Dimension', 1)` | Too many arguments — newUnit takes exactly 2 | `newUnit('photon', 1)` |
| `syms photon positive` for a unit | Creates a symbolic variable, not a unit | `newUnit('photon', 1)` |
| Forgetting to refresh `symunit` after `newUnit` | New unit won't be accessible | `u = symunit;` after `newUnit(...)` |
| `removeUnit('photon')` with a string | Requires symbolic unit in R2026a | `removeUnit(u.photon)` |
----
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 |