Battery

Name Type Variability Description/Comments
meter TI input time meter for system electricity production
useUsrChg choice:NOYES Start of run
  • YES: user specifies charge request;
  • NO (default): calculate charge request via
  • default strategy
controlAlg BATCTRLALGVC Start of hour
  • control algorithm choice
  • _DEFAULT: per bt_chgReq
  • _TDVPEAKSAVE: strive to reduce demand during peak TDV hours
maxCap FLOAT_GEZ Start of run maximum (usable) battery capacity in kWh
initSOE number Start of run initial state of energy (0 <= SOE <= 1)
initCycles FLOAT_GEZ Start of run initial number of cycles on battery (>= 0)
chgEff FRAC_GZ Start of hour battery efficiency while charging
dschgEff FRAC_GZ Start of hour battery efficiency while discharging (Fraction)
maxChgPwr FLOAT_GEZ Start of hour maximum allowable charging power (kW)
maxDschgPwr FLOAT_GEZ Start of hour maximum discharge power (kW)
chgReq number End of hour battery charge request (kW) +=charge;-=discharge
soeBegIvl number Start of hour battery SOE at beginning of interval
loadSeen number End of hour
  • the adjusted load seen by the battery for current hour (kW)
  • = net power from bt_meter (including PV)
  • 0 if bt_meter not specified
soe number Post-calc phase of hour
  • battery state of energy (SOE) (0 <= SOE <= 1)
  • represents the end of interval SOE.
soelh number Start of hour battery state of energy (SOE) at end of prior hour
cycles FLOAT_GEZ Post-calc phase of hour accumulated battery cycles
cycleslh FLOAT_GEZ Start of hour accumulated battery cycles, end of prior hour
energy FLOAT_GEZ Post-calc phase of hour current amount of energy in battery (kWh)
energylh FLOAT_GEZ Start of hour
  • amount of energy in battery (kWh)
  • at end of prior hour