本页采用了机器翻译。点击此处可查看最新英文版本。

batteryChart

R2025b

可视化电池对象

自 R2022b 起

全页展开

描述

使用 batteryChart 构建电池图，用于可视化 Simscape™ Battery™ 对象。

注意

BatteryChart 对象存储其显示对象的独立副本，且不修改该对象的任何属性。

BatteryChart 对象根据电池的全局坐标系显示电池对象：

要在图中启用这些标签，请使用 setDefaultLabels 函数。有关设置标签的更多信息，请参阅为 BatteryChart 对象设置标签。

BatteryChart 对象还允许您检查电池组件的当前仿真策略和模型分辨率。要在图中可视化仿真策略，请将 SimulationStrategyVisible 属性设置为 "on"，或点击图右上角的“显示/隐藏仿真策略”按钮。

例如，若将 ParallelAssembly 对象的 ModelResolution 属性设置为 "Lumped"，该对象将自动通过 NumParallelCells 属性对电芯模型模块的电气参数进行缩放。该图展示了集中参数并联组件的仿真策略：

仅一个电芯模型模块就代表了橙色框内所有的电芯组件。

若将 ParallelAssembly 对象的 ModelResolution 属性设置为 "Grouped"，则每个电芯组件将由数量等同于 NumParallelCells 属性值的电芯模型模块来表示。

创建对象

语法

chart = batteryChart(Parent,Battery)
chart = batteryChart(Battery)
chart = batteryChart(___,Name=Value)

描述

chart = batteryChart(Parent,Battery) 创建一个 BatteryChart 对象，该对象在 Parent 属性指定的容器中可视化 Battery 属性中指定的电池对象。

示例

chart = batteryChart(Battery) 创建一个 BatteryChart 对象，该对象可可视化 Battery 属性中指定的电池对象。

chart = batteryChart(___,Name=Value) 使用一个或多个名称-值参量设置 属性。在上述任何语法中的所有参量之后指定名称-值参量。

属性

全部展开

用于电池可视化的容器，指定为 Figure 对象或使用 uifigure 函数创建的 Figure 对象，或其子容器之一：Tab、Panel、ButtonGroup、TiledChardLayout 或 GridLayout。

用于可视化的电池对象，指定为 Cell、ParallelAssembly、Module、ModuleAssembly 或 Pack 对象。

可选项：可视化图的坐标轴，指定为 "on" 或 "off"。

值沿 x 轴递增的方向，指定为：

  • "normal" - 值从图中心向外递增。

  • "reverse" - 值从图中心向外递减。

值沿 y 轴递增的方向，指定为：

  • "normal" - 值从图中心向外递增。

  • "reverse" - 值从图中心向外递减。

值沿 z 轴递增的方向，指定为：

  • "normal" - 值从图中心向外递增。

  • "reverse" - 值从图中心向外递减。

图中突出显示的仿真策略可见性，指定为 "on" 或 "off"。

图中仿真策略高亮显示的线条颜色，可通过 RGB 三元组、十六进制颜色代码、颜色名称或简短名称进行指定。

要设置自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是一个三元素行向量，其元素分别指定颜色中红、绿、蓝三种组件的强度值。强度值必须在 [0,1] 范围内；例如，[0.4 0.6 0.7]。

  • 十六进制颜色代码是一种字符向量或字符串标量，以井号符号（###）开头，后跟三个或六个十六进制数字，范围从#0#到#F#。这些值不区分大小写。因此，颜色代码 '#FF8800'、'#ff8800'、'#F80' 和 '#f80' 是等效的。

或者，您可以通过名称指定一些常用颜色。此表列出了命名颜色选项、对应的 RGB 三元组以及十六进制颜色代码。

颜色名称简称RGB 三元组十六进制颜色代码外观
'red''r'[1 0 0]'#FF0000'

Sample of the color red

'green''g'[0 1 0]'#00FF00'

Sample of the color green

'blue''b'[0 0 1]'#0000FF'

Sample of the color blue

'cyan' 'c'[0 1 1]'#00FFFF'

Sample of the color cyan

'magenta''m'[1 0 1]'#FF00FF'

Sample of the color magenta

'yellow''y'[1 1 0]'#FFFF00'

Sample of the color yellow

'black''k'[0 0 0]'#000000'

Sample of the color black

'white''w'[1 1 1]'#FFFFFF'

Sample of the color white

'none'不适用不适用不适用无色

以下是默认颜色的 RGB 三元组和十六进制颜色代码：

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]'#0072BD'

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]'#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]'#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]'#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]'#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]'#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]'#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

