ParallelAssembly

Custom Simscape model of battery parallel assembly

Description

The ParallelAssembly block represents a custom generated system model of a battery parallel assembly. You can create this Simscape block by using the buildBattery function with a ParallelAssembly object as an input argument.

Variables

To set the priority and initial target values for the block variables prior to simulation, use the Initial Targets section in the block dialog box or Property Inspector. For more information, see Set Priority and Initial Target for Block Variables.

Nominal values provide a way to specify the expected magnitude of a variable in a model. Using system scaling based on nominal values increases the simulation robustness. Nominal values can come from different sources, one of which is the Nominal Values section in the block dialog box or Property Inspector. For more information, see System Scaling by Nominal Values.

Ports

Input

expand all

`CB` — Cell balancing, unitless
physical signal

Cell balancing port, specified as a physical signal.

Conserving

expand all

`+` — Positive terminal
electrical

Electrical conserving port associated with the positive terminal of the battery parallel assembly.

`-` — Negative terminal
electrical

Electrical conserving port associated with the negative terminal of the battery parallel assembly.

`AH` — Ambient thermal port
thermal

Thermal conserving port associated with the ambient thermal path.

Dependencies

To enable this port, set the AmbientThermalPort property of the ParallelAssembly object to "CellBasedThermalResistance".

`CH` — Coolant thermal port
thermal

Thermal conserving port associated with the coolant thermal path.

Dependencies

To enable this port, set the CoolantThermalPort property of the ParallelAssembly object to "CellBasedThermalResistance".

`CPT` — Cooling plate top port
thermal array-of-nodes

Thermal conserving port used to connect the top side of the module with a cooling plate. The size of this port depends on the number of models in the system. If you set the ModelResolution property to “Lumped”, this port outputs a scalar. If you set the ModelResolution property to “Detailed”, this port outputs a vector of size equal to the number of cells in the system. If you set the ModelResolution property to “Grouped”, this port outputs a vector of size depending on the grouping strategy.

Dependencies

To enable this port, set the CoolingPlate property of the ParallelAssembly object to "Top".

`CPB` — Cooling plate bottom port
thermal array-of-nodes

Thermal conserving port used to connect the bottom side of the module with a cooling plate. The size of this port depends on the number of models in the system. If you set the ModelResolution property to “Lumped”, this port outputs a scalar. If you set the ModelResolution property to “Detailed”, this port outputs a vector of size equal to the number of cells in the system. If you set the ModelResolution property to “Grouped”, this port outputs a vector of size depending on the grouping strategy.

Dependencies

To enable this port, set the CoolingPlate property of the ParallelAssembly object to "Bottom".

Parameters

expand all

The parameters of this block depend on how you define the ParallelAssembly object that you use to generate this custom model. The block parameters are divided into these sections:

The visibility of each section also depends on the generating ParallelAssembly object.

For a full list of the parameters in the Main, Dynamics, Fade, and Calender Aging sections, see the Battery (Table-Based) block.

Thermal

`Thermal mass` — Thermal mass
`100` `J/K` (default) | positive scalar

Energy required to raise the temperature of the thermal port by one degree.

`Cell level coolant thermal path resistance` — Coolant thermal path resistance at cell level
`1.2` `K/W` (default) | positive scalar

Resistance of the coolant thermal path at the cell level.

`Ambient thermal path resistance` — Ambient thermal path resistance at cell level
`25` `K/W` (default) | positive scalar

Resistance of the ambient thermal path at the cell level.