hppcTest

为混合脉冲功率特性测试数据创建测试容器对象

自 R2025a 起

说明

使用 hppcTest 创建一个 HPPCTest 容器对象，用于混合脉冲功率特性 (HPPC) 测试数据。使用此对象可从 HPPC 时间序列数据中自动提取并分析单个电流脉冲。HPPCTest 容器对象会对测试中每个脉冲的相关数据和元数据进行分类和整理，并允许您对数据进行预处理，为参数估计过程做好准备。TestSummary 属性包含一个表格，其中汇总了所有脉冲信息。

您可以通过设置 HPPCData 属性，将测试时间、测量电压和电流数据加载到该对象中。HPPCData 属性必须包含一系列恒定电流脉冲，这些脉冲需施加于处于多个工作点的电池上，包括不同的电荷状态、温度和电流值。HPPCData 属性的类型可以是 double、table 或 timetable。如果将 HPPCData 属性指定为 double 矩阵，则该矩阵的各列必须依次对应时间、电压和电流。如果将 HPPCData 属性指定为表格或时间表，则必须提供一个有效的列名或变量名。此外，为了提高测试断点的统计准确性，您还可以定义测得的电池单元温度、计算出的电荷状态、初始电荷状态以及电池容量。

通过定义 DischargePulseIndicesInternal 和 ChargePulseIndicesInternal 属性，HPPCTest 对象还允许您手动定义一个矩阵，其中包含每个单独脉冲的起始和结束索引。

要估计每个脉冲的等效电路模型的参数，请将此对象和一个 ECM 对象作为输入传递给 fitECM 函数。该图展示了从 HPPC 测试数据估计等效电路模型参数的典型工作流程：

创建对象

语法

hppcExp = hppcTest

hppcExp = hppcTest(HPPCData,PropertyName=Value)

描述

hppcExp = hppcTest 创建了一个默认的空 HPPC 测试容器对象 hppcExp，并为其设置了默认属性值。

hppcExp = hppcTest(HPPCData,PropertyName=Value) 为混合脉冲功率特性测试数据 HPPCData 创建一个测试容器对象，并使用一个或多个名称-值参量设置其属性。

输入参量

全部展开

`HPPCData` — 混合脉冲功率特性数据
双精度矩阵 | `table` 对象 | `timetable` 对象

从脉冲功率表征实验中测得的时域、电压和电流数据，指定为双精度数组的矩阵、table 对象或 timetable 对象。

如果将 HPPCData 属性指定为一个双精度数组，软件会默认该数组的各列分别表示时间、电压和电流，顺序依次为时间、电压、电流。

如果将 HPPCData 属性指定为表或时间表，则必须使用 TimeVariable、VoltageVariable 和 CurrentImpedanceVariable 参量来指定每个列或变量名称。

此参量设置 HPPCData 属性。

属性

全部展开

`HPPCData` — 混合脉冲功率特性数据
矩阵 | `table` 对象 | `timetable` 对象

从脉冲功率表征实验中测得的时域、电压和电流数据，以矩阵、table 对象或 timetable 对象的形式指定。

如果将 HPPCData 属性指定为矩阵，软件会默认该矩阵的各列分别表示时间、电压和电流，顺序依次为时间、电压、电流。

如果将 HPPCData 属性指定为表或时间表，则必须使用 TimeVariable、VoltageVariable 和 CurrentImpedanceVariable 参量来指定每个列或变量名称。

数据类型: double | table

`Temperature` — HPPC 实验期间测得的电池温度
`zeros(0,1)` (默认) | 标量 | 向量 | `table` 对象 | `timetable` 对象

在混合脉冲功率特性实验中测得的电池温度，指定为标量 (自 R2026a 起)、向量、数组或时间表。如果将此属性指定为表或时间表，则必须使用 TemperatureVariable 属性来定义温度列或变量名称。

如果未将此属性指定为标量，则该属性的元素个数必须与 HPPCData 属性的元素个数一致。

数据类型: double | table