图中突出显示的仿真策略的线条样式，以字符向量或包含符号的字符串形式指定。

示例: '--' 是一条虚线

线型描述生成的行
'-'实线

Sample of solid line

'--'虚线

Sample of dashed line

':'点线

Sample of dotted line

'-.'虚线

Sample of dash-dotted line, with alternating dashes and dots

图中突出显示的仿真策略线宽，以点为单位指定为正值，其中 1 点=1/72 英寸。

线宽不能小于像素宽度。若将线宽设置为小于系统像素宽度的值，则该线将显示为 1 像素宽。

光的颜色，可通过 RGB 三元组、十六进制颜色代码、颜色名称或简短名称指定。[1 1 1] 的默认 RGB 三元组对应白色。

RGB 三元组和十六进制颜色代码可用于指定自定义颜色。

  • RGB 三元组是一个三元素行向量，其元素分别指定颜色中红、绿、蓝三种组件的强度值。强度值必须在 [0,1] 范围内；例如， [0.4 0.6 0.7]。

  • 十六进制颜色代码是一种字符向量或字符串标量，以井号符号（###）开头，后跟三个或六个十六进制数字，范围从#0#到#F#。这些值不区分大小写。因此，颜色代码 '#FF8800'、'#ff8800'、'#F80' 和 '#f80' 是等效的。

或者，您可以通过名称指定一些常用颜色。此表列出了命名颜色选项、对应的 RGB 三元组以及十六进制颜色代码。

颜色名称简称RGB 三元组十六进制颜色代码外观
'red''r'[1 0 0]'#FF0000'

Sample of the color red

'green''g'[0 1 0]'#00FF00'

Sample of the color green

'blue''b'[0 0 1]'#0000FF'

Sample of the color blue

'cyan' 'c'[0 1 1]'#00FFFF'

Sample of the color cyan

'magenta''m'[1 0 1]'#FF00FF'

Sample of the color magenta

'yellow''y'[1 1 0]'#FFFF00'

Sample of the color yellow

'black''k'[0 0 0]'#000000'

Sample of the color black

'white''w'[1 1 1]'#FFFFFF'

Sample of the color white

以下是默认颜色的 RGB 三元组和十六进制颜色代码：

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]'#0072BD'

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]'#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]'#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]'#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]'#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]'#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]'#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

示例: 'green'

光源类型，指定为：

  • 'infinite' - 将光源置于无限远处。使用 LightPosition 属性指定光线以平行光束形式照射的方向。

  • 'local' - 将光源放置在由 LightPosition 属性指定的位置。该光源为点光源，从该位置向各个方向辐射。

光源位置，以三元素向量形式指定，格式为 [x y z]。定义从坐标系原点到 (x, y, z) 坐标点的向量元素，单位为数据单位。光线的实际位置取决于 LightStyle 属性的值。

示例: [-40 -4 140]

光源发出的光的可见度，可指定为 'on' 或 'off'，或为数值型或逻辑型 1 (true) 或 0 (false)。值 'on' 等同于 true，而 'off' 等同于 false。因此，您可以将此属性的值用作逻辑值。

示例

全部折叠

创建一个圆柱 Cell 对象并修改其位置。

cell = batteryCell(batteryCylindricalGeometry,Position=[1 1 1])

使用 batteryChart 可视化 Cell 对象。

cellChart = batteryChart(cell)

要为 BatteryChart 对象设置标签，请按照可视化具有圆柱几何形状的电芯对象中的步骤创建 BatteryChart 对象，然后使用 setDefaultLabels 方法。

cellChart.setDefaultLabels

创建一个圆柱形 Cell 对象。

cell = batteryCell(batteryCylindricalGeometry)

使用 uifigure 函数创建一个 Figure 对象，并使用 batteryChart 来可视化 Cell 对象。 

fig = uifigure;
batteryChart(fig,cell);

BatteryChart 对象的 Parent 参量也可以是 uifigure 函数的子容器，例如 GridLayout 对象。使用 uigridlayout 函数在新图形中创建网格布局。 

fig = uifigure('Position',[100 100 440 320]);
g = uigridlayout(fig);
g.RowHeight = {220,220,'1x'};
g.ColumnWidth = {1500,'1x'};

在网格的第一行中添加一个下拉组件。

dd1 = uidropdown(g);
dd1.Items = {'Select a device'};

在网格的第二行中可视化 Cell 对象。

dd2 = batteryChart(g,myCell);
dd2.Layout.Row = 2;
dd2.Layout.Column = 1;

版本历史记录

在 R2022b 中推出

另请参阅

App

对象

主题