Main Content

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

Cell balancing port, specified as a physical signal.

Conserving

expand all

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

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

Thermal conserving port associated with the ambient thermal path.

Dependencies

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

Thermal conserving port associated with the coolant thermal path.

Dependencies

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

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".

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:

  • Main

  • Dynamics

  • Fade

  • Calendar Aging

  • Thermal

  • Cell Balancing

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

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

Resistance of the coolant thermal path at the cell level.

Resistance of the ambient thermal path at the cell level.

Parallel Assembly

Non-cell electrical resistance of each parallel assembly in the module.

Dependencies

To enable this parameter, set the NonCellResistance property of the ParallelAssembly object to "Yes".

Cell Balancing

Closed resistance of the cell balancing switch.

Open conductance of the cell balancing switch.

Threshold to activate the cell balancing switch operation.

Resistance of the cell balancing shunt.

Version History

Introduced in R2022b