Main Content

BatteryChart

Visualize battery objects

Description

Use BatteryChart to construct a battery chart for visualizing a Simscape Battery object.

Note

The BatteryChart object does not store or modify any of the properties of the objects it displays.

The BatteryChart object displays the battery object according to the global coordinate system for batteries:

To enable these labels in your chart, use the setDefaultLabels function. For more information about setting labels, see Set Labels for BatteryChart Object.

The BatteryChart object also allows you to check the current simulation strategy and model resolution of the battery component. To visualize the simulation strategy in the chart, set the SimulationStrategyVisible property to "on" or click on the "Show/hide simulation strategy" button on the top-right corner of the chart.

For example, if you set the ModelResolution property of a ParallelAssembly object to "Lumped", the object automatically scales the electrical parameters of the cell model blocks by using the NumParallelCells property. This figure shows the simulation strategy for a lumped parallel assembly:

Only one cell model block represents all the cell components inside the orange box.

If you set the ModelResolution property of a ParallelAssembly object to "Grouped", a number of cell model blocks equal to the value of the NumParallelCells property represents each cell component instead.

Creation

Description

example

import simscape.battery.builder.*; chart = BatteryChart(Name=Value) creates a BatteryChart object that visualizes the battery object specified in the Battery property, in the container specified in the Parent property. This syntax also sets further Properties using one or more name-value arguments

Properties

expand all

Container for the visualization of the battery, specified as a Figure object.

Battery object to visualize, specified as a Cell, ParallelAssembly, Module, ModuleAssembly, or Pack object.

Option to visualize the axes of the chart, specified as "on" or "off".

Direction of increasing values along the x-axis, specified as:

  • "normal" — Values increase outward from the center of the chart.

  • "reverse" — Values decrease outward from the center of the chart.

Direction of increasing values along the y-axis, specified as:

  • "normal" — Values increase outward from the center of the chart.

  • "reverse" — Values decrease outward from the center of the chart.

Direction of increasing values along the z-axis, specified as:

  • "normal" — Values increase outward from the center of the chart.

  • "reverse" — Values decrease outward from the center of the chart.

Visibility of the simulation strategy highlighted on the chart, specified as "on" or "off".

Color of the line for the simulation strategy highlighted on the chart, specified as an RGB triplet, a hexadecimal color code, a color name, or a short name.

For a custom color, specify an RGB triplet or a hexadecimal color code.

  • An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1]; for example, [0.4 0.6 0.7].

  • A hexadecimal color code is a character vector or a string scalar that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Thus, the color codes '#FF8800', '#ff8800', '#F80', and '#f80' are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

Color NameShort NameRGB TripletHexadecimal Color CodeAppearance
'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'Not applicableNot applicableNot applicableNo color

Here are the RGB triplets and hexadecimal color codes for the default colors.

RGB TripletHexadecimal Color CodeAppearance
[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

Style of the line for the simulation strategy highlighted on the chart, specified as a character vector or string containing symbols.

Example: '--' is a dashed line

Line StyleDescriptionResulting Line
'-'Solid line

Sample of solid line

'--'Dashed line

Sample of dashed line

':'Dotted line

Sample of dotted line

'-.'Dash-dotted line

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

Width of the line for the simulation strategy highlighted on the chart, specified as a positive value in points, where 1 point = 1/72 of an inch.

The line width cannot be thinner than the width of a pixel. If you set the line width to a value that is less than the width of a pixel on your system, the line displays as one pixel wide.

Color of light, specified as an RGB triplet, a hexadecimal color code, a color name, or a short name. The default RGB triplet of [1 1 1] corresponds to white.

RGB triplets and hexadecimal color codes are useful for specifying custom colors.

  • An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1]; for example, [0.4 0.6 0.7].

  • A hexadecimal color code is a character vector or a string scalar that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Thus, the color codes '#FF8800', '#ff8800', '#F80', and '#f80' are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

Color NameShort NameRGB TripletHexadecimal Color CodeAppearance
'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

Here are the RGB triplets and hexadecimal color codes for the default colors.

RGB TripletHexadecimal Color CodeAppearance
[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

Example: 'green'

Type of light source, specified as:

  • 'infinite' — Place the light at infinity. Use the LightPosition property to specify the direction from which the light shines in parallel rays.

  • 'local' — Place the light at the location specified by the LightPosition property. The light is a point source that radiates from the location in all directions.

Location of light source, specified as a three-element vector of the form [x y z]. Define the vector elements in data units from the axes origin to the (x, y, z) coordinate. The actual location of the light depends on the value of the LightStyle property.

Example: [-40 -4 140]

Visibility of light from light source, specified as 'on' or 'off', or as numeric or logical 1 (true) or 0 (false). A value of 'on' is equivalent to true, and 'off' is equivalent to false. Thus, you can use the value of this property as a logical value.

Examples

collapse all

Create a cylindrical Cell object.

batteryCell = Cell(Geometry=CylindricalGeometry)

Modify the position of the cell.

batteryCell.Position = [1 1 1]

Use the BatteryChart object to visualize the Cell object.

cellChart = BatteryChart(Battery=batteryCell)

To set the labels for a BatteryChart object, follow the steps in Visualize Cell Object with Cylindrical Geometry to create a BatteryChart object and then use the setDefaultLabels method.

cellChart.setDefaultLabels

Version History

Introduced in R2022b