fitEISModel

基于频率电化学阻抗谱数据，对电池分数阶模型进行阻抗参数估计

自 R2025a 起

语法

batteryEISModel = fitEISModel(eisData)

batteryEISModel = fitEISModel(eisData,Name=Value)

说明

fitEISModel 函数通过基于频率的电化学阻抗谱 (EIS) 数据，对电池分数阶等效电路模型 (FOECM) 进行阻抗参数估计。这些参数随后存储在 EISModel 对象中，您可以利用该对象分析或解释电池或燃料电池的阻抗数据。

该图展示了估计 FOECM 参数的典型工作流程：

batteryEISModel = fitEISModel(eisData) 根据电阻抗谱仪 (EIS) 数据 eisData，对具有默认属性的 EISModel 对象执行阻抗参数估计。该函数返回一个包含估计参数的 EISModel 对象。

batteryEISModel = fitEISModel(eisData,Name=Value) 根据 EIS 数据 eisData 执行阻抗参数估计，并通过名称-值参量指定附加选项。该函数返回一个包含估计参数的 EISModel 对象。

输入参数

全部折叠

`eisData` — 用于估计 EIS 模型参数的 EIS 数据
矩阵 | 表 | `EISTest` 对象

fitEISModel函数用于从 EIS 数据估计 EIS 模型参数的输入数据，可指定为矩阵、表或 EISTest 对象。

名称-值参数

全部折叠

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

示例: batteryEISModel = fitEISModel(myData,FittingMethod="fmincon")

`EISFOM` — 分数阶等效电路模型
`EISModel` 对象 (默认)

用于拟合电化学阻抗谱数据的分数阶等效电路模型，以 EISModel 对象形式指定。

`InitialParameterEstimate` — 首次优化迭代中使用的分数阶等效电路模型的初始参数值
`[0.0250 1.0000e-06 0.0035 0.8000 1 0.0350 0.8000 10 0.8000 100]` (默认) | 正元素向量

在优化第一轮迭代中使用的分数阶等效电路模型的初始参数值，以正数元素向量形式指定。

数据类型: double

`LowerParameterBounds` — 分数阶等效电路参数的下限
`[0 0 0 0 0 0 0 0 0 0]` (默认) | 非负元素向量

优化过程中使用的分数阶等效电路参数的下限，以非负元素向量形式指定。

数据类型: double

`UpperParameterBounds` — 分数阶等效电路参数的上界
`[2500 0.1000 350 1 100000 3.5000e+03 1 1000000 1 10000000]` (默认) | 非负元素向量

优化中使用的分数阶等效电路参数的上界，以非负元素向量形式指定。

数据类型: double

`ValidFrequencyRange` — 下限和上限截止频率值
`[1.0000e-06 1000]` (默认) | 包含两个正元素的向量

用于过滤基于频率的阻抗数据的上下限截断值，指定为包含两个正元素的向量。

数据类型: double

`IgnoreInductiveBehavior` — 移除所有显示感应行为的高频数据点的选项
false 或 `0` (默认) | true 或 `1`

移除所有显示感应行为的高频数据点的选项，可指定为 "false"、"true"，或数值/逻辑形式的 1 (true) 或 0 (false)。

数据类型: logical

`IgnoreIndices` — 需从频率基阻抗数据中剔除的指标
`[]` (默认) | 正标量 | 正元素向量

从基于频率的阻抗数据中需移除的索引，以标量或向量形式指定。

数据类型: double

`OptimizationWeights` — 基于频率的阻抗数据中的优化权重因子
`[]` (默认) | 标量 | 向量

应用于频率基阻抗数据中每个点的优化权重因子，以与阻抗数据长度相同的列向量形式指定。

数据类型: double

`OptimizationOptions` — 优化方法或拟合方法使用的优化选项
空 `structure` (默认) | `structure` | 选项对象

优化或拟合方法使用的优化选项，以结构体或选项对象的形式指定。有关选项对象的更多信息，请参阅设置优化选项 (Optimization Toolbox)。

数据类型: struct

`FittingMethod` — 用于确定最佳拟合频率基准阻抗数据的 `EISModel` 参数的拟合方法
"fminsearch" (默认) | "fmincon" | "lsqnonlin" | "patternsearch"

用于确定 EISModel 对象参数的最优拟合方法，该参数需与基于频率的阻抗数据最佳匹配，可选以下选项之一：

"fminsearch" - Simscape™ Battery™ 中的默认拟合方法。
"fmincon" - 需要 Optimization Toolbox™。
"lsqnonlin" - 需要 Optimization Toolbox。
"patternsearch" - 需要 Global Optimization Toolbox。

数据类型: char | string

`ImaginaryImpedanceSign` — 虚阻抗的符号约定
"standard" (默认) | "reversed"

虚阻抗的高频电感特性符号约定，指定为 "standard" 或 "reversed"。默认约定将高频感应行为视为正值。

