SUAVE  2.5.2
An Aerospace Vehicle Environment for Designing Future Aircraft
Battery

Functions pertaining to battery discharge and sizing. More...

Modules

 State_Estimation_Models
 Functions to evaluate battery state variables.
 
 Ragone
 Functions to evaluate a Ragone of the battery.
 
 Sizing
 Functions to size battery from mass, specific energy, and specific power.
 
 Variable_Mass
 Functions pertaining to variable mass batteries (such as metal air)
 

Functions

def SUAVE.Methods.Power.Battery.append_initial_battery_conditions.append_initial_battery_conditions (segment, battery)
 
def SUAVE.Methods.Power.Battery.compute_net_generated_battery_heat.compute_net_generated_battery_heat (n_total, battery, Q_heat_gen, numerics)
 
def SUAVE.Methods.Power.Battery.pack_battery_conditions.pack_battery_conditions (conditions, battery, avionics_payload_power, P)
 pack_battery_conditions.py More...
 

Detailed Description

Functions pertaining to battery discharge and sizing.

Function Documentation

◆ append_initial_battery_conditions()

def SUAVE.Methods.Power.Battery.append_initial_battery_conditions.append_initial_battery_conditions (   segment,
  battery 
)
Packs the initial battery conditions

    Assumptions:
    Battery temperature is set to one degree hotter than ambient 
    temperature for robust convergence. Initial mission energy, maxed aged energy, and 
    initial segment energy are the same. Cycle day is zero unless specified, resistance_growth_factor and
    capacity_fade_factor is one unless specified in the segment

    Source:
    N/A

    Inputs:  
        atmosphere.temperature             [Kelvin]
        
        Optional:
        segment.
             battery_cycle_day                  [unitless]
             battery_pack_temperature           [Kelvin]
             battery_charge_throughput          [Ampere-Hours] 
             battery_resistance_growth_factor   [unitless]
             battery_capacity_fade_factor       [unitless]
             battery_discharge                  [boolean]
             increment_battery_cycle_day        [boolean]
           
    Outputs:
        segment
           battery_discharge                    [boolean]
           increment_battery_cycle_day          [boolean]
        segment.state.conditions.propulsion
           battery_discharge_flag               [boolean]
           battery_max_initial_energy           [watts]
           battery_energy                       [watts]
           battery_max_aged_energy              [watts]    
           battery_pack_temperature             [kelvin]
           battery_cycle_day                    [int]
           battery_cell_charge_throughput       [Ampere-Hours] 
           battery_resistance_growth_factor     [unitless]
           battery_capacity_fade_factor         [unitless]




    Properties Used:
    None

◆ compute_net_generated_battery_heat()

def SUAVE.Methods.Power.Battery.compute_net_generated_battery_heat.compute_net_generated_battery_heat (   n_total,
  battery,
  Q_heat_gen,
  numerics 
)
Computes the net heat generated in a battery during cycling. 

Assumptions:
1) Battery pack cell heat transfer can be modelled as a cooling columns in a cross-flow
2) Isothermal battery cell - the temperature at the center of the cell is the same at 
the surface of the cell

Source: 
Heat Transfer Model:
Pakowski, Zdzisław. "Fundamentals of Heat and Mass Transfer, Frank P Incropera,
David P DeWitt, Theodore L Bergman, Adrienne S Lavine, J. Wiley & Sons, Hoboken
NJ (2007), 997 pp." (2007): 1683-1684.,  Chapter 7 pg 437-446 

Inputs:  
    battery. 
          h                         (heat transfer coefficient)  [W/(m^2*K)] 
          As_cell                   (battery cell surface area)  [meters^2]
          H_cell                    (battery cell height)        [meters]
          T_ambient                 (ambient temperature)        [Kelvin]
          T_current                 (pack temperature)           [Kelvin]
          T_cell                    (battery cell temperature)   [Kelvin] 
          heat_transfer_efficiency                               [unitless]
  
  Outputs:
    battery. 
         net_power                                               [Watts] 
 

Properties Used:
None 

◆ pack_battery_conditions()

def SUAVE.Methods.Power.Battery.pack_battery_conditions.pack_battery_conditions (   conditions,
  battery,
  avionics_payload_power,
  P 
)

pack_battery_conditions.py

Created: Sep 2021, M. Clarke

Packs the results from the network into propulsion data structures.

    Assumptions:
    None

    Source:
    N/A

    Inputs: 
    battery.
           inputs.current                  [Amperes]
           current_energy                  [Joules]
           voltage_open_circuit            [Volts]
           voltage_under_load              [Volts] 
           inputs.power_in                 [Watts]
           max_energy                      [Joules]
           cell_charge_throughput          [Ampere-hours]
           age                             [days]
           internal_resistance             [Ohms]
           state_of_charge                 [unitless]
           pack_temperature                [Kelvin]
           mass_properties.mass            [kilograms] 
           cell_voltage_under_load         [Volts]  
           cell_voltage_open_circuit       [Volts]  
           cell_current                    [Amperes]
           cell_temperature                [Kelvin] 
           heat_energy_generated           [Joules]
           cell_joule_heat_fraction        [unitless]  
           cell_entropy_heat_fraction      [unitless] 
           
    Outputs:
        conditions.propulsion.
           battery_current                    [Amperes]
           battery_energy                     [Joules]     
           battery_voltage_open_circuit       [Volts]     
           battery_voltage_under_load         [Volts]      
           battery_power_draw                 [Watts]     
           battery_max_aged_energy            [Joules]        
           battery_cycle_day                  [unitless]
           battery_internal_resistance        [Ohms]
           battery_state_of_charge            [unitless]
           battery_pack_temperature           [Kelvin]
           battery_efficiency                 [unitless]
           payload_efficiency                 [unitless]
           battery_specfic_power              [Watt-hours/kilogram]     
           electronics_efficiency             [unitless]
           battery_cell_power_draw            [Watts]
           battery_cell_energy                [Joules]
           battery_cell_voltage_under_load    [Volts]  
           battery_cell_voltage_open_circuit  [Volts]  
           battery_cell_current               [Amperes]
           battery_cell_temperature           [Kelvin]
           battery_cell_charge_throughput     [Ampere-Hours]
           battery_cell_heat_energy_generated [Joules]
           battery_cell_joule_heat_fraction   [unitless]  
           battery_cell_entropy_heat_fraction [unitless] 

    Properties Used:
    None