matlab/matlab-agentic-toolkit / skills-catalog/control-systems/matlab-extract-battery-features
matlab-extract-battery-features
VerifiedExtract battery features in MATLAB from voltage, current, and temperature measurements: multi-cycle cycling tests, HPPC / pulse tests, EIS impedance sweeps, or a single in-field charge or discharge segment. Use when the user asks for battery features, or for SOH, RUL, degradation, internal-resistance, or impedance analysis that needs them. Output is a feature table; does not train SOH / RUL models. Do not trigger only because battery data is present. Triggers on battery* functions such as batteryTestDataParser, batteryTestFeatureExtractor, batteryPulseFeatures, batteryEISFeatures.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 21.6 KB |
| manifest.yaml | config | 469 B |
| references/cycling-pipeline.md | markdown | 21.1 KB |
| references/cycling/feature-selection.md | markdown | 2.6 KB |
| references/cycling/multi-cell.md | markdown | 5.1 KB |
| references/cycling/postprocess.md | markdown | 2.4 KB |
| references/cycling/schedule-verification.md | markdown | 4.2 KB |
| references/cycling/tolerance-tuning.md | markdown | 2.4 KB |
| references/eis-features.md | markdown | 10.8 KB |
| references/individual-cycling-functions.md | markdown | 10.1 KB |
| references/parameter-tuning.md | markdown | 14.2 KB |
| references/pulse-features.md | markdown | 12.6 KB |
| scripts/checkCyclingProtocol.m | other | 9.2 KB |
| scripts/sweepScheduleAndReport.m | other | 3.7 KB |
| scripts/verifyAgainstSchedule.m | other | 8.5 KB |
| scripts/verifySegmentation.m | other | 6.3 KB |
| scripts/verifySingleSegment.m | other | 3.0 KB |
references/cycling/multi-cell.md
View on GitHub# Cycling: Multiple Files and Multiple Battery Cells
Load this in addition to `references/cycling-pipeline.md` when the cycling data spans **more than one file** for a battery cell, or covers **more than one battery cell** (a `CellID` / `Cell` / `SerialNumber` column, one file per battery cell, or a MATLAB cell array of per-battery-cell tables). It replaces the single-battery-cell parts of Phase 2, Phase 6, and Phase 7; every other phase is unchanged.
## Phase 2 — Data Layout
For cycling the rule is **combine before parsing**.
### Layout 2 — One battery cell, multiple files (or MATLAB cell array of tables from one battery cell)
Concatenate into a single table. If each source's cycle index restarts from 1, **offset before concatenation** so the combined cycle index is monotonic:
```matlab
files = dir(fullfile(dataDir, "*.csv"));
allTables = cell(numel(files), 1);
cycleOffset = 0;
for k = 1:numel(files)
t = readtable(fullfile(files(k).folder, files(k).name));
t.Cycle_Index = t.Cycle_Index + cycleOffset;
cycleOffset = max(t.Cycle_Index);
allTables{k} = t;
end
cyclingData = vertcat(allTables{:});
```
Then a single pipeline call on `cyclingData` — continue with Phase 3 in `references/cycling-pipeline.md`.
### Layout 3 — Multiple battery cells (any storage form)
Combine into one table carrying a `CellID` column. Cycle indices do **not** need to be globally unique — the pipeline processes each battery cell separately in Phase 6, so within-battery-cell cycle numbering is what matters.
```matlab
% Example: separate files → combined table with CellID derived from filename
files = dir(fullfile(dataDir, "*.csv"));
allTables = cell(numel(files), 1);
for k = 1:numel(files)
t = readtable(fullfile(files(k).folder, files(k).name));
t.CellID = repmat(string(erase(files(k).name, ".csv")), height(t), 1);
allTables{k} = t;
end
cyclingData = vertcat(allTables{:});
```
Variants:
- Data is already a **MATLAB cell array of tables**, one element per battery cell → tag each element's `CellID`, then `vertcat`.
- Data is already a **single combined table** with `CellID` (or `Cell`, `SerialNumber`) → no preprocessing.
The `CellID` column is a separate tag — do not pass it to the parser.
**Report the detected layout** in the Phase 7 summary so the user knows how the output is organized.
## Phase 6 — Feature extraction, multiple battery cells
**Do not `vertcat` across battery cells.** Loop Phases 3-6 per battery cell and keep each per-battery-cell feature table in its own cell-array element. Different battery cells may have different `RecommendedPhase`, different `AnomalousCycles`, and cycle indices that restart per battery cell — pooling upfront hides those differences.
```matlab
cellIDs = unique(cyclingData.CellID, "stable");
featuresPerCell = cell(numel(cellIDs), 1);
recommendedPhases = strings(numel(cellIDs), 1);
for k = 1:numel(cellIDs)
thisCellData = cyclingData(cyclingData.CellID == cellIDs(k), :);
parser = batteryTestDataParser(thisCellData, ...
CurrentVariable="Current", VoltageVariable="Voltage", ...
TimeVariable="DateTime", CycleIndexVariable="Cycle_Index", ...
StepIndexVariable="Step_Index", TemperatureVariable="Temperature");
verifyReport = verifySegmentation(parser);
% If verifyReport.TuningRecommended, run the Phase 5 Tolerance sweep before proceeding.
% Different cells at the same sampling rate typically need the same Tolerance value.
result = checkCyclingProtocol(parser);
% STOP per battery cell if result flags anomalous cycles or no consistent phase.
recommendedPhases(k) = result.RecommendedPhase;
extractor = batteryTestFeatureExtractor( ...
CyclingPhase=result.RecommendedPhase, IC=true, ...
CycleCumulative=true, Statistics=true, CC=true, CV=true, CCCV=true);
ft = extract(extractor, parser);
ft.CellID = repmat(cellIDs(k), height(ft), 1);
featuresPerCell{k} = ft;
end
```
- `featuresPerCell{k}` = feature table for battery cell `cellIDs(k)`.
- Each per-battery-cell table carries a `CellID` column and preserves its own cycle-index axis.
- Surface (not silently skip) two cases: a battery cell whose `checkCyclingProtocol` returns no consistent phase (ask the user whether to drop it or hand-pick its phase), and a battery cell whose `RecommendedPhase` differs from the majority (proceed but flag it in the Phase 7 report so cross-battery-cell trends are comparable).
## Phase 7 — Report, multiple battery cells
Use this in place of the single-battery-cell report, keeping the same Key decisions and Data quality lines:
> Extracted features from **K battery cells** over up to **M cycles per battery cell**.
> - Per-battery-cell feature tables held in a MATLAB cell array: `featuresPerCell{k}` for battery cell k.
> - Each row = one cycle. Tag column: `CellID`; cycle index preserved from the source.
> - `RecommendedPhase` per battery cell: <list, flag any outliers>.
> - Cross-battery-cell ranking iterates over `featuresPerCell` — see `references/cycling/feature-selection.md` (Cell Screening row).
Then stop and offer the standing next steps exactly as in `references/cycling-pipeline.md` Phase 7.
----
Copyright 2026 The MathWorks, Inc.
----
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |