fitECM

根据基于时间的 HPPC 数据为电池 ECM 执行阻抗参数估计。

自 R2025a 起

语法

batteryECM = fitECM(pulseData)

batteryECM = fitECM(pulseData,Name=Value)

说明

fitECM 函数根据基于时间的混合脉冲功率特性 (HPPC) 数据，对电池等效电路模型 (ECM) 进行阻抗参数估计。这些参数随后会被存储在一个 ECM 对象中，您可以使用该对象对 Battery Equivalent Circuit 模块进行参数化。

您可以通过访问 ECM 对象的 ParameterSummary 属性，查看一个汇总了参数值的表格。

您可以获取电池在不同工作条件下的脉冲功率数据，例如不同的电荷状态、温度、负载电流以及电流方向。您可以将 HPPC 输入指定为矩阵、表格或时间表，其中包含单个恒流脉冲、HPPCTest 对象或 HPPCTestSuite 对象的相关信息。

要指定用于拟合数据的 ECM 拓扑结构，请设置 ECM 名称-值参量。您可以通过定义 FittingMethod 名称-值参量来指定所需的拟合算法。

该图展示了从 HPPC 测试数据估计等效电路模型参数的典型工作流程：

有关 fitECM 函数如何计算瞬时电阻 R0 的更多信息，请参阅 Calculate Instantaneous Resistance in Equivalent Circuit Models。

batteryECM = fitECM(pulseData) 根据 HPPC 数据 pulseData，对具有默认属性的 ECM 对象进行阻抗参数估计。该函数返回一个包含估计参数的 ECM 对象。

batteryECM = fitECM(pulseData,Name=Value) 根据 HPPC 数据对阻抗参数进行估计，pulseData，并通过名称-值参量指定其他选项。该函数返回一个包含估计参数的 ECM 对象。

输入参数

全部折叠

`pulseData` — 基于时间的 HPPC 数据
矩阵 | 表 | 时间表 | `HPPCTest` 对象 | `HPPCTestSuite` 对象

用于执行阻抗参数估计的基于时间的 HPPC 数据，指定为矩阵、表格、时间表、HPPCTest 对象或 HPPCTestSuite 对象。

名称-值参数

全部折叠

将可选参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

示例: batteryECM = fitECM(myData,SegmentToFit="Relaxation")

`ECM` — 用于拟合 HPPC 数据的等效电路模型
`ECM` 对象 (默认)

用于拟合 HPPC 数据的等效电路模型，指定为 ECM 对象。

`SegmentToFit` — 待拟合的脉冲片段
Load (默认) | loadAndRelaxation | Relaxation

要匹配的脉冲段或部分，指定为 "Load"、"LoadAndRelaxation" 或 "Relaxation"。

数据类型: char | string

`RelaxationSegmentFitTime` — 需添加以进行拟合的松弛时间
`10` (默认) | 正标量

要添加到拟合中的松弛时间，指定为一个正标量。

数据类型: double

`ThresholdForR0` — 计算瞬时电阻的时间范围
`0.1` (默认) | 正标量

用于计算瞬时电阻 R0 的时间间隔（单位为秒），指定为一个正标量。该阈值用于定义 R0 的值。

数据类型: double

`FittingMethod` — 用于寻找最能拟合基于时间的阻抗数据的 ECM 参数的拟合方法
"fminsearch" (默认) | "tfest" | "curvefit" | "mbc"

用于寻找最能拟合基于时间的阻抗数据的 ECM 参数的优化或拟合方法，指定为 "fminsearch"、"tfest"、"curvefit" 或 "mbc"。

"tfest" 选项需要 System Identification Toolbox™ 的许可证。

"curvefit" 选项需要 Curve Fitting Toolbox™ 的许可证。

"mbc" 选项需要 Model-Based Calibration Toolbox™ 的许可证。

数据类型: char | string

`CurrentSignConvention` — 放电过程中输入电流的符号约定
"negativeDischarge" (默认) | "positiveDischarge"

放电过程中输入电流的符号约定，指定为 "negativeDischarge" 或 "positiveDischarge"。

数据类型: char | string

`CurrentOnTreshold` — 指示正在发生充电还是放电的阈值电流
`0` (默认) | 非负标量

表示正在发生充电还是放电的阈值电流值（单位为安培），指定为标量。

数据类型: double

`InitialParameterEstimate` — 拟合方法第一轮迭代中使用的 ECM 初始参数值
`[0.0250 0.0250 10 0.0125 100]` (默认) | 非负元素向量

拟合方法第一轮迭代中使用的 ECM 初始参数值，指定为一个由非负元素组成的向量。

数据类型: double

`LowerParametersBounds` — 拟合法中等效电路参数的下限
`[0 0 0 0 0]` (默认) | 非负元素向量

拟合方法中使用的等效电路参数的下限，指定为一个由非负元素组成的向量。

数据类型: double

`UpperParameterBounds` — 拟合法中等效电路参数的上界
`[250 250 100000 125 1000000]` (默认) | 非负元素向量

