Main Content

Model Thermal Boundary Conditions at Edges of Battery Systems

Simscape™ Battery™ allows you to expose the thermal nodes of the cells located at the surface boundaries of a battery parallel assembly or module. These thermal boundary conditions affect the battery cells at the edges or boundaries of a battery system, which then experience different thermal dynamics compared to the battery cells inside the battery assembly. By exposing the thermal nodes, you can model and analyze the heat transfer within the battery more accurately, simulate the interaction between the battery surface and the environment, study the temperature gradients across the battery cells, and integrate thermal management systems into the simulation model more easily.

This figure shows the boundaries where you can expose the vectorized or scalar thermal nodes for the battery cells:

To expose the thermal nodes at a specific surface boundary, specify the XminThermalNodes, XmaxThermalNodes, YminThermalNodes, and YmaxThermalNodes properties of a ParallelAssembly or Module object. You can set these properties to:

  • "None" — Do not expose thermal nodes.

  • "Scalar" — Expose a lumped thermal node at the minimum or maximum axis surface boundary.

  • "Vectorized" — Expose an array of thermal nodes at the minimum or maximum axis surface boundary.

For an example on how to implement scalar and vectorized thermal boundary conditions, see Add Vectorized and Scalar Thermal Boundary Conditions to Battery Models.

Expose Thermal Nodes at Surface Boundaries for Parallel Assemblies

The model and simulation output for a battery parallel assembly with exposed thermal nodes at a specific surface boundary depend on the surface thermal boundaries and model resolution of the parallel assembly.

This table shows the relationship between the surface thermal boundaries, the model resolution, and the affected cells. The CellsAtXminBoundary, CellsAtXmaxBoundary, CellsAtYminBoundary, and CellsAtYmaxBoundary properties are read-only properties that show the indexes of the cells at the specified minimum or maximum axis surface boundary, returned as vectors of integers.

Parallel Assembly Thermal BoundaryModelSimulation OutputLayout

XminThermalNodes = "Scalar"

Model Resolution: Detailed

Layout

1   6   11   16   21   26
2   7   12   17   22   27
3   8   13   18   23   28
4   9   14   19   24   29
5  10   15   20   25   30

CellsAtXminBoundary

1   6   11   16   21   26

XmaxThermalNodes = "Scalar"

Model Resolution: Detailed

CellsAtXmaxBoundary

5   10   15   20   25   30

XminThermalNodes = "Scalar"

XmaxThermalNodes = "Scalar"

YminThermalNodes = "Scalar"

YmaxThermalNodes = "Scalar"

Model Resolution: Detailed

CellsAtXminBoundary

1   6   11   16   21   26

CellsAtXmaxBoundary

5   10   15   20   25   30

CellsAtYminBoundary

1   2   3   4   5

CellsAtYmaxBoundary

26   27   28   29   30

XminThermalNodes = "Scalar"

Model Resolution: Lumped

CellsAtXminBoundary

1   6   11   16   21   26

XminThermalNodes = "Vectorized"

Model Resolution: Detailed

Layout

1   6   11   16   21   26
2   7   12   17   22   27
3   8   13   18   23   28
4   9   14   19   24   29
5  10   15   20   25   30

CellsAtXminBoundary

1   6   11   16   21   26

XmaxThermalNodes = "Vectorized"

Model Resolution: Detailed

CellsAtXmaxBoundary

5   10   15   20   25   30

XminThermalNodes = "Vectorized"

XmaxThermalNodes = "Vectorized"

YminThermalNodes = "Vectorized"

YmaxThermalNodes = "Vectorized"

Model Resolution: Detailed

CellsAtXminBoundary

1   6   11   16   21   26

CellsAtXmaxBoundary

5   10   15   20   25   30

CellsAtYminBoundary

1   2   3   4   5

CellsAtYmaxBoundary

26   27   28   29   30

Expose Thermal Nodes at Surface Boundaries for Modules

The model and simulation output for a battery module with exposed thermal nodes at a specific surface boundary depend on the surface thermal boundaries and model resolution of the module.

This table shows the relationship between the surface thermal boundaries, the model resolution, and the affected cells. The CellsAtXminBoundary, CellsAtXmaxBoundary, CellsAtYminBoundary, and CellsAtYmaxBoundary properties are read-only properties that show the indexes of the cells at the specified minimum or maximum axis surface boundary, returned as vectors of integers.

Module Thermal BoundaryModel and Simulation OutputLayout

XminThermalNodes = "Vectorized"

Model Resolution: Detailed

Layout

 1     5     9    13
 2     6    10    14
 3     7    11    15
 4     8    12    16
17    21    25    29
18    22    26    30
19    23    27    31
20    24    28    32
33    37    41    45
34    38    42    46
35    39    43    47
36    40    44    48

CellsAtXminBoundary

1   5   9   13

XmaxThermalNodes = "Vectorized"

Model Resolution: Detailed

CellsAtXmaxBoundary

36   40   44   48

YminThermalNodes = "Vectorized"

Model Resolution: Detailed

Layout

 1     5     9    13    17    21    25    29    33    37    41    45
 2     6    10    14    18    22    26    30    34    38    42    46
 3     7    11    15    19    23    27    31    35    39    43    47
 4     8    12    16    20    24    28    32    36    40    44    48

CellsAtYminBoundary

1   2   3   4

YmaxThermalNodes = "Vectorized"

Model Resolution: Detailed

Layout

 1     5     9    13    17    21    25    29    33    37    41    45
 2     6    10    14    18    22    26    30    34    38    42    46
 3     7    11    15    19    23    27    31    35    39    43    47
 4     8    12    16    20    24    28    32    36    40    44    48

CellsAtYmaxBoundary

45   46   47   48

XminThermalNodes = "Vectorized"

XmaxThermalNodes = "Vectorized"

YminThermalNodes = "Vectorized"

YmaxThermalNodes = "Vectorized"

Model Resolution: Detailed

CellsAtXminBoundary

1    5    9    13    17    21    25    29    33    37    41    45

CellsAtXmaxBoundary

4    8    12    16    20    24    28    32    36    40    44    48

CellsAtYminBoundary

1    2    3    4

CellsAtYmaxBoundary

45    46    47    48

See Also

Objects

Blocks

Topics