`StateOfCharge` — 在 HPPC 实验期间测得的电池电荷状态
`zeros(0,1)` (默认) | 标量 | 向量 | `table` 对象 | `timetable` 对象

在混合脉冲功率特性实验期间测得的电池电荷状态，指定为标量 (自 R2026a 起)、向量、数组或时间表。该属性的值必须在 [0,1] 范围内。如果将此属性指定为表格或时间表，则必须使用 StateOfChargeVariable 属性定义电荷状态列或变量名称。

如果未将此属性指定为标量，则该属性的元素个数必须与 HPPCData 属性的元素个数一致。

数据类型: double | table

`Charge` — HPPC 实验期间测得的电池电量
`zeros(0,1)` (默认) | 标量 | 向量 | `table` 对象 | `timetable` 对象

在混合脉冲功率特性实验中测得的电池电荷量，指定为标量 (自 R2026a 起)、向量、表格或时间表。如果将此属性指定为表格或时间表，则必须使用 ChargeVariable 属性来定义费用列或变量名称。

如果未将此属性指定为标量，则该属性的元素个数必须与 HPPCData 属性的元素个数一致。

数据类型: double | table

`OpenCircuitVoltage` — 开路电压变量
`zeros(0,1)` (默认) | 标量 | 向量 | `table` 对象 | `timetable` 对象

开路电压可变，指定为标量 (自 R2026a 起)、向量、数组或时间表。如果将此属性指定为表或时间表，则必须使用 OpenCircuitVoltageVariable 属性来定义温度列或变量名称。

如果未将此属性指定为标量，则该属性的元素个数必须与 HPPCData 属性的元素个数一致。

数据类型: double | table

`CurrentOnThreshold` — 阈值电流值
`0` (默认) | 标量

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

数据类型: double

`VoltageChangeThreshold` — 电压变化的阈值
`0` (默认) | 标量

用于指示正在发生充电还是放电的电压变化值，以标量形式指定。

数据类型: double

`ValidPulseDurationRange` — 脉冲验证的有效脉冲持续时间范围
`[2,60]` (默认) | 向量

表示脉冲是否有效的有效脉冲持续时间范围（单位为秒），以 1-by-2 向量形式指定。如果脉冲有效，软件会将其存储在 TestSummary 属性中。

将该属性的上限降低至低于 60 秒的值，可确保非常长的放电过程（例如容量检测）不会被纳入用于估算的最终脉冲列表中。将该属性的下限值提高至大于一秒或两秒的值，可确保该函数将潜在噪声、异常电流或异常短脉冲排除在最终用于估计的脉冲列表之外。

数据类型: double

`ValidVoltageRange` — 脉冲验证的有效电池电压范围
`[0,inf]` (默认) | 向量

用于指示脉冲是否有效的有效电池电压范围，指定为 1-by-2 向量。如果脉冲有效，软件会将其存储在 TestSummary 属性中。

数据类型: double

`PreDischargeBuffer` — 在提取的放电脉冲前添加的时间
`0` (默认) | 标量

在提取的放电脉冲前添加放电脉冲的时间间隔，以标量形式指定。

数据类型: double

`PreChargeBuffer` — 在提取的电荷脉冲中添加电荷脉冲之前的时间
`0` (默认) | 标量

在提取的电荷脉冲前添加电荷脉冲所需的时间，以标量形式指定。

数据类型: double

`NumSamplesRequirement` — 连续点数
`1` (默认) | 标量

表示存在充电或放电脉冲时，电流必须大于 CurrentOnThreshold 属性值的连续数据点数量，以标量形式指定。

数据类型: double

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

放电期间输入电流的符号约定，指定为 "negativeDischarge" 或 "positiveDischarge"。

数据类型: string | char

`Capacity` — 用于库仑计数算法的电池容量
`[]` (默认) | 向量

用于库仑计数算法的电池容量（单位为安时），以向量形式指定。

数据类型: double

`InitialSOC` — 实验开始时的电池电荷状态
`[]` (默认) | 元素在 [0,1] 范围内的向量