数据类型: string | char

`InitializationStrategy` — 是否应依次初始化每个优化过程，或重用初始估计值
"reuseInitialEstimates" (默认) | "sequential"

是否依次初始化每个优化过程，或重用初始估计值，通过 "sequential" 或 "reuseInitialEstimates" 进行指定。对于顺序初始化，fitEISModel对象将首次优化的输出值用于下一次迭代。

数据类型: string | char

输出参量

全部折叠

`batteryEISModel` — 分数阶等效电路模型（基于估计参数的建模）
`EISModel` 对象

具有估计参数的分数阶等效电路模型，以 EISModel 对象形式返回。

版本历史记录

在 R2025a 中推出

另请参阅

eisModel | estimateBatteryEISParameters | eisParameterEstimator | eisTest

fitEISModel

语法

说明

输入参数

eisData — 用于估计 EIS 模型参数的 EIS 数据 矩阵 | 表 | EISTest 对象

名称-值参数

EISFOM — 分数阶等效电路模型 EISModel 对象 (默认)

InitialParameterEstimate — 首次优化迭代中使用的分数阶等效电路模型的初始参数值 [0.0250 1.0000e-06 0.0035 0.8000 1 0.0350 0.8000 10 0.8000 100] (默认) | 正元素向量

LowerParameterBounds — 分数阶等效电路参数的下限 [0 0 0 0 0 0 0 0 0 0] (默认) | 非负元素向量

UpperParameterBounds — 分数阶等效电路参数的上界 [2500 0.1000 350 1 100000 3.5000e+03 1 1000000 1 10000000] (默认) | 非负元素向量

ValidFrequencyRange — 下限和上限截止频率值 [1.0000e-06 1000] (默认) | 包含两个正元素的向量

IgnoreInductiveBehavior — 移除所有显示感应行为的高频数据点的选项 false 或 0 (默认) | true 或 1

IgnoreIndices — 需从频率基阻抗数据中剔除的指标 [] (默认) | 正标量 | 正元素向量

OptimizationWeights — 基于频率的阻抗数据中的优化权重因子 [] (默认) | 标量 | 向量

OptimizationOptions — 优化方法或拟合方法使用的优化选项 空 structure (默认) | structure | 选项对象

FittingMethod — 用于确定最佳拟合频率基准阻抗数据的 EISModel 参数的拟合方法 "fminsearch" (默认) | "fmincon" | "lsqnonlin" | "patternsearch"

ImaginaryImpedanceSign — 虚阻抗的符号约定 "standard" (默认) | "reversed"

InitializationStrategy — 是否应依次初始化每个优化过程，或重用初始估计值 "reuseInitialEstimates" (默认) | "sequential"

输出参量

batteryEISModel — 分数阶等效电路模型（基于估计参数的建模） EISModel 对象

版本历史记录

另请参阅

主题

`eisData` — 用于估计 EIS 模型参数的 EIS 数据
矩阵 | 表 | `EISTest` 对象

`EISFOM` — 分数阶等效电路模型
`EISModel` 对象 (默认)

`InitialParameterEstimate` — 首次优化迭代中使用的分数阶等效电路模型的初始参数值
`[0.0250 1.0000e-06 0.0035 0.8000 1 0.0350 0.8000 10 0.8000 100]` (默认) | 正元素向量

`LowerParameterBounds` — 分数阶等效电路参数的下限
`[0 0 0 0 0 0 0 0 0 0]` (默认) | 非负元素向量

`UpperParameterBounds` — 分数阶等效电路参数的上界
`[2500 0.1000 350 1 100000 3.5000e+03 1 1000000 1 10000000]` (默认) | 非负元素向量

`ValidFrequencyRange` — 下限和上限截止频率值
`[1.0000e-06 1000]` (默认) | 包含两个正元素的向量

`IgnoreInductiveBehavior` — 移除所有显示感应行为的高频数据点的选项
false 或 `0` (默认) | true 或 `1`

`IgnoreIndices` — 需从频率基阻抗数据中剔除的指标
`[]` (默认) | 正标量 | 正元素向量

`OptimizationWeights` — 基于频率的阻抗数据中的优化权重因子
`[]` (默认) | 标量 | 向量

`OptimizationOptions` — 优化方法或拟合方法使用的优化选项
空 `structure` (默认) | `structure` | 选项对象

`FittingMethod` — 用于确定最佳拟合频率基准阻抗数据的 `EISModel` 参数的拟合方法
"fminsearch" (默认) | "fmincon" | "lsqnonlin" | "patternsearch"

`ImaginaryImpedanceSign` — 虚阻抗的符号约定
"standard" (默认) | "reversed"

`InitializationStrategy` — 是否应依次初始化每个优化过程，或重用初始估计值
"reuseInitialEstimates" (默认) | "sequential"

`batteryEISModel` — 分数阶等效电路模型（基于估计参数的建模）
`EISModel` 对象