拟合方法中使用的等效电路参数的上界，指定为一个由非负元素组成的向量。

数据类型: double

`Options` — 拟合选项
"optimset" (默认) | "fitoptions" | "idoptions.tfest"

针对您在 FittingMethod 名称-值参量中指定的方法的拟合选项，可指定为 "fitoptions"、""idoptions.tfest" 或 "optimset"。

数据类型: string | char

`TimeStep` — 输入数据应采用的时间步长
`0.1` (默认) | 正标量

当输入数据采用可变时间步长采样时，用于输入数据的时间步长，指定为一个正标量。

数据类型: double

`VoltageDetrend` — 电压去趋势策略
"constantOCV" (默认) | "hppcTestOCV"

当将 FittingMethod 名称-值参量设置为 "tfest" 时，电压去趋势策略，指定为 "constantOCV" 或 "hppcTestOCV"。

数据类型: string | char

`OpenCircuitVoltage` — 开路电压变量
`zeros(0,1)` (默认) | 表 | 时间表

开路电压可变，指定为向量、表格或时间表。

数据类型: double | table | timetable

`TimeVariable` — 时间变量的名称
"Time" (默认) | 字符串标量 | 字符向量

时间变量的名称，指定为字符串标量或字符向量。

数据类型: string | char

`VoltageVariable` — 电压变量的名称
"Voltage" (默认) | 字符串标量 | 字符向量

电压变量的名称，指定为字符串标量或字符向量。

数据类型: string | char

`CurrentVariable` — 当前变量的名称
"Current" (默认) | 字符串标量 | 字符向量

当前变量的名称，指定为字符串标量或字符向量。

数据类型: string | char

`OpenCircuitVoltageVariable` — 开路电压变量的名称
"OpenCircuitVoltage" (默认) | 字符串标量 | 字符向量

开路电压变量的名称，指定为字符串标量或字符向量。

数据类型: string | char

输出参量

全部折叠

`batteryECM` — 基于时间型 HPPC 数据估算参数的电池等效电路模型
`ECM` 对象

基于指定基于时间的 HPPC 数据估算的参数构建的电池等效电路模型，以 ECM 对象的形式返回。

fitECM

语法

说明

输入参数

`pulseData` — 基于时间的 HPPC 数据
矩阵 | 表 | 时间表 | `HPPCTest` 对象 | `HPPCTestSuite` 对象

名称-值参数

`ECM` — 用于拟合 HPPC 数据的等效电路模型
`ECM` 对象 (默认)

`SegmentToFit` — 待拟合的脉冲片段
Load (默认) | loadAndRelaxation | Relaxation

`RelaxationSegmentFitTime` — 需添加以进行拟合的松弛时间
`10` (默认) | 正标量

`ThresholdForR0` — 计算瞬时电阻的时间范围
`0.1` (默认) | 正标量

`FittingMethod` — 用于寻找最能拟合基于时间的阻抗数据的 ECM 参数的拟合方法
"fminsearch" (默认) | "tfest" | "curvefit" | "mbc"

`CurrentSignConvention` — 放电过程中输入电流的符号约定
"negativeDischarge" (默认) | "positiveDischarge"

`CurrentOnTreshold` — 指示正在发生充电还是放电的阈值电流
`0` (默认) | 非负标量

`InitialParameterEstimate` — 拟合方法第一轮迭代中使用的 ECM 初始参数值
`[0.0250 0.0250 10 0.0125 100]` (默认) | 非负元素向量

`LowerParametersBounds` — 拟合法中等效电路参数的下限
`[0 0 0 0 0]` (默认) | 非负元素向量

`UpperParameterBounds` — 拟合法中等效电路参数的上界
`[250 250 100000 125 1000000]` (默认) | 非负元素向量

`Options` — 拟合选项
"optimset" (默认) | "fitoptions" | "idoptions.tfest"

`TimeStep` — 输入数据应采用的时间步长
`0.1` (默认) | 正标量

`VoltageDetrend` — 电压去趋势策略
"constantOCV" (默认) | "hppcTestOCV"

`OpenCircuitVoltage` — 开路电压变量
`zeros(0,1)` (默认) | 表 | 时间表

`TimeVariable` — 时间变量的名称
"Time" (默认) | 字符串标量 | 字符向量

`VoltageVariable` — 电压变量的名称
"Voltage" (默认) | 字符串标量 | 字符向量

`CurrentVariable` — 当前变量的名称
"Current" (默认) | 字符串标量 | 字符向量

`OpenCircuitVoltageVariable` — 开路电压变量的名称
"OpenCircuitVoltage" (默认) | 字符串标量 | 字符向量

输出参量

`batteryECM` — 基于时间型 HPPC 数据估算参数的电池等效电路模型
`ECM` 对象

版本历史记录

另请参阅

函数

对象

模块

主题

fitECM

语法

说明

输入参数