实验开始时电池的电荷状态，指定为一个元素范围在 [0,1] 之间的向量。该值用于库仑计数算法。

数据类型: double

`DischargePulseIndices` — 放电脉冲的起始指数
只读: `[]` (默认) | 向量

此属性为只读。

HPPCData 矩阵或表中放电脉冲起始位置的索引，以向量形式返回。

数据类型: double

`ChargePulseIndices` — 电荷脉冲的起始索引
只读: `[]` (默认) | 向量

此属性为只读。

HPPCData 矩阵或表格中电荷脉冲起始位置的索引，以向量形式返回。

数据类型: double

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

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

数据类型: string | char

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

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

数据类型: string | char

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

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

数据类型: string | char

`ChargeVariable` — `Charge` 表中电荷变量的名称
"Charge" (默认) | 字符串标量 | 字符向量

Charge 属性表中当前变量的名称，指定为字符串标量或字符向量。

数据类型: string | char

`TemperatureVariable` — `Temperature` 表中温度变量的名称
"Temperature" (默认) | 字符串标量 | 字符向量

Temperature 属性表中温度变量的名称，指定为字符串标量或字符向量。

数据类型: string | char

`StateOfChargeVariable` — `StateOfCharge` 表中电荷状态变量的名称
"StateOfCharge" (默认) | 字符串标量 | 字符向量

StateOfCharge 属性表中电荷状态变量的名称，指定为字符串标量或字符向量。

数据类型: string | char

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

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

数据类型: string | char

`TestSummary` — 测试摘要
只读: `table`

此属性为只读。

测试摘要，以表格形式展示了所有已识别的脉冲及相关数据。

对象函数

`updateTestSummary`	更新 `TestSummary` 属性表
`setDischargeSOCs`	更新 `TestSummary` 属性表中所有放电脉冲的电荷状态值
`setChargeSOCs`	Update state-of-charge values for all charge pulses in `TestSummary` property table
`removePulse`	Remove data of current pulse from `HPPCTest` object
`addPulseData`	Add pulse data to `TestSummary` table
`plot`	Plot HPPC test voltage over time
`plotPulse`	Plot measured voltage for specific pulse index over time

版本历史记录

在 R2025a 中推出

全部展开

R2026a: 为 `Temperature`、`StateOfCharge`、`Charge` 和 `OpenCircuitVoltage` 属性指定标量值

现在，您可以为 Temperature、StateOfCharge、Charge 和 OpenCircuitVoltage 属性指定标量值。

在 R2026a 之前，您只能将这些属性的值指定为向量、表或时间表。

另请参阅

eisTest | hppcTestSuite | ecm | fitECM

hppcTest

说明

创建对象

语法

描述

输入参量

HPPCData — 混合脉冲功率特性数据 双精度矩阵 | table 对象 | timetable 对象

属性

HPPCData — 混合脉冲功率特性数据 矩阵 | table 对象 | timetable 对象

Temperature — HPPC 实验期间测得的电池温度 zeros(0,1) (默认) | 标量 | 向量 | table 对象 | timetable 对象

StateOfCharge — 在 HPPC 实验期间测得的电池电荷状态 zeros(0,1) (默认) | 标量 | 向量 | table 对象 | timetable 对象

Charge — HPPC 实验期间测得的电池电量 zeros(0,1) (默认) | 标量 | 向量 | table 对象 | timetable 对象

OpenCircuitVoltage — 开路电压变量 zeros(0,1) (默认) | 标量 | 向量 | table 对象 | timetable 对象

CurrentOnThreshold — 阈值电流值 0 (默认) | 标量

VoltageChangeThreshold — 电压变化的阈值 0 (默认) | 标量

ValidPulseDurationRange — 脉冲验证的有效脉冲持续时间范围 [2,60] (默认) | 向量

ValidVoltageRange — 脉冲验证的有效电池电压范围 [0,inf] (默认) | 向量

