hppcTest
Create test container object for hybrid pulse power characterization test data
Since R2025a
Description
Use hppcTest
to create an HPPCTest
container
object for hybrid pulse power characterization (HPPC) test data. Use this object to
automatically extract and analyze individual current pulses from HPPC timeseries data. The
HPPCTest
container object tabulates and organizes all the data and metadata
related to every pulse in your test and allows you to pre-process your data in preparation for
the parameter estimation process. The TestSummary
property contains the
table with all the summarized pulse information.
You can load the test time, measured voltage, and current data into this object by setting
the HPPCData
property. The HPPCData
property must
comprise a series of constant current pulses applied to a battery at several operating points,
including different states of charge, temperatures, and current values. The
HPPCData
property can be of type double
,
table
, or timetable
. If you specify the
HPPCData
property as a matrix of double
, the column of
the matrix must correspond to time, voltage, and current, in this order. If you specify the
HPPCData
property as a table or a timetable, you must provide a valid
column or variable name. Optionally, to improve the accuracy for the tabulation of your test
breakpoints, you can also define your measured cell temperature, calculated state of charge,
initial state of charge, and battery capacity.
The HPPCTest
object also allows you to manually define a matrix with the
start and end indices for each individual pulse by defining the
DischargePulseIndicesInternal
and
ChargePulseIndicesInternal
properties.
To estimate the parameters of an equivalent circuit model for each pulse, use this object
and an ECM
object as
inputs to the fitECM
function.
This figure shows the typical workflow to estimate the parameters of an equivalent circuit
model from HPPC test data:
Creation
Description
creates a default empty
HPPC test container object, hppcExp
= hppcTesthppcExp
, with default property
values.
creates a test container object for the hybrid pulse power characterization test data,
hppcExp
= hppcTest(HPPCData
,PropertyName=Value
)HPPCData
, and sets properties using one or more name-value
arguments.
Input Arguments
Properties
Object Functions
updateTestSummary | Update TestSummary property table |
setDischargeSOCs | Update state-of-charge values for all discharge pulses in
TestSummary property table |
setChargeSOCs | Update state-of-charge values for all charge pulses in
TestSummary property table |
removePulse | Remove data of current pulse from HPPCTest object |
addPulseData | Add pulse data to TestSummary table |
plot | Plot HPPC test voltage over time |
plotPulse | Plot measured voltage for specific pulse index over time |
Version History
Introduced in R2025a