# 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™

## Creation

### Syntax

``pulseObj = Battery.Pulse(Battery.PulseSequence)``

### 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

 `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

collapse all

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

`pulseObj = Battery.Pulse(psObj);`

## Version History

Introduced in R2016b