PreDischargeBuffer — 在提取的放电脉冲前添加的时间 0 (默认) | 标量

PreChargeBuffer — 在提取的电荷脉冲中添加电荷脉冲之前的时间 0 (默认) | 标量

NumSamplesRequirement — 连续点数 1 (默认) | 标量

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

Capacity — 用于库仑计数算法的电池容量 [] (默认) | 向量

InitialSOC — 实验开始时的电池电荷状态 [] (默认) | 元素在 [0,1] 范围内的向量

DischargePulseIndices — 放电脉冲的起始指数 只读: [] (默认) | 向量

ChargePulseIndices — 电荷脉冲的起始索引 只读: [] (默认) | 向量

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

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

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

ChargeVariable — Charge 表中电荷变量的名称 "Charge" (默认) | 字符串标量 | 字符向量

TemperatureVariable — Temperature 表中温度变量的名称 "Temperature" (默认) | 字符串标量 | 字符向量

StateOfChargeVariable — StateOfCharge 表中电荷状态变量的名称 "StateOfCharge" (默认) | 字符串标量 | 字符向量

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

TestSummary — 测试摘要 只读: table

对象函数

版本历史记录

R2026a: 为 Temperature、StateOfCharge、Charge 和 OpenCircuitVoltage 属性指定标量值

另请参阅

主题

`HPPCData` — 混合脉冲功率特性数据
双精度矩阵 | `table` 对象 | `timetable` 对象

`HPPCData` — 混合脉冲功率特性数据
矩阵 | `table` 对象 | `timetable` 对象

`Temperature` — HPPC 实验期间测得的电池温度
`zeros(0,1)` (默认) | 标量 | 向量 | `table` 对象 | `timetable` 对象

`StateOfCharge` — 在 HPPC 实验期间测得的电池电荷状态
`zeros(0,1)` (默认) | 标量 | 向量 | `table` 对象 | `timetable` 对象

`Charge` — HPPC 实验期间测得的电池电量
`zeros(0,1)` (默认) | 标量 | 向量 | `table` 对象 | `timetable` 对象

`OpenCircuitVoltage` — 开路电压变量
`zeros(0,1)` (默认) | 标量 | 向量 | `table` 对象 | `timetable` 对象

`CurrentOnThreshold` — 阈值电流值
`0` (默认) | 标量

`VoltageChangeThreshold` — 电压变化的阈值
`0` (默认) | 标量

`ValidPulseDurationRange` — 脉冲验证的有效脉冲持续时间范围
`[2,60]` (默认) | 向量

`ValidVoltageRange` — 脉冲验证的有效电池电压范围
`[0,inf]` (默认) | 向量

`PreDischargeBuffer` — 在提取的放电脉冲前添加的时间
`0` (默认) | 标量

`PreChargeBuffer` — 在提取的电荷脉冲中添加电荷脉冲之前的时间
`0` (默认) | 标量

`NumSamplesRequirement` — 连续点数
`1` (默认) | 标量

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

`Capacity` — 用于库仑计数算法的电池容量
`[]` (默认) | 向量

`InitialSOC` — 实验开始时的电池电荷状态
`[]` (默认) | 元素在 [0,1] 范围内的向量

`DischargePulseIndices` — 放电脉冲的起始指数
只读: `[]` (默认) | 向量

`ChargePulseIndices` — 电荷脉冲的起始索引
只读: `[]` (默认) | 向量

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

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

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

`ChargeVariable` — `Charge` 表中电荷变量的名称
"Charge" (默认) | 字符串标量 | 字符向量

`TemperatureVariable` — `Temperature` 表中温度变量的名称
"Temperature" (默认) | 字符串标量 | 字符向量

`StateOfChargeVariable` — `StateOfCharge` 表中电荷状态变量的名称
"StateOfCharge" (默认) | 字符串标量 | 字符向量

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

`TestSummary` — 测试摘要
只读: `table`

R2026a: 为 `Temperature`、`StateOfCharge`、`Charge` 和 `OpenCircuitVoltage` 属性指定标量值