From GridLAB-D Wiki
battery – battery model
Synopsis
module generators; class battery { enumeration {UNKNOWN, CONSTANT_V, CONSTANT_PQ, CONSTANT_PF, SUPPLY_DRIVEN, POWER_DRIVEN, VOLTAGE_CONTROLLED, POWER_VOLTAGE_HYBRID} generator_mode ; enumeration {NONE=0, LINEAR_TEMPERATURE=1} additional_controls; enumeration {OFFLINE=1, ONLINE=2} generator_status; enumeration {HOUSEHOLD, SMALL=1, MED_COMMERCIAL, MED_HIGH_ENERGY, LARGE} rfb_size; enumeration {AC=2, DC=1} power_type; enumeration {CHARGING=1, DISCHARGING=2, WAITING=0, FULL=3, EMPTY=4, CONFLICTED=5} battery_state; double number_battery_state_changes; double monitored_power[W]; double power_set_high[W]; double power_set_low[W]; double power_set_high_highT[W]; double power_set_low_highT[W]; double check_power_low[W]; double check_power_high[W]; double voltage_set_high[V]; double voltage_set_low[V]; double deadband[V]; double sensitivity; double high_temperature; double midpoint_temperature; double low_temperature; double scheduled_power[W]; double Rinternal[Ohm]; double V_Max[V]; double I_Max[A]; double E_Max[Wh]; double P_Max[W]; double power_factor; double Energy[Wh]; double efficiency[unit]; double base_efficiency[unit]; double parasitic_power_draw[W]; double Rated_kVA[kVA]; complex V_Out[V]; complex I_Out[A]; complex VA_Out[VA]; complex V_In[V]; complex I_In[I]; complex V_Internal[V]; complex I_Internal[A]; complex I_Prev[A]; double power_transfered; set {A,B,C,N,S} phases; bool use_internal_battery_model; New in 2.3! enumeration {UNKNOWN, LI_ION, LEAD_ACID} battery_type; New in 2.3! double nominal_voltage[V]; New in 2.3! double rated_power[W]; New in 2.3! double battery_capacity[Wh]; New in 2.3! double round_trip_efficiency[pu]; New in 2.3! double state_of_charge[pu]; New in 2.3! double battery_load[W]; New in 2.3! double reserve_state_of_charge[pu]; New in 2.3! }
Remarks
Properties
| Property Name | Type | Unit | Description |
|---|---|---|---|
| use_internal_battery_model | bool | none | Boolean flag to use internal battery model. Default is FALSE. |
| nominal_voltage | double | V | Battery's nominal voltage |
| rated_power | double | W | Maximum rated power of battery. Can be set in inverter in rated_battery_power. |
| battery_capacity | double | Wh | Maximum energy capacity of battery |
| round_trip_efficiency | double | pu | Round-trip efficiency of battery |
| state_of_charge | double | pu | Battery's current state of charge (SOC) |
| battery_load | double | W | Battery's current load. This is the value of power_in from the parent inverter. |
| reserve_state_of_charge | double | pu | The state of charge which the battery may not go below |