pulseData — 基于时间的 HPPC 数据 矩阵 | 表 | 时间表 | HPPCTest 对象 | HPPCTestSuite 对象

名称-值参数

ECM — 用于拟合 HPPC 数据的等效电路模型 ECM 对象 (默认)

SegmentToFit — 待拟合的脉冲片段 Load (默认) | loadAndRelaxation | Relaxation

RelaxationSegmentFitTime — 需添加以进行拟合的松弛时间 10 (默认) | 正标量

ThresholdForR0 — 计算瞬时电阻的时间范围 0.1 (默认) | 正标量

FittingMethod — 用于寻找最能拟合基于时间的阻抗数据的 ECM 参数的拟合方法 "fminsearch" (默认) | "tfest" | "curvefit" | "mbc"

CurrentSignConvention — 放电过程中输入电流的符号约定 "negativeDischarge" (默认) | "positiveDischarge"

CurrentOnTreshold — 指示正在发生充电还是放电的阈值电流 0 (默认) | 非负标量

InitialParameterEstimate — 拟合方法第一轮迭代中使用的 ECM 初始参数值 [0.0250 0.0250 10 0.0125 100] (默认) | 非负元素向量

LowerParametersBounds — 拟合法中等效电路参数的下限 [0 0 0 0 0] (默认) | 非负元素向量

UpperParameterBounds — 拟合法中等效电路参数的上界 [250 250 100000 125 1000000] (默认) | 非负元素向量

Options — 拟合选项 "optimset" (默认) | "fitoptions" | "idoptions.tfest"

TimeStep — 输入数据应采用的时间步长 0.1 (默认) | 正标量

VoltageDetrend — 电压去趋势策略 "constantOCV" (默认) | "hppcTestOCV"

OpenCircuitVoltage — 开路电压变量 zeros(0,1) (默认) | 表 | 时间表

TimeVariable — 时间变量的名称 "Time" (默认) | 字符串标量 | 字符向量

VoltageVariable — 电压变量的名称 "Voltage" (默认) | 字符串标量 | 字符向量

CurrentVariable — 当前变量的名称 "Current" (默认) | 字符串标量 | 字符向量

OpenCircuitVoltageVariable — 开路电压变量的名称 "OpenCircuitVoltage" (默认) | 字符串标量 | 字符向量

输出参量

batteryECM — 基于时间型 HPPC 数据估算参数的电池等效电路模型 ECM 对象

版本历史记录

另请参阅

函数

对象

模块

主题

`pulseData` — 基于时间的 HPPC 数据
矩阵 | 表 | 时间表 | `HPPCTest` 对象 | `HPPCTestSuite` 对象

`ECM` — 用于拟合 HPPC 数据的等效电路模型
`ECM` 对象 (默认)

`SegmentToFit` — 待拟合的脉冲片段
Load (默认) | loadAndRelaxation | Relaxation

`RelaxationSegmentFitTime` — 需添加以进行拟合的松弛时间
`10` (默认) | 正标量

`ThresholdForR0` — 计算瞬时电阻的时间范围
`0.1` (默认) | 正标量

`FittingMethod` — 用于寻找最能拟合基于时间的阻抗数据的 ECM 参数的拟合方法
"fminsearch" (默认) | "tfest" | "curvefit" | "mbc"

`CurrentSignConvention` — 放电过程中输入电流的符号约定
"negativeDischarge" (默认) | "positiveDischarge"

`CurrentOnTreshold` — 指示正在发生充电还是放电的阈值电流
`0` (默认) | 非负标量

`InitialParameterEstimate` — 拟合方法第一轮迭代中使用的 ECM 初始参数值
`[0.0250 0.0250 10 0.0125 100]` (默认) | 非负元素向量

`LowerParametersBounds` — 拟合法中等效电路参数的下限
`[0 0 0 0 0]` (默认) | 非负元素向量

`UpperParameterBounds` — 拟合法中等效电路参数的上界
`[250 250 100000 125 1000000]` (默认) | 非负元素向量

`Options` — 拟合选项
"optimset" (默认) | "fitoptions" | "idoptions.tfest"

`TimeStep` — 输入数据应采用的时间步长
`0.1` (默认) | 正标量

`VoltageDetrend` — 电压去趋势策略
"constantOCV" (默认) | "hppcTestOCV"

`OpenCircuitVoltage` — 开路电压变量
`zeros(0,1)` (默认) | 表 | 时间表

`TimeVariable` — 时间变量的名称
"Time" (默认) | 字符串标量 | 字符向量

`VoltageVariable` — 电压变量的名称
"Voltage" (默认) | 字符串标量 | 字符向量

`CurrentVariable` — 当前变量的名称
"Current" (默认) | 字符串标量 | 字符向量

`OpenCircuitVoltageVariable` — 开路电压变量的名称
"OpenCircuitVoltage" (默认) | 字符串标量 | 字符向量

`batteryECM` — 基于时间型 HPPC 数据估算参数的电池等效电路模型
`ECM` 对象