All thermal blocks that are used in the thermal model are listed in the section below. The structure of the corresponding xml element and a code example is given for each block.

Abstract

Each thermal block can be specified by the attribute "class". Each thermal block can posses the xml tag <Heat>. The value indicated therein indicates the power loss in Watt. If the power loss is set at another point in the simulation (e.g. in the electrical model or as input of the Simulink S-function), this value will be ignored.

Base types

Rectangular thermal block

Object type: "RectangularBlock"

XML Tag	Type	Explanation
Material	material	material of the thermal block
Dimensions	comma-separated doubles	size of the thermal block in x, y, and z direction in meters
SizeX	integer	discretization of the thermal block in finite volumes in x direction
SizeY	integer	discretization of the thermal block in finite volumes in y direction
SizeZ	integer	discretization of the thermal block in finite volumes in z direction
InitialTemperature	double	initial temperature of the thermal block in °C
ElectricalDiscretization	double	discretization of the electrical cell elements within the thermal block. These have to fit into the thermal discretization in each dimension (e.g z-dimension: SizeZ modulo z == 0). If ElectricalDiscretization is not used, a single cell element will be addressed to this block. If one of the attributes x, y or z is missing, 1 will be used as the default value.
- Attribute x	integer	electrical discretization in x direction
- Attribute y	integer	electrical discretization in x direction
- Attribute z	integer	electrical discretization in x direction

<BlockType1 class="RectangularBlock">
    <Material cacheref="Rubber"/>
    <Dimensions>0.2, 0.2, 0.2</Dimensions>
    <SizeX>5</SizeX>
    <SizeY>6</SizeY>
    <SizeZ>7</SizeZ>
    <InitialTemperature>25.0</InitialTemperature>
</BlockType1>

Cylindrical cell surrounded by a rectangular block of fill material

Object type: "QuadraticCellBlock"

XML Tag	Type	Explanation
CellMaterial	material	material of the cell
FillMaterial	material	material of the block surrounding the cell
Length	double	length of the quadratic base area in meters
RadiusCell	double	radius of the cell in meters. The cell is placed centrally within the thermal block.
Height	double	height (in z direction) of the thermal block in meters
CellRhoDivision	integer	discretization of the battery cell in ρ direction
PhiDivision	integer	discretization of the thermal block in φ direction
HeightDivision	integer	discretization of the thermal block in z direction
InitialTemperature	double	initial temperature of the thermal block in °C
ArcPolygonization	double	suggested route for the polygonization of the existing arcs and circles
ElectricalDiscretization	double	discretization of the electrical cell elements within the thermal block. These have to fit into the thermal discretization in each dimension (e.g z-dimension: SizeZ modulo z == 0). If ElectricalDiscretization is not used, a single cell element will be addressed to this block. If one of the attributes phi or z is missing, 1 will be used as the default value.
- Attribute phi	integer	electrical discretization in phi direction
- Attribute z	integer	electrical discretization in x direction

<BlockType2 class="QuadraticCellBlock">
    <Length>0.1</Length>
    <RadiusCell>0.04</RadiusCell>
    <Height>0.2</Height>
    <CellRhoDivision>3</CellRhoDivision>
    <PhiDivision>8</PhiDivision>
    <HeightDivision>15</HeightDivision>
    <ArcPolygonization>0.001</ArcPolygonization>
    <CellMaterial cacheref="Electrolyte"/>
    <FillMaterial cacheref="Foam"/>
    <InitialTemperature>25</InitialTemperature>
</BlockType2>

Supercap cell with two radial layers surrounded by fill material within a rectangular block

Object type: "Supercap"

XML Tag	Type	Explanation
InnerCellMaterial	material	material of the inner layer of the cell
OuterCellMaterial	material	material of the outer layer of the cell
FillMaterial	material	material of the block surrounding the cell
Length	double	length of the quadratic base area in meters
InnerRadiusCell	double	radius of the boundary between the inner and outer layer in meters
OuterRadiusCell	double	radius of the supercap in meters. The cell is placed centrally within the thermal block.
Height	double	height (in z direction) of the thermal block in meters
PhiDivision	integer	discretization of the thermal block in φ direction
HeightDivision	integer	discretization of the thermal block in z direction
InitialTemperature	double	initial temperature of the thermal block in °C
ArcPolygonization	double	suggested route for the polygonization of the existing arcs and circles
ElectricalDiscretization	double	discretization of the electrical cell elements within the thermal block. These have to fit into the thermal discretization in each dimension (e.g z-dimension: SizeZ modulo z == 0). If ElectricalDiscretization is not used, a single cell element will be addressed to this block. If one of the attributes phi or z is missing, 1 will be used as the default value.
- Attribute phi	integer	electrical discretization in phi direction
- Attribute z	integer	electrical discretization in x direction

