DHWSolarSys

Name Type Variability Description/Comments
elecMtri TI input time meter for pump and parasitic electricity use
endUse choice:ENDUSE input time end use of pump energy. defaults to "DHW"
parElec FLOAT_GEZ Start of hour parasitic electricity use, W
Name Type Variability Description/Comments
wsCount number Start of run
  • # of [DHWSYSs][dhwsys] supplied by this [DHWSOLARSYS][dhwsolarsys]
  • (re detection of orphan [DHWSOLARSYSs][dhwsolarsys])
Name Type Variability Description/Comments
scAreaTot number Start of run total of child DHWSOLARCOLLECTORS, ft2
scCount number Start of run
  • # of child DHWSOLARCOLLECTORS (not necessarily # of panels)
  • = SUM( sc_mult)

Tank

Name Type Variability Description/Comments
tank interface to Ecotope HPWH model (used as tank)
HPWHLINK
Name Type Variability Description/Comments
tank.HSCount number End of subhour # of HPWH heatsources in use for current config
tank.tEx number End of subhour tank surround temp, F
tank.tASHPSrc number End of subhour temp of heat pump air source, F
Name Type Variability Description/Comments
tank.nQTXNodes number End of subhour
  • # of tank 1/12s used in hw_qTX extra tank heat
  • corresponds to nodes for HPWH default 12 node setup
Name Type Variability Description/Comments
tank.fMixUse number End of subhour
  • factor for draw adjustment re HPWH setpoint > [DHWSYS][dhwsys]::ws_tUse
  • Some HPWHs (e.g. SANCO2) have fixed (high) setpoints
  • draws are reduced to balance load at ws_tUse.
tank.fMixRL number End of subhour
  • factor for loop return flow adjustment re HPWH setpoint > [DHWSYS][dhwsys]::ws_tUse
  • Some HPWHs (e.g. SANCO2) have fixed (high) setpoints
  • Loop return flow is reduced to balance load at ws_tUse.
Name Type Variability Description/Comments
tank.inElec[index] DBL Array [2] End of subhour
  • current subhr HPWH electricity use, kWh
  • [0]=primary(=compressor or non-HP resistance) + misc
  • [1]=resistance backup (iff HP) (not including hw_HPWHxBU)
tank.heatAdded[index] DBL Array [2] End of subhour
  • current subhr HPWH heat added to water, kWh
  • [0]=primary(=compressor or non-HP resistance)
  • [1]=resistance backup (iff HP) (not including hw_HPWHxBU)
tank.tOut DBL End of subhour
  • last tick HPWH outlet temp, C
  • 0 if no draw
tank.tOutCHDHW DBL End of subhour
  • last tick output temp available to CHDHW, F
  • 0 if no draw
tank.HPWHxBU number End of subhour
  • current subhr HPWH add'l backup resistance heat, Btu
  • output water heated to ws_tUse iff HPWH output temp < ws_tUse
tank.qEnv DBL End of subhour
  • current subhr heat removed by HPWH from environment, kWh
  • + = to water heater; for 1 [DHWHEATER][dhwheater] (no wh_mult)
tank.qLoss DBL End of subhour
  • current subhr HPWH standby losses, kWh. + = to surround
  • for 1 [DHWHEATER][dhwheater] (no wh_mult)
tank.qHW DBL End of subhour
  • current subhr HPWH total delivered hot water heating, kWh. always >= 0
  • for 1 [DHWHEATER][dhwheater] (no wh_mult)
  • calc'd from flows and temp diffs (unlike hw_heatAdded)
  • includes heat to [DHWLOOP][dhwloop] and CHDHW, does not include hw_HPWHxBU
tank.qTX DBL End of subhour current subhr extra heat tank heat added, kWh (not Btu)
Name Type Variability Description/Comments
tank.tankHCNominal number End of subhour
  • nominal HPWH tank heat content, kWh (at 40 C)
  • used as normalizing factor for energy balance checks
