RCAIDE.Library.Methods.Powertrain.Sources.Batteries.Common.compute_module_properties

compute_module_properties

compute_module_properties(battery_module)

Calculates module level properties of battery module using cell properties and module configuration.

Parameters:

battery_module (BatteryModule) –

The battery module with the following attributes:

• cell.nominal_capacityfloat

  Nominal capacity of a single cell [Ah]

• cell.maximum_voltagefloat

  Maximum voltage of a single cell [V]

• cell.massfloat

  Mass of a single cell [kg]

• electrical_configuration.seriesint

  Number of cells in series

• electrical_configuration.parallelint

  Number of cells in parallel

• geometrtic_configurationGeometricConfiguration

  Object containing geometric layout information

• volume_packaging_factorfloat

  Factor accounting for additional volume due to packaging

• orientation_euler_anglesnumpy.ndarray

  Euler angles for module orientation [rad]

• BMS_additional_weight_factorfloat

  Factor accounting for battery management system weight

Returns:

This function modifies the battery_module object in-place, setting the following attributes:

• lengthfloat

  Length of the battery module [m]

• widthfloat

  Width of the battery module [m]

• heightfloat

  Height of the battery module [m]

• mass_properties.massfloat

  Total mass of the battery module [kg]

• specific_energyfloat

  Specific energy of the battery module [Wh/kg]

• maximum_energyfloat

  Maximum energy capacity of the battery module [J]

• specific_powerfloat

  Specific power of the battery module [W/kg]

• maximum_powerfloat

  Maximum power output of the battery module [W]

• maximum_voltagefloat

  Maximum voltage of the battery module [V]

• initial_maximum_energyfloat

  Initial maximum energy capacity [J]

• nominal_capacityfloat

  Nominal capacity of the battery module [Ah]

• voltagefloat

  Voltage of the battery module [V]

Return type:

None

Notes

This function calculates the physical and electrical properties of a battery module based on the properties of its constituent cells and the module configuration.

The physical dimensions are calculated based on the geometric layout of cells, including spacing between cells and a volume packaging factor. The module orientation can be adjusted using Euler angles.

The electrical properties are calculated based on the series-parallel configuration of cells, with series connections increasing voltage and parallel connections increasing capacity.

Major Assumptions

• Total battery module pack mass can be modeled with a build-up factor for battery module casing, internal wires, thermal management system and battery module management system.

References

[1] Chin, J. C., Schnulo, S. L., Miller, T. B., Prokopius, K., and Gray, J., “Battery Performance Modeling on Maxwell X-57”, AIAA Scitech, San Diego, CA, 2019. URL http://openmdao.org/pubs/chin_battery_performance_x57_2019.pdf.