matlab-extract-battery-features

Extract degradation features from battery cycling test data in MATLAB.

995|122|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/matlab/matlab-agentic-toolkit --skill matlab-extract-battery-features
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: matlab-extract-battery-features
Source: https://github.com/matlab/matlab-agentic-toolkit/tree/main/skills-catalog/control-systems/matlab-extract-battery-features
Command: npx skills add https://github.com/matlab/matlab-agentic-toolkit --skill matlab-extract-battery-features

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Analyzing battery degradation requires extracting meaningful features from raw cycling test data, but hand-coding segmentation, differential curves, and peak detection is error-prone and slow. This Skill guides an AI agent to use the Predictive Maintenance Toolbox battery functions correctly, avoiding silent failures like missing IC features or inconsistent protocol phases.

Core Features & Use Cases

  • Full Cycling Pipeline: Parse multi-cycle test data with batteryTestDataParser and extract 165+ features per cycle with batteryTestFeatureExtractor, covering statistics, cumulative capacity, CC/CV/CCCV segments, and IC/DV/DT differential curve peaks.
  • Single-Segment Analysis: Compute statistical and cumulative features from any partial charge or discharge segment with batteryMeasurementFeatures, or generate IC/DV/DT curves from constant-current data with batteryDifferentialCurves.
  • Protocol Consistency Checking: Run the bundled checkCyclingProtocol script to select the correct CyclingPhase, detect anomalous cycles, and avoid extracting features from inconsistent test protocols.
  • Use Case: Given a table of multi-cycle battery test data, extract IC peak and capacity features per cycle to track state-of-health degradation and support RUL prediction.

Quick Start

Ask your agent to extract degradation features from your battery cycling data file, for example: "Extract SOH features from my battery cycling test data in cycling_data.mat using the charge phase."

Frequently Asked Questions about matlab-extract-battery-features

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract battery degradation features from cycling test data in MATLAB?

Use batteryTestDataParser to segment multi-cycle data, then batteryTestFeatureExtractor with extract to compute per-cycle features. Enable categories like CycleCumulative for capacity fade and IC for electrode degradation tracking.

How to compute IC and DV curves from battery charge data in MATLAB?

Use batteryDifferentialCurves on a constant-current segment to get dQ/dV, dV/dQ, and dT/dV tables, then pass them to batteryDifferentialCurveFeatures for peak features. The data must be constant-current; mixed CC+CV segments will error.

Why does batteryDifferentialCurves fail with a current must remain constant error?

The function requires pure constant-current data and errors when a step contains both CC and CV portions. Filter segments using the parser's segmentData output with a CC mode mask, or use the full batteryTestFeatureExtractor pipeline which handles filtering internally.

Why are no IC features extracted from my battery test data?

IC, DV, and DT features are computed from CC segments identified by the parser, so they silently produce nothing when CC=false. Always set CC=true on batteryTestFeatureExtractor whenever enabling IC, DV, or DT.

What MATLAB version and toolbox are required for battery feature extraction?

batteryTestDataParser and batteryTestFeatureExtractor require R2024b or later, while batteryMeasurementFeatures and the differential curve functions require R2026a. All functions are part of the Predictive Maintenance Toolbox.

When should I not use battery feature extraction functions?

Avoid them for battery simulation, equivalent circuit modeling, or Simulink plant models, and for non-electrochemical data like fuel cells or supercapacitors. They are designed specifically for feature extraction from electrochemical battery cycling test data.