Battery Tools¶
-
PySAM.BatteryTools.battery_model_sizing(model, desired_power, desired_capacity, desired_voltage, leadacid_q10=None, leadacid_q20=None, leadacid_qn=None, leadacid_tn=None)¶ Modifies model with new sizing
Parameters: - model – PySAM.StandAloneBattery model
- desired_power – float kWAC if AC-connected, kWDC otherwise
- desired_capacity – float kWhAC if AC-connected, kWhDC otherwise
- desired_voltage – float volts
- leadacid_q10 – optional float new Capacity at 10-hour discharge rate
- leadacid_q20 – optional float new Capacity at 20-hour discharge rate
- leadacid_qn – optional float new Capacity at n-hour discharge rate
- leadacid_tn – optional float Hour for leadacid_qn
Returns: output_dictionary of sizing parameters
-
PySAM.BatteryTools.size_li_ion_battery(input_dict)¶ All efficiencies and rates in percentages, 0-100.
Inverter efficiency depends on which inverter model is being used, inverter_model.
Parameters: input_dict – - batt_chem: int
- Lithium-ion (1) or Lead-Acid (0)
- batt_Qfull: float, Ah
- capacity of single cell
- batt_Vnom_default: float, V
- voltage of single cell
- Required only if batt_chem is False:
- LeadAcid_q10: float 0-100, Ah
- 10 hour discharge rate
- LeadAcid_q20: float 0-100, Ah
- 20 hour discharge rate
- LeadAcid_tn: int, hour
- hour for custom hour discharge rate
- LeadAcid_qn: float 0-100, Ah
- n-hour discharge rate
- batt_ac_or_dc: bool
- True if ac-connected
- desired_power: float, kW
- power of the battery
- desired_capacity: float, kWh
- capacity
- desired_voltage: float, V
- voltage
- size_by_ac_not_dc: bool, default False
- True for sizing battery as kWAC and kWhAC
- batt_dc_ac_efficiency: float 0-100, required only if size_by_ac_not_dc is True
- AC to DC power in conversion
- inverter_eff: float 0-100, required only if batt_ac_or_dc is False
- AC to DC power from inverter
- batt_dc_dc_efficiency: float 0-100, optional
- DC to DC power conversion in battery management system
Returns: output_dict: voltage: float, V computed- power: float
- computed
- batt_computed_bank_capacity: float
- computed
- batt_computed_series: int
- number of cells connected in series
- batt_computed_strings: int
- number of strings connected in parallel
time_capacity: float 0-1
batt_current_charge_max: float, A
batt_current_discharge_max: float, A
batt_power_charge_max_kwac: float, kWAC
batt_power_discharge_max_kwac: float, kWAC
batt_power_charge_max_kwdc: float, kWDC
batt_power_discharge_max_kwdc: float, kWDC
- only if batt_chem is False:
- LeadAcid_q10_computed: float 0-100, Ah
LeadAcid_q20_computed: float 0-100, Ah
LeadAcid_qn_computed: float 0-100, Ah