 |
SUAVE
2.5.2
An Aerospace Vehicle Environment for Designing Future Aircraft
|
|
|
SUAVE
2.5.2
An Aerospace Vehicle Environment for Designing Future Aircraft
|
|
Public Member Functions | |
| def | __defaults__ (self) |
| def | energy_calc (self, numerics, battery_discharge_flag=True) |
| def | append_battery_unknowns (self, segment) |
| def | append_battery_residuals (self, segment, network) |
| def | append_battery_unknowns_and_residuals_to_segment (self, segment, initial_voltage, initial_battery_cell_temperature, initial_battery_state_of_charge, initial_battery_cell_current) |
| def | compute_voltage (self, state) |
| def | update_battery_state_of_health (self, segment, increment_battery_cycle_day=False) |
Public Attributes | |
| tag | |
| watt_hour_rating | |
| specific_energy | |
| specific_power | |
| resistance | |
| specific_heat_capacity | |
| discharge_performance_map | |
 Public Attributes inherited from SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion.Lithium_Ion | |
| tag | |
| cell | |
| module | |
| pack_config | |
| module_config | |
| age | |
| convective_heat_transfer_coefficient | |
| heat_transfer_efficiency | |
| cooling_fluid | |
| specific_energy | |
| specific_power | |
| Public Attributes inherited from SUAVE.Components.Energy.Storages.Batteries.Battery.Battery | |
| chemistry | |
| energy_density | |
| current_energy | |
| initial_temperature | |
| current_capacitor_charge | |
| resistance | |
| specific_heat_capacity | |
| max_energy | |
| max_power | |
| max_voltage | |
| discharge_performance_map | |
| ragone | |
| Public Attributes inherited from SUAVE.Components.Energy.Energy_Component.Energy_Component | |
| inputs | |
| outputs | |
| Public Attributes inherited from SUAVE.Components.Physical_Component.Physical_Component | |
| tag | |
| mass_properties | |
| origin | |
| symmetric | |
| Public Attributes inherited from SUAVE.Components.Component.Component | |
| tag | |
| origin | |
| generative_design_max_per_vehicle | |
| generative_design_characteristics | |
| generative_design_special_parent | |
Specifies discharge/specific energy characteristics specific
18650 lithium-nickel-manganese-cobalt-oxide battery cells
Assumptions:
Convective Thermal Conductivity Coefficient corresponds to forced
air cooling in 35 m/s air
Source:
Automotive Industrial Systems Company of Panasonic Group, Technical Information of
NCR18650G, URL https://www.imrbatteries.com/content/panasonic_ncr18650g.pdf
convective heat transfer coefficient, h
Jeon, Dong Hyup, and Seung Man Baek. "Thermal modeling of cylindrical
lithium ion battery during discharge cycle." Energy Conversion and Management
52.8-9 (2011): 2973-2981.
thermal conductivity, k
Yang, Shuting, et al. "A Review of Lithium-Ion Battery Thermal Management
System Strategies and the Evaluate Criteria." Int. J. Electrochem. Sci 14
(2019): 6077-6107.
specific heat capacity, Cp
(axial and radial)
Yang, Shuting, et al. "A Review of Lithium-Ion Battery Thermal Management
System Strategies and the Evaluate Criteria." Int. J. Electrochem. Sci 14
(2019): 6077-6107.
# Electrode Area
Muenzel, Valentin, et al. "A comparative testing study of commercial
18650-format lithium-ion battery cells." Journal of The Electrochemical
Society 162.8 (2015): A1592.
Inputs:
None
Outputs:
None
Properties Used:
N/A
| def SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion_LiNiMnCoO2_18650.Lithium_Ion_LiNiMnCoO2_18650.__defaults__ | ( | self | ) |
This sets the default inputs and outputs data structure. Assumptions: None Source: N/A Inputs: None Outputs: None Properties Used: N/A
Reimplemented from SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion.Lithium_Ion.
| def SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion_LiNiMnCoO2_18650.Lithium_Ion_LiNiMnCoO2_18650.append_battery_residuals | ( | self, | |
| segment, | |||
| network | |||
| ) |
Packs the residuals specific to NMC cells to be sent to the mission solver.
Assumptions:
None
Source:
N/A
Inputs:
segment.state.conditions.propulsion:
battery_state_of_charge [unitless]
battery_cell_temperature [Kelvin]
battery_current [Amperes]
segment.state.unknowns.
battery_state_of_charge [unitless]
battery_cell_temperature [Kelvin]
battery_current [Amperes]
Outputs:
None
Properties Used:
None
Reimplemented from SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion.Lithium_Ion.
| def SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion_LiNiMnCoO2_18650.Lithium_Ion_LiNiMnCoO2_18650.append_battery_unknowns | ( | self, | |
| segment | |||
| ) |
Appends unknowns specific to NMC cells which are unpacked from the mission solver and send to the network.
Assumptions:
None
Source:
N/A
Inputs:
segment.state.unknowns.battery_cell_temperature [Kelvin]
segment.state.unknowns.battery_state_of_charge [unitless]
segment.state.unknowns.battery_current [Amperes]
Outputs:
segment.state.conditions.propulsion.battery_cell_temperature [Kelvin]
segment.state.conditions.propulsion.battery_state_of_charge [unitless]
segment.state.conditions.propulsion.battery_current [Amperes]
Properties Used:
N/A
Reimplemented from SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion.Lithium_Ion.
| def SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion_LiNiMnCoO2_18650.Lithium_Ion_LiNiMnCoO2_18650.append_battery_unknowns_and_residuals_to_segment | ( | self, | |
| segment, | |||
| initial_voltage, | |||
| initial_battery_cell_temperature, | |||
| initial_battery_state_of_charge, | |||
| initial_battery_cell_current | |||
| ) |
Sets up the information that the mission needs to run a mission segment using this network
Assumptions:
None
Source:
N/A
Inputs:
initial_voltage [volts]
initial_battery_cell_temperature [Kelvin]
initial_battery_state_of_charge [unitless]
initial_battery_cell_current [Amperes]
Outputs
None
Properties Used:
N/A
Reimplemented from SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion.Lithium_Ion.
| def SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion_LiNiMnCoO2_18650.Lithium_Ion_LiNiMnCoO2_18650.compute_voltage | ( | self, | |
| state | |||
| ) |
Computes the voltage of a single NMC cell or a battery pack of NMC cells
Assumptions:
None
Source:
N/A
Inputs:
self - battery data structure [unitless]
state - segment unknowns to define voltage [unitless]
Outputs
V_ul - under-load voltage [volts]
Properties Used:
N/A
Reimplemented from SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion.Lithium_Ion.
| def SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion_LiNiMnCoO2_18650.Lithium_Ion_LiNiMnCoO2_18650.energy_calc | ( | self, | |
| numerics, | |||
battery_discharge_flag = True |
|||
| ) |
This is an electric cycle model for 18650 lithium-nickel-manganese-cobalt-oxide
battery cells. The model uses experimental data performed
by the Automotive Industrial Systems Company of Panasonic Group
Sources:
Internal Resistance Model:
Zou, Y., Hu, X., Ma, H., and Li, S. E., "Combined State of Charge and State of
Health estimation over lithium-ion battery cellcycle lifespan for electric
vehicles,"Journal of Power Sources, Vol. 273, 2015, pp. 793-803.
doi:10.1016/j.jpowsour.2014.09.146,URLhttp://dx.doi.org/10.1016/j.jpowsour.2014.09.146.
Battery Heat Generation Model and Entropy Model:
Jeon, Dong Hyup, and Seung Man Baek. "Thermal modeling of cylindrical lithium ion
battery during discharge cycle." Energy Conversion and Management 52.8-9 (2011):
2973-2981.
Assumtions:
1) All battery modules exhibit the same themal behaviour.
Inputs:
battery.
I_bat (max_energy) [Joules]
cell_mass (battery cell mass) [kilograms]
Cp (battery cell specific heat capacity) [J/(K kg)]
t (battery age in days) [days]
T_ambient (ambient temperature) [Kelvin]
T_current (pack temperature) [Kelvin]
T_cell (battery cell temperature) [Kelvin]
E_max (max energy) [Joules]
E_current (current energy) [Joules]
Q_prior (charge throughput) [Amp-hrs]
R_growth_factor (internal resistance growth factor) [unitless]
inputs.
I_bat (current) [amps]
P_bat (power) [Watts]
Outputs:
battery.
current_energy [Joules]
cell_temperature [Kelvin]
resistive_losses [Watts]
load_power [Watts]
current [Amps]
battery_voltage_open_circuit [Volts]
cell_charge_throughput [Amp-hrs]
internal_resistance [Ohms]
battery_state_of_charge [unitless]
depth_of_discharge [unitless]
battery_voltage_under_load [Volts]
Reimplemented from SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion.Lithium_Ion.
| def SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion_LiNiMnCoO2_18650.Lithium_Ion_LiNiMnCoO2_18650.update_battery_state_of_health | ( | self, | |
| segment, | |||
increment_battery_cycle_day = False |
|||
| ) |
This is an aging model for 18650 lithium-nickel-manganese-cobalt-oxide batteries.
Source:
Schmalstieg, Johannes, et al. "A holistic aging model for Li (NiMnCo) O2
based 18650 lithium-ion batteries." Journal of Power Sources 257 (2014): 325-334.
Assumptions:
None
Inputs:
segment.conditions.propulsion.
battery_cycle_day [unitless]
battery_cell_temperature [Kelvin]
battery_voltage_open_circuit [Volts]
battery_charge_throughput [Amp-hrs]
battery_state_of_charge [unitless]
Outputs:
segment.conditions.propulsion.
battery_capacity_fade_factor (internal resistance growth factor) [unitless]
battery_resistance_growth_factor (capactance (energy) growth factor) [unitless]
Properties Used:
N/A
Reimplemented from SUAVE.Components.Energy.Storages.Batteries.Constant_Mass.Lithium_Ion.Lithium_Ion.
1.8.15