estimateParameters

Estimate parameters

Syntax

estimateParameters(psObj)

estimateParameters(psObj,Name,Value)

Description

estimateParameters(psObj) estimates the parameters in the Battery.Parameters object. The method stores the results in an Battery.Parameters object.

estimateParameters(psObj,Name,Value) estimates the parameters in the Battery.Parameters object data with additional options specified by one or more Name,Value pair arguments.

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

• Powertrain Blockset™

• Curve Fitting Toolbox™

• Optimization Toolbox™

• Parallel Computing Toolbox™

• Simulink^® Design Optimization™

Input Arguments

psObj — Instance of Battery.PulseSequence class

Battery.PulseSequence object

Battery.PulseSequence object for the pulse sequence that you want to analyze.

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.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: estimateParameters(psObj,'CarryParamToNextPulse',true,'ShowPlots',true,'EstimateEm',true,'RetainEm',true,'EstimateR0',true,'RetainR0',true)

CarryParamsToNextPulse — Use results for next SOC

false (default) | true

Use this value to specify if the method uses the identified current pulse final state of charge (SOC) parameter values as the initial estimate for the parameter values at the next SOC.

Example: estimateParameters(psObj,'CarryParamsToNextPulse',true)

Data Types: logical

EstimateEm — Estimate voltage

true (default) | false

Use this value to specify if the method estimates the open circuit voltage, Em.

Example: estimateParameters(psObj,'EstimateEm',false)

Data Types: logical

RetainEm — Retain voltage estimate

true (default) | false

Use this value to specify if the method retains the identified open circuit voltage, Em, estimate. If EstimateEm is false, this option does to apply.

Example: estimateParameters(psObj,'RetainEm',false)

Data Types: logical

EstimateR0 — Estimate series resistance

true (default) | false

Use this value to specify if the method estimates the series resistance, R0.

Example: estimateParameters(psObj,'EstimateR0',false)

Data Types: logical

RetainR0 — Retain series resistance

true (default) | false

Use this value to specify if the method retains the series resistance, Ro, estimate. If EstimateR0 is false, this option does to apply.

Example: estimateParameters(psObj,'RetainR0',false)

Data Types: logical

SDOOptimizeOptions — Specify optimization options

'Method' is lsqnonlin and 'UseParallel' is true (default)

Use this value to specify the sdo.OptimizeOptions (Simulink Design Optimization) object options. For example:

SDOOptimizeOptions = sdo.OptimizeOptions(...
    'OptimizedModel',psObj.ModelName,...
    'Method','lsqnonlin',...
    'UseParallel','always')

ShowPlots — Show estimation plots

false (default) | true

Use this value to specify if the method shows plots during each estimation step.

Example: estimateParameters(psObj,'ShowPlots',true)

Data Types: logical

ReusePlotFigure — Reuse plots

true (default) | false

Use this value to specify if the method reuses the same plot figure. If false, the estimation plots are in separate figure windows. If ShowPlots is false, the option does not apply.

Example: estimateParameters(psObj,'ReusePlotFigure',true)

Data Types: logical

PlotDelay — Plot delay

5.0 (default) | scalar

Use this value to specify the time delay after showing the plots, in s.

Example: estimateParameters(psObj,'PlotDelay',0.1)

Data Types: double

PulseNumbers — Pulse numbers

1 (default) | scalar

Use this value to specify the pulse numbers to estimate. The default value, 1, is set to estimate all the pulses.

Data Types: uint32

Version History

Introduced in R2016b