batteryPulseFeatures

R2026b

Extract features from battery pulse test data

Since R2026b

Syntax

[featureTable,pulseData] = batteryPulseFeatures(tbl,CurrentVariable=currentvar,VoltageVariable=voltagevar,TimeVariable=timevar)

[___] = batteryPulseFeatures(data)

[___] = batteryPulseFeatures(voltage,current,time)

[___] = batteryPulseFeatures(voltage,current,samplingRate)

[___] = batteryPulseFeatures(___,Name=Value)

Description

Extract Battery Features from a Table or Timetable

[featureTable,pulseData] = batteryPulseFeatures(tbl,CurrentVariable=currentvar,VoltageVariable=voltagevar,TimeVariable=timevar) extracts battery health features and pulse segment data from pulse-test data stored in the table or timetable tbl that contains the variable names specified in currentvar, voltagevar, and timevar.

Extract Features from a Matrix

[___] = batteryPulseFeatures(data) extracts battery health features from the N-by-3 numeric matrix data with columns containing measurements for voltage, current, time].

Extract Features from Separate Vectors

[___] = batteryPulseFeatures(voltage,current,time) extracts battery health features using separate vectors for voltage, current, and time measurements.

[___] = batteryPulseFeatures(voltage,current,samplingRate) extracts battery health features using voltage and current vectors, as well as a scalar sampling rate in Hz. This syntax generates a time vector from the sampling rate.

Specify Additional Options

[___] = batteryPulseFeatures(___,Name=Value) allows you to specify additional parameters using name-value arguments. You can use this syntax with any of the previous input and output argument combinations.

Examples

Extract Features from Table Input

Load battery pulse test data from a CSV file and extract health features by specifying the variable names.

tbl = readtable('hppc_test.csv');

Load battery pulse test data from a CSV file.

[features, pulses] = batteryPulseFeatures(tbl, CurrentVariable="Current", VoltageVariable="Voltage", TimeVariable="Time");

Extract pulse features from the table by specifying the names of the current, voltage, and time variables.

Extract Features Using Two-Vector Input with Sampling Rate

Extract battery health features from separate voltage and current vectors using a sampling rate.

[features, pulses] = batteryPulseFeatures(voltage, current, 1000);

Extract pulse features using voltage and current vectors with a 1000 Hz sampling rate.

Extract Features from Matrix Input

Extract battery health features from an N-by-3 data matrix.

data = [voltage, current, time];

Construct an N-by-3 matrix with voltage, current, and time columns.

[features, pulses] = batteryPulseFeatures(data);

Extract pulse features from the matrix input.

Customize Pulse Detection Parameters

Extract features with custom valid pulse duration range and post-pulse relaxation duration.

[features, pulses] = batteryPulseFeatures(tbl, CurrentVariable="Current", VoltageVariable="Voltage", TimeVariable="Time", ValidPulseDurationRange=[5, 30], PostPulseMaxDuration=120);

Extract features using custom pulse duration range of 5 to 30 seconds and a maximum post-pulse relaxation duration of 120 seconds.

Input Arguments

tbl — Input table or timetable

table | timetable

Input data containing battery pulse test measurements, specified as a table or timetable.

• For a table input, the table must contain variables for voltage, current, and time.

• For a timetable input, no explicit time variable is necessary because the timetable provides time in the rowtimes property.

currentvar — Name of current measurement variable

string

Name of the current measurement variable when tbl provides the pulse-test data, specified as a string scalar.

voltagevar — Name of voltage measurement variable

string

Name of the voltage measurement variable when tbl provides the pulse-test data, specified as a string scalar.

timevar — Name of time measurement variable

string

Name of the time measurement variable when tbl provides the pulse-test data, specified as a string scalar.

data — Input data matrix

matrix

Input data containing battery pulse test measurements, specified as an N-by-3 numeric matrix. The columns must be ordered as [voltage, current, time].

voltage — Voltage measurements

numeric vector

Voltage measurements from the battery pulse test, specified as a numeric vector.

current — Current measurements

numeric column vector

Current measurements corresponding to the voltage data, specified as a numeric column vector. The current vector must have the same number of elements as the voltage vector.

time — Time measurements

numeric vector | duration vector | datetime vector

Time measurements corresponding to the voltage and current data, specified as a numeric vector, duration vector, or datetime vector. The time vector must have the same number of elements as the voltage vector.

samplingRate — Sampling rate

positive scalar

Sampling rate of the measurements, specified as a positive scalar in Hz. The function generates a time vector from the sampling rate.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example:

StepIndexVariable — Step index variable name in table

string

Name of the variable in the input table that contains step index data, specified as a string scalar. When specified, the function uses the step index to identify pulse segments instead of automatic change point detection. The step index values must be numeric, nonempty, real, finite, and non-NaN.

PostPulseMaxDuration — Maximum post-pulse relaxation duration

90 seconds (default) | positive scalar

Maximum duration for the post-pulse relaxation period, specified as a positive scalar in seconds.

ValidPulseDurationRange — Valid pulse duration range

[2, 60] (default)

Minimum and maximum valid pulse duration, specified as a 1-by-2 vector of positive values [min, max] in seconds. The values must be nondecreasing. Pulses with durations outside this range are excluded.

ValidVoltageRange — Valid voltage range

[0, inf] (default)

Minimum and maximum valid voltage range, specified as a 1-by-2 vector of nonnegative values [min, max] in volts. The values must be nondecreasing. Data with voltages outside this range are excluded.

MinCurrentChange — Minimum current change threshold

1e-4 (default)

Minimum current change threshold for identifying pulse transitions, specified as a positive scalar in amperes.

Output Arguments

featureTable — Extracted pulse features

table

Extracted battery health features for each identified pulse, returned as a table.

The table contains the following variables:

Feature	Description
OCV	Open circuit voltage in V
R0	Ohmic resistance in Ω
RTotal	Total resistance in Ω
DeltaVoltage	Voltage drop during pulse in V
RelaxationVoltage	Voltage at end of relaxation period in V
RecoveryVoltage	Voltage recovered after pulse in V
RecoveryRate	Voltage recovered after pulse in V/s
Energy	Energy delivered during pulse in J
VoltageMean	Mean voltage in V
VoltageStandardDeviation	Voltage standard deviation during pulse in V

pulseData — Pulse segment information

table

Pulse segment information for each identified pulse, returned as a table. The table contains the following variables.

Variable	Description
Directionality	Charge or discharge direction
PulseStepIndex	Step index of pulse, included only when StepIndexVariable is specified
PulseCurrent	Average current during pulse, in A
PulseDuration	Duration of pulse, in s
PulseStartIndex	Starting index of pulse in original data
PulseEndIndex	Ending index of pulse in original data

Version History

Introduced in R2026b