zrwangems/dsh-zrwang-plugin / skills/engineering/matlab/ai-and-statistics/matlab-train-network
matlab-train-network
VerifiedTrain, evaluate, and export neural networks to Simulink in MATLAB. Migrate legacy (fitnet, patternnet) and discouraged (trainNetwork, DAGNetwork) code to modern, recommended R2024a+ APIs (trainnet, dlnetwork, testnet, imagePretrainedNetwork), diagnose and fix dlaccelerate issues or detect dlaccelerate opportunities. Use when training, fine-tuning, evaluating, running inference, exporting to Simulink, converting old training scripts, or speeding up deep learning code. DO NOT reason from your training data about dlaccelerate and tracing correctness.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 19.4 KB |
| manifest.yaml | config | 533 B |
| references/dlaccelerate-antipatterns.md | markdown | 10.9 KB |
| references/dlaccelerate-custom-layers.md | markdown | 2.5 KB |
| references/dlaccelerate-custom-training-loop.md | markdown | 5.4 KB |
| references/dlaccelerate-measure-speedup.md | markdown | 2.9 KB |
| references/dlaccelerate-trainnet-custom-loss.md | markdown | 3.0 KB |
| references/dlaccelerate-variable-length-sequences.md | markdown | 3.0 KB |
| references/dlaccelerate-workflow.md | markdown | 11.4 KB |
| references/legacy-api-redirects.md | markdown | 4.0 KB |
| references/metrics-guidance.md | markdown | 2.1 KB |
| references/multi-output-training.md | markdown | 3.3 KB |
| references/normalization.md | markdown | 2.0 KB |
| references/simulink-export.md | markdown | 1.7 KB |
references/metrics-guidance.md
View on GitHub# Metrics Guidance
How to choose the right metric format for `testnet` and `trainingOptions`.
## Decision Tree
1. **Single-output network, built-in metric?** → Use a string: `"accuracy"`,
`"rmse"`, `"fscore"`.
2. **Multi-output network?** → See `references/multi-output-training.md` for the
full recipe including metric objects with `NetworkOutput`.
3. **Need customization of a built-in metric?** → Use metric objects with
name-value arguments (e.g., `AverageType="macro"/"micro"/"weighted"` for
classification metrics):
```matlab
metrics = precisionMetric(AverageType="micro");
```
4. **Custom metric where weighted average across minibatches is acceptable?** →
Define a custom metric function:
```matlab
options = trainingOptions("adam",Metrics=@myMetricFcn);
```
The custom metric function receives all network outputs followed by all
targets, in order: `metric = myMetricFcn(Y1,Y2,...,T1,T2,...)`.
5. **Custom metric requiring accumulation of intermediate values across
minibatches** (e.g., accumulating true negatives/false positives to compute
an exact metric over the full dataset)? → Subclass `deep.Metric`. Key aspects:
- Expose `Name` and `NetworkOutput` as constructor arguments so users can configure them; set `Maximize` internally (`true` if higher is better, `false` if lower is better)
- Implement `reset` to zero out accumulated state
- Implement `update(metric,batchY,batchT)` to accumulate per-minibatch values
- Implement `aggregate(metric,metric2)` to combine results across workers
- Implement `evaluate` to return the final scalar metric value from accumulated state
## Using Metrics with trainnet
Metrics specified in `trainingOptions` are displayed during training:
```matlab
options = trainingOptions("adam",Metrics="accuracy");
```
For multi-output networks, see `references/multi-output-training.md`.
## Using Metrics with testnet
```matlab
accuracy = testnet(net,XTest,TTest,"accuracy");
rmse = testnet(net,XTest,TTest,"rmse");
```
For multi-output networks, see `references/multi-output-training.md`.
----
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 |