RCAIDE.Library.Methods.Powertrain.Sources.Batteries.Common.size_module_from_mass
size_module_from_mass#
- size_module_from_mass(battery_module)[source]#
Calculates the maximum energy and power of a battery module based on its mass.
- Parameters:
battery_module (BatteryModule) –
- The battery module with the following attributes:
- mass_properties.massfloat
Total mass of the battery module [kg]
- BMS_additional_weight_factorfloat
Factor accounting for battery management system weight
- cell.massfloat or None
Mass of a single cell [kg]
- cell.specific_energyfloat
Specific energy of the cell [J/kg]
- cell.specific_powerfloat
Specific power of the cell [W/kg]
- maximum_voltagefloat
Maximum voltage of the battery module [V]
- cell.maximum_voltagefloat
Maximum voltage of a single cell [V]
- Returns:
- This function modifies the battery_module object in-place, setting the following attributes:
- maximum_energyfloat
Maximum energy capacity of the battery module [J]
- maximum_powerfloat
Maximum power output of the battery module [W]
- initial_maximum_energyfloat
Initial maximum energy capacity (same as maximum_energy) [J]
- electrical_configuration.seriesint
Number of cells in series
- electrical_configuration.parallelint
Number of cells in parallel
- Return type:
None
Notes
This function calculates the energy and power capabilities of a battery module based on its mass and the specific energy/power characteristics of its cells. It also determines the electrical configuration (series/parallel arrangement) of the cells.
The function first calculates the effective mass of the cells by removing the mass contribution of the battery management system (BMS). It then uses this mass along with the specific energy and power values to determine the module’s capabilities.
If the cell mass is provided, the function calculates the number of cells that can fit within the module mass and arranges them in a series-parallel configuration based on the voltage requirements. If cell mass is not provided, a default configuration of 1 series × 1 parallel is used.
- Major Assumptions
Constant specific energy and power values
BMS weight is a fixed fraction of the total module weight
All cells have identical characteristics