<SupercapCellBlock class="Supercap">
    <Length>0.078</Length>
    <InnerRadiusCell>0.03163</InnerRadiusCell>
    <OuterRadiusCell>0.0375</OuterRadiusCell>
    <Height>0.092</Height>
    <PhiDivision>8</PhiDivision>
    <HeightDivision>15</HeightDivision>
    <ArcPolygonization>0.001</ArcPolygonization>
    <InnerCellMaterial cacheref="SupercapInnerMaterial"/>
    <OuterCellMaterial cacheref="SupercapOuterMaterial"/>
    <FillMaterial cacheref="Epoxy"/>
    <InitialTemperature>25</InitialTemperature>
</SupercapCellBlock>

Cylindrical cell surrounded by a hexagonal prismatic block of fill material

Object type: "HexagonalCellBlock"

XML Tag	Type	Explanation
CellMaterial	material	material of the cell
FillMaterial	material	material of the block surrounding the cell
Length	double	edge length of the regular hexagonal base area of the thermal block in meters
RadiusCell	double	radius of the cell in meters. The cell is placed centrally within the thermal block.
Height	double	height (in z direction) of the thermal block in meters
CellRhoDivision	integer	discretization of the battery cell in ρ direction
PhiDivision	integer	discretization of the thermal block in φ direction
HeightDivision	integer	discretization of the thermal block in z direction
InitialTemperature	double	initial temperature of the thermal block in °C
ArcPolygonization	double	suggested route for the polygonization of the existing arcs and circles
ElectricalDiscretization	double	discretization of the electrical cell elements within the thermal block. These have to fit into the thermal discretization in each dimension (e.g z-dimension: SizeZ modulo z == 0). If ElectricalDiscretization is not used, a single cell element will be addressed to this block. If one of the attributes phi or z is missing, 1 will be used as the default value.
- Attribute phi	integer	electrical discretization in phi direction
- Attribute z	integer	electrical discretization in x direction

<BlockType class="HexagonalCellBlock">
    <Length>0.1</Length>
    <RadiusCell>0.04</RadiusCell>
    <Height>0.15</Height>
    <CellRhoDivision>2</CellRhoDivision>
    <PhiDivision>6</PhiDivision>
    <HeightDivision>3</HeightDivision>
    <ArcPolygonization>0.005</ArcPolygonization>
    <CellMaterial cacheref="Copper"/>
    <FillMaterial cacheref="Iron"/>
    <InitialTemperature>25</InitialTemperature>
</BlockType>

Triangular prismatic thermal block

Object type: "TriangularPrismBlock"

XML Tag	Type	Explanation
Material	material	material of the prism
Vertices	comma-separated doubles	vertices of the triangle that forms the base of the thermal block in xy coordinates.
Height	double	height (in z direction) of the thermal block in meters
HeightDivision	integer	discretization of the thermal block in z direction
InitialTemperature	double	initial temperature of the thermal block in °C
ElectricalDiscretization	double	discretization of the electrical cell elements within the thermal block. These have to fit into the thermal discretization in each dimension (e.g z-dimension: SizeZ modulo z == 0). If ElectricalDiscretization is not used, a single cell element will be addressed to this block. If the attribute z is missing, 1 will be used as the default value.
- Attribute z	integer	electrical discretization in x direction

<BlockType class="TriangularPrismBlock">
    <Vertices> 0.1, 0.2; -0.1, -0.2; 1.5, 4.5</Vertices>
    <Height>0.15</Height>
    <HeightDivision>3</HeightDivision>
    <Material cacheref="Copper"/>
    <InitialTemperature>25</InitialTemperature>
</BlockType>