Main Content

Battery.Pulse

Define a single pulse event

Description

Use the Battery.Pulse object to define a single experimental pulse event. To create a pulse object, use the Battery.PulseSequence object function createPulses.

To use the Battery.Pulse object and methods, you need these products:

  • Powertrain Blockset™

  • Curve Fitting Toolbox™

  • Optimization Toolbox™

  • Parallel Computing Toolbox™

  • Simulink® Design Optimization™

Creation

Description

example

MATLAB creates a pulseObj = Battery.Pulse(Battery.PulseSequence) object that defines a single pulse event.

Properties

expand all

An 1-by-5 array of pulse event data.

Array ElementDescriptionUnit
Data(1,1)

Time

s
Data(1,2)

Voltage

V
Data(1,3)

Current

A
Data(1,4)

Charge

A·s
Data(1,5)

State of charge (SOC)

Dimensionless

Data Types: double

Initial voltage of each capacitor during a pulse event, in V. Property set by the Battery.PulseSequence object function estimateParameters, based on the simulated end voltage or a prior pulse.

Data Types: double

Initial charge deficit at start of pulse event, in A·s. Property set by the Battery.PulseSequence object function createPulses when the function creates the series of Battery.Pulse objects.

Example: 0.0

Data Types: double

Indices to load data where the pulse event load begins and ends. Property set by the Battery.PulseSequence object function createPulses when the function creates the series of Battery.Pulse objects.

Data Types: int16

Indices to relaxation data where the pulse event relaxation begins and ends. Property set by the Battery.PulseSequence object function createPulses when the function creates the series of Battery.Pulse objects.

Data Types: int16

Index to first pulse event data point in the Battery.PulseSequence object data. Property set by the Battery.PulseSequence object function createPulses when the function creates the series of Battery.Pulse objects.

Data Types: int16

Use this value to specify if pulse is a discharge pulse event. Property set by the Battery.PulseSequence object function createPulses when the function creates the series of Battery.Pulse objects.

Data Types: logical

Battery.Parameters object containing the most recently determined battery equivalent circuit parameters. Property set by the Battery.PulseSequence object function createPulses when the function creates the series of Battery.Pulse objects.

Data Types: function_handle

Battery.ParametersHistory object array containing the history of the battery equivalent circuit parameters through different estimation steps. The last element is the most recent parameter set.

Data Types: function_handle

Object Functions

plotPlot pulse event data
getLoadDataRetrieve experimental data during load phase of pulse
getRelaxationDataRetrieve experimental data during relaxation phase of pulse
getTransitionDataRetrieve experimental data during transition phase of pulse

Examples

collapse all

This example shows how to create a Battery.Pulse object.

pulseObj = Battery.Pulse(psObj);

Version History

Introduced in R2016b