tank.tankHCBeg DBL End of subhour current step beginning tank heat content, kWh
tank.tankHCEnd DBL End of subhour current step end tank heat content, kWh
Name Type Variability Description/Comments
tank.tHWOutF DBL End of subhour current substep working total re calc of hw_tHWOut
tank.nzDrawCount number End of subhour current substep # of draws > 0
tank.tHWOut number End of subhour
  • average hot water temp, F (at water heater)
  • includes XBU: hw_tHWOut >= ws_tUse
  • calc'd at substep end only
Name Type Variability Description/Comments
tank.bWriteCSV number End of subhour write HPWH debugging CSV iff nz
Name Type Variability Description/Comments
tank.qBal DBL End of subhour current step HPWH heat balance, kWh (s/b 0)
tank.balErrCount number End of subhour annual count of energy balance errors
tank.balErrMax DBL End of subhour maximum substep energy balance error for run, kWh
tankVol FLOAT_GZ Start of run
  • tank volume, gal
  • default: 1.5 gal/ft2 collector area
tankUA FLOAT_GEZ Start of run
  • tank water-to-air UA, Btuh/F
  • default: derived from sw_tankVol and sw_tankInsulR
tankInsulR FLOAT_GZ Start of run
  • total tank insulation resistance, hr-F/Btuh
  • = built-in + exterior wrap
tankZnTi TI input time
  • Tank location zone re tank loss
  • 0 iff sw_tankTEx being used
  • heat losses go to half to zone air / half radiant
tankTEx number Start of hour
  • surrounding temperature, F for tank loss
  • when sw_tankTEx set
  • - sw_tankZnTi ignored
  • - heat loss discarded
tankTAvg number End of hour hour average tank temp, F (check figure)
tankQLoss number End of hour
  • current hour's total tank loss, Btu
  • for 1 tank (sw_mult)
tankHXEff number Start of hour tank heat exchanger effectiveness
tankTHxLimit FLOAT_GZ input time
  • tank temp limit, F; collector heat
  • discarded when sw_tankTHx > sw_tankTHxLimit
  • default = 180 F
overHeatTkCount number End of hour
  • # of ticks in this hour when collector did not run
  • due to swtankTHx > sw_tankTHxLimit
Name Type Variability Description/Comments
tickVol number End of subhour current tick draw to DHWSYSs, gal
tickVolT number End of subhour current tick (vol * inlet temp), gal-F
tickTankTOutlet number End of subhour current tick tank outlet temp
Name Type Variability Description/Comments
drawVol number End of hour current hour total draw, gal
tankQGain number End of hour current hour total gain from solar HX (all collectors), Btu
tankQGainTot DBL End of run sw_tankQGain annual total, Btu
tankTInlet number End of hour tank inlet temperature, F
tankTOutlet number End of hour current hour average tank outlet temperature, F
tankTHx number End of hour
  • nominal tank heat exchange temp, F
  • = avg of bottom several tank node temps
  • used re heat exchange from collector loop
totOut number End of hour
  • current hour total [DHWSOLARSYS][dhwsolarsys] output, Btu
  • = heat delivered to primary heater

Collector Fluid

Name Type Variability Description/Comments
scFluidSpHt FLOAT_GZ input time collector working fluid specific heat, Btu/lbm-F
scFluidDens FLOAT_GZ input time collector working fluid density, lb/ft3
scFluidVHC FLOAT_GZ Start of run
  • collector working fluid volumetric heat capacity, Btu/gal-F
  • derived from sw_scFluidSpHt and scFluidDens
scTInlet number End of hour mixed collector inlet temperature, F
scTOutlet number End of hour mixed collector outlet temperature, F

annual results

Name Type Variability Description/Comments
overHeatHrCount number End of run
  • number of hours during which collector did not
  • run (for 1 tick or more)
  • due to swtankTHx > sw_tankTHxLimit
SSFAnnual number End of run
  • annual solar savings fraction
  • derived from all [DHWSYSs][dhwsys] served