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

Syntax

pulseObj = Battery.Pulse(Battery.PulseSequence)

Description

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

Properties

Data — Raw data

1-by-5 array

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

Array Element	Description	Unit
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

InitialCapVoltage — Initial capacitor voltage

array

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

InitialChargeDeficit — Initial charge deficit

0.0 (default) | scalar

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

idxLoad — Indices to load data

[1 0] (default)

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

idxRelax — Indices to relaxation data

[1 0] (default)

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

idxPulseSequence — Index to first pulse event data

[] (default)

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

IsDischarge — Discharge pulse

true (default)

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

Parameters — Battery.Parameters object properties

0-by-1 array

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

ParametersHistory — Battery.ParametersHistory object properties

0-by-1 array

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

plot	Plot pulse event data
getLoadData	Retrieve experimental data during load phase of pulse
getRelaxationData	Retrieve experimental data during relaxation phase of pulse
getTransitionData	Retrieve experimental data during transition phase of pulse

Examples

Create Battery.Pulse Object

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

pulseObj = Battery.Pulse(psObj);

Version History

Introduced in R2016b