RSYS

Name Type Variability Description/Comments
type RSYSTY input time system type (ACFURN, ACRES, ASHP, AC, FURN, RES)
desc CULSTR input time
  • optional description string (e.g. model #)
  • included in perf map,
generatePerfMap choice:NOYES input time
  • if YES, generate performance map (development aid)
  • writes to file .csv
areaServed DBL Start of run total zone floor area served by this RSYS, ft2
zonesServed number Start of run # of zones served by this RSYS
Name Type Variability Description/Comments
elecMtri TI input time meter for system electricity use
fuelMtri TI input time meter for system fuel use
loadMtri TI input time
  • idx of [LOADMETER][loadmeter] that accumulates of primary (coil) output
  • qHtg accums heating output, Btu (> 0)
  • qClg accums cooling output, Btu (< 0)
htgLoadMtri TI input time idx of LOADMETER that accumulates only primary (coil) heating output
clgLoadMtri TI input time idx of LOADMETER that accumulates only primary (coil) cooling output
srcSideLoadMtri TI input time
  • idx of [LOADMETER][loadmeter] that accumulation of source-side heat transfer
  • aka heat of rejection or outdoor coil heat transfer
  • qHtg accums heat to [RSYS][rsys] from env during heating operation, Btu (> 0)
  • qClg accums heat from [RSYS][rsys] to env during cooling opersion, Btu (< 0)
  • Meaningful for compression rs_types.
htgSrcSideLoadMtri TI input time idx of LOADMETER for accumulation of source-side heating
clgSrcSideLoadMtri TI input time idx of LOADMETER for accumulation of source-side cooling
  • parasitic consumption: accum'd to Par end use in
  • appropriate meter; no thermal effect
Name Type Variability Description/Comments
parElec number Start of hour electrical parasitic power, W
parFuel number Start of hour fuel parasitic consumption, Btuh
  • nominal capacities, provide type-independent probe source for capacities.
  • Reporting-only -- not used in calculations
  • daily variability because default value changes during autosizing
Name Type Variability Description/Comments
capNomH number Start of day nominal heating capacity, Btuh. Default=rs_capH or rs_cap47
capNomC number Start of day nominal cooling capacity, Btuh. Default=rs_cap95
Name Type Variability Description/Comments
fan RSYS fan characteristics
FAN
Name Type Variability Description/Comments
fan.fanTy choice:FANTY Start of run
  • fan position choice, according to application as follows; constant.
  • air handler supply: DRAWTHRU (default) or BLOWTHRU
  • ah return/relief: NONE (default), RETURN, or RELIEF
  • terminal: NONE (default), SERIES, or PARALLEL
  • zone exhaust fan: NONE or EXHAUST (no types, just whether exists)
  • AirNet ([IZXFER][izxfer]): ditto
fan.vfDs AFLOW_GZ End of subhour design volumetric flow (cfm actual air). constant, RQD except as noted. *s cuz varies when autoSizing.
fan.vfDs_As AFLOW Start of run autoSized ditto for ah sfan and rfan for naming consistency. 6-95.
fan.vfDs_AsNov AFLOW Start of run
  • raw autoSized ditto b4 overSize added, for report/probes. 7-95.
  • cnausz.cpp code ASSUMES x, x_As, x_AsNov together for access thru one ptr. cuprobe.cpp's name search also requires together.
fan.vfMxF number Start of run
  • factor by which fan flow will exceed vfDs (at reduced pressure). default 1.3. constant.
  • Error if < 1.0; typically <= 1.5.
Name Type Variability Description/Comments
fan.press PRESAIR_GEZ Start of run
  • system design pressure, "H2O (inches of water), constant, used in defaulting power / efficiency.
  • default: supply 3, r/r .75, tu .3, zx ???.
  • 0 allowed 5-1-92 to eliminate fan heat for test/calibration purposes.
only one of eff and shaftPwr may be given:
Name Type Variability Description/Comments
fan.eff FRAC_GZ Start of run
  • fan (hydraulic) efficiency at vfDs and press (any temp), constant,
  • default from power if given, else .65. (1-eff) of fan shaft power is converted to heat in airstream.
fan.shaftPwr BHP_GZ Start of run
  • fan shaft power at vfDs and press (any temp). constant. default: from eff
  • Btuh internally, entered in BHP (user name 'shaftBhp') (cvpak converts).
  • ^^^^make user name 'shaftBhp'. field type name??
fan.elecPwr FLOAT_GZ Start of run
  • motor input power, W/cfm (based on vfDs); shaftPwr and elecPwr cannot both be
  • input
Name Type Variability Description/Comments
fan.motTy choice:MOTTY Start of run
  • motor type (C_MOTTYCH_PSC or C_MOTTYCH_BPM)
  • [RSYS][rsys] only minimal use 4-12, could effect defaults
Name Type Variability Description/Comments
fan.motEff FRAC_GZ Start of run motor/drive efficiency, constant, default .9.
Name Type Variability Description/Comments
fan.motPos choice:MOTPOS Start of run
  • motor/drive position: choice of INFLO (default), INRETURN, EXTERNAL. constant.
  • INRETURN is for supply fans only and will be deferred/omitted if difficult
  • chip per taylor 3-4-92).
Name Type Variability Description/Comments
fan.curvePy fan part-load energy consumption curve cubic polynomial coefficients with x0
PYCUBIC2
Name Type Variability Description/Comments
fan.curvePy.k[index] number Array [6] Start of run FLOAT k[6]. [0..3] are coeff, [4] is minimum x, [5] is terminator needed by cul.cpp.
Name Type Variability Description/Comments
fan.mtri TI Start of run subscript of meter (MTR) to which energy consumption is charged
fan.endUse choice:ENDUSE Start of run
  • end use to which energy consumption is charged
  • not used for all fans (many implicitly default to "fan")
Name Type Variability Description/Comments
fan.ausz BOO Start of run
  • non-0 if fan being autoSized (AH sfan, rfan): input contained [AUTOSIZE][autosize] _fanVfDs. 7-1-95.
  • see also AH::fanAs, asRfan, asFlow. 7-1-95. */
  • FAN setup time members, set by cnfan.cpp:FAN::setup. May be resetup during autoSize run.
  • also cMx may be init by setup, to be non-0.
Name Type Variability Description/Comments
fan.outPower number Start of subhour
  • motor output power (work done by fan), member 7-95 for one setup check in cncult5.cpp
  • inPower = shaftPwr/motEff is computed as needed.
fan.airPower number Start of subhour
  • fan heat to air (Btuh) at vfDs (& pressure): work done by fan, plus motor/drive inefficiency if in flow.
  • Note work done by fan is modelled as HEAT ADDED TO AIR AT FAN per Chip/Niles (3-92, undocumented)
  • heat to air around motor (in return air etc) at design flow is: (inPower - airPower). this is 0 if motor in air flow.
FAN runtime members, set by cnah.cpp:FAN::pute( cFlow, temp)
Name Type Variability Description/Comments
fan.cMx CFLOW End of subhour max heat cap flow (Btuh/F) at curr air temp & run press & ref w: .vfMx * air vsh * 60 (min/hr)
fan.c CFLOW End of subhour current average flow in heat cap units (Btuh/F): input saved for probing by last call to FAN::pute()
fan.t TEMP End of subhour current air temp, input saved ditto, used in converting BtuF/F to cfm
fan.frOn number End of subhour
  • fraction of time fan is on, saved input
  • made local to pute()to save members 10-92:
  • *s *e FRAC relFlow // fraction of design flow
  • *s *e FRAC relLoad // fraction of full load per part load curve for fan type (1.0 if over design flow: assume pressure drops)
fan.p number End of subhour (motor) power consumption for subhour -- inPower * relLoad. *subhrDur for meter.
fan.q number End of subhour heat (power) to air this subhour: airPower * relLoad. Member needed in addition to c and dT??
fan.dT TEMPDIFF End of subhour temp difference due to fan: q/c
fan.qAround number End of subhour heat to air around motor, if not in air flow, for use re supply fan motor in return air
adjForFanHt choice:NOYES Start of run
  • YES: fanHtRtd derived from rs_fan.motTy
  • and removed from capacity and input values
  • NO: no rated fan heat adjustments
Name Type Variability Description/Comments
asRet
  • return duct entering air state (at grilles)
  • (flow-weighted average of all zones)
AIRSTATE
Name Type Variability Description/Comments
asRet.tdb DBL End of subhour air dry-bulb temp, F
asRet.w DBL End of subhour air humidity ratio, lb moisture/lb dry air
asIn
  • entering air state (after return ducts)
  • valid for all modes
AIRSTATE
Name Type Variability Description/Comments
asIn.tdb DBL End of subhour air dry-bulb temp, F
asIn.w DBL End of subhour air humidity ratio, lb moisture/lb dry air
twbIn DBL End of subhour entering air wet bulb (after return ducts), F
asOut
  • leaving air state at plenum
  • NOT including any aux heat
  • NOT including any DSE or supply duct losses
AIRSTATE
Name Type Variability Description/Comments
asOut.tdb DBL End of subhour air dry-bulb temp, F
asOut.w DBL End of subhour air humidity ratio, lb moisture/lb dry air
asOutAux
  • aux heat leaving air state at plenum for ASHP heating (else 0)
  • includes fan heat
  • may include primary heat per rs_ctrlAuxH
  • NOT including any DSE or supply duct losses
AIRSTATE
Name Type Variability Description/Comments
asOutAux.tdb DBL End of subhour air dry-bulb temp, F
asOutAux.w DBL End of subhour air humidity ratio, lb moisture/lb dry air

supply air state (at registers)

Name Type Variability Description/Comments
asSup ... at full capacity under current conditions
AIRSTATE
Name Type Variability Description/Comments
asSup.tdb DBL End of subhour air dry-bulb temp, F
asSup.w DBL End of subhour air humidity ratio, lb moisture/lb dry air
asSupAux ... at full cap + auxiliary (ASHP only, else unused)
AIRSTATE
Name Type Variability Description/Comments
asSupAux.tdb DBL End of subhour air dry-bulb temp, F
asSupAux.w DBL End of subhour air humidity ratio, lb moisture/lb dry air
tSupLs number Start of subhour
  • ... supply dry-bulb at last step, F
  • used as e.g. 1st iteration guess in ASHP aux heat calc
  • autosizing
  • TODO: clarify re fan heat?
Name Type Variability Description/Comments
isAuszH number Start of run
  • TRUE iff currently autosizing heating
  • = Top.tp_autoSizing && IsAusz( RSYS_CAPH)
isAuszC number Start of run ditto cooling RSYS_CAP95
tdDesH FLOAT_GZ Start of run
  • design temperature difference (rise) across [RSYS][rsys] for heating
  • autosizing, F. default 30 F for ASHP else 50 F
tdDesC FLOAT_LZ Start of run
  • design temperature difference (fall) across [RSYS][rsys] for cooling
  • autosizing, F. default -25 F
fxCap[index] number Array [2] End of subhour
  • current step excess capacity factor = amfAvailable / max( amfRequest)
  • >1 = excess capacity
  • [ 0]=primary [1]=prim+aux or aux alone (per rs_ctrlAuxH)
fxCapCDay number End of hour
  • current day excess cooling capacity factor
  • evaluated at last time step of hour
  • >1 = excess capacity
fxCapHDay number End of hour ditto heating
fxCapHTarg FLOAT_GZ Start of run
  • target excess capacity factor for heating autosize
  • default = 1.4 (40% oversize)
fxCapHAsF number Start of run
  • working excess capacity factor for heating autosize
  • ensures sufficient capacity to meet load
fxCapCTarg FLOAT_GZ Start of run
  • target excess capacity factor for cooling autosize
  • default = 1.2 (20% oversize)
fxCapCAsF number Start of run
  • working excess capacity factor for cooling autosize
  • ensures sufficient capacity to meet load
fxCapAuxHTarg FLOAT_GZ Start of phase
  • target excess capacity factor for auxH autosize
  • default = 1.0
auszH autoSizing working data members re heating
AUSZ
---setup time members
Name Type Variability Description/Comments
auszH.az_active BOO Start of run TRUE iff autoSizing this member
  • ---runtime
  • set at initialization
Name Type Variability Description/Comments
auszH.az_a number End of subhour
  • 1a size (load) -- max of warmup-converged design days
  • pass 1 part b and pass 2: enlarge size if necess, real models.
auszH.az_b number End of subhour
  • 1b rated size plus increases during simulation incl pass 2 -- max of design days
  • for pass 2 (increase size if necess, measure load, reduce oversize sizes) and for main sim load reports
auszH.ldPk number End of subhour largest load this design day iteration or in main sim
auszH.ldPkAs number End of day autoSize peak load: max of warmup-converged design days
auszH.ldPkAs1 number End of day
  • autoSize pass 1 peak load, re reporting overloads of devices that only
  • exceed limit on pass 1, eg supply fan when sizing terminals, 7-6-95.
auszH.plrPk number End of subhour largest plr this design day iteration or in main sim
auszH.plrPkAs number End of day autoSize peak plr: max of warmup-converged design days
auszH.xPk number End of subhour rated size (*px) when plrPk set
auszH.xPkAs number End of day rated size (xPk) when plrPkAs set - use when reducing oversize in case x has changed. 6-97.
auszH.az_notDone BOO End of day
  • re convergence: nz says this AUSZ requires additional iterations
  • set to 0 at beg of each iteration; incrd anywhere is calcs if not converged
  • see also Top.tp_auszNotDone = overall notdone flag
auszC ditto cooling
AUSZ
---setup time members
Name Type Variability Description/Comments
auszC.az_active BOO Start of run TRUE iff autoSizing this member
  • ---runtime
  • set at initialization
Name Type Variability Description/Comments
auszC.az_a number End of subhour
  • 1a size (load) -- max of warmup-converged design days
  • pass 1 part b and pass 2: enlarge size if necess, real models.
auszC.az_b number End of subhour
  • 1b rated size plus increases during simulation incl pass 2 -- max of design days
  • for pass 2 (increase size if necess, measure load, reduce oversize sizes) and for main sim load reports
auszC.ldPk number End of subhour largest load this design day iteration or in main sim
auszC.ldPkAs number End of day autoSize peak load: max of warmup-converged design days
auszC.ldPkAs1 number End of day
  • autoSize pass 1 peak load, re reporting overloads of devices that only
  • exceed limit on pass 1, eg supply fan when sizing terminals, 7-6-95.
auszC.plrPk number End of subhour largest plr this design day iteration or in main sim
auszC.plrPkAs number End of day autoSize peak plr: max of warmup-converged design days
auszC.xPk number End of subhour rated size (*px) when plrPk set
auszC.xPkAs number End of day rated size (xPk) when plrPkAs set - use when reducing oversize in case x has changed. 6-97.
auszC.az_notDone BOO End of day
  • re convergence: nz says this AUSZ requires additional iterations
  • set to 0 at beg of each iteration; incrd anywhere is calcs if not converged
  • see also Top.tp_auszNotDone = overall notdone flag

ASHP heating (all values net = include rated fan heat / power)

Name Type Variability Description/Comments
HSPF FLOAT_GZ Start of run rated HSPF, Btuh/W
cap47 FLOAT_GZ End of phase full speed net heating capacity at ODB=47 F
COP47 FLOAT_GZ End of phase COP at ODB=47 F
cap35 FLOAT_GZ End of phase full speed net heating capacity at ODB=35 F
COP35 FLOAT_GZ End of phase COP at ODB=35 F
cap17 FLOAT_GZ End of phase full speed net heating capacity at ODB=17 F
COP17 FLOAT_GZ End of phase COP at ODB=17 F
cap05 FLOAT_GZ End of phase full speed net heating capacity at ODB=5 F
COP05 FLOAT_GZ End of phase COP at ODB=5 F
capRat1747 FLOAT_GZ Start of run
  • cap17 / cap47 ratio (re autosizing)
  • default based on HSPF or other correlations
capRat9547 FLOAT_GZ Start of run
  • total net cap95 (cooling) / net cap47 (heating)
  • re consistent htg/clg size iff both autosized
  • (else inconsistency ignored)
  • default=correlation per A. Conant
  • see ashpCap95FromCap47() and ashpCap47FromCap95()
Name Type Variability Description/Comments
COPMin47 FLOAT_GZ End of phase Rated net COP at ODB=47 F, min speed (for reporting only)
COPMin35 FLOAT_GZ End of phase Rated net COP at ODB=35 F, min speed (for reporting only)
COPMin17 FLOAT_GZ End of phase Rated net COP at ODB=17 F, min speed (for reporting only)
COPMin05 FLOAT_GZ End of phase Rated net COP at ODB= 5 F, min speed (for reporting only)
Name Type Variability Description/Comments
CdH number End of phase heating cycling degradation factor
Name Type Variability Description/Comments
inp47 FLOAT_GZ End of phase input power at ODB=47 F, Btuh (w/ rated fan power)
inp35 FLOAT_GZ End of phase input power at ODB=35 F, Btuh (w/ rated fan power)
inp17 FLOAT_GZ End of phase input power at ODB=17 F, Btuh (w/ rated fan power)

ASHP constants [ 0]=non-defrost, [1]=defrost (used when 17 < T < 45)

Name Type Variability Description/Comments
ASHPCapF[index] number Array [2] Start of run capacity slope: cap(T) = cap17 + CapF*(T - 17)
ASHPInpF[index] number Array [2] Start of run input slope: inp(T) = inp17 + InpF*(T - 17)
Name Type Variability Description/Comments
perfMapHtgi TI Start of run heating performance map idx
perfMapClgi TI Start of run heating performance map idx
Name Type Variability Description/Comments
typeAuxH AUXHEATTY Start of run type of auxiliary heat (C_AUXHEATTY_NONE, _RES, _FURN)
ctrlAuxH AUXHEATCTRL Start of run
  • auxiliary heating control
  • C_AUXHEATCTRL_LO Compressor locked out if any aux
  • C_AUXHEATCTRL_CYCLE Compressor runs continuously, aux cycles
  • C_AUXHEATCTRL_ALT Compressor/aux alternate
capAuxH FLOAT_GEZ End of phase
  • auxiliary heating capacity (NOT including fan heat), Btuh
  • *always* 0 if !rs_IsHP()
capAuxHInp number End of phase
  • rs_capAuxH as input (may be [AUTOSIZE][autosize])
  • allows use of estimated rs_capAuxH during ASHP autosize
AFUEAuxH FLOAT_GZ Start of phase auxiliary furnace heating AFUE (assumed constant), default 0.9
effAuxH FLOAT_GZ Start of phase aux heat efficiency (= rs_AFUEAuxH or 1)
underSizedAuxCount number End of run
  • # of subhours having aux heat capacity < compressor capacity
  • iff rs_ctrlAuxH != C_AUXHEATCTRL_CYCLE and rs_capAuxH > 0
ASHPLockOutT number Start of hour
  • air source heat pump compressor lockout temp, F
  • compressor capacity assumed 0 if outdoor tdb < tLockOut
  • default is -999 (no lockout)
defrostModel choice:RSYSDEFROSTMODEL Start of run
  • defrost model
  • NONE: defrost ignored (no capacity reduction, no aux heat)
  • REVCYCLE: no additional aux heat (just capacity reduced per cap35)
  • REVCYCLEAUX: aux heat used to compensate for capacity reduction due to
  • reverse (cooling) operation

non-ASHP heating

Name Type Variability Description/Comments
AFUE FRAC_GZ Start of phase heating system rated AFUE, 0 < AFUE <= 1
Name Type Variability Description/Comments
capH FLOAT_GEZ End of phase rated net heating output (including fan), Btuh
capH_As FLOAT_GEZ End of phase autoSized capH (including fan), Btuh
capH_AsNov FLOAT_GEZ End of phase
  • raw autoSized capH w/o oversizing (including fan), Btuh
  • autoSize code ASSUMES x, x_As, x_AsNov together for access thru one ptr. cuprobe.cpp's name search also requires together.

*r FLOAT rs_fanPwrRtdH // fan power include in ASHP rated cap/COP/HSPF, W/cfm

Name Type Variability Description/Comments
fanSFPRtd[index] FLOAT_GEZ Array [2] Start of run
  • rated specific fan power, W/cfm (assumed included in rated capacities)
  • [ 0] = heating [ 1] = cooling
fanHRtdH number End of phase
  • fan heat included in ASHP rated cap/COP/HSPF, Btuh
  • (generally estimated from rs_fanHRtdC)
fanSFPH FLOAT_GEZ Start of run operating heating specific fan power, W/cfm
fanHeatH number End of phase
  • operating heating fan electrical power at rated air flow, Btuh
  • used re both electricity use and air heat gain
amfH number End of phase heating full speed dry air mass flow rate, lbm/hr
effHt number End of subhour
  • current step gross heating efficiency at current speed, dimless
  • includes rs_fEffH modification if any
  • 0 = ASHP compressor is unavailable (due to lockout, )
capHtFS number End of subhour
  • current step full speed primary heating capacity, Btuh
  • if known; used only for CHDHW
capHt number End of subhour
  • current step current speed net primary heating capacity, Btuh
  • includes fan heat and strip/furn defrost makeup heat
  • = fan heat only if compressor unavailable
inpHt number End of subhour current step current speed compressor input power, Btuh
capDfHt number End of subhour
  • current step defrost heating capacity, Btuh
  • = typically resistance heat activated to prevent cold supply air
  • 0 if not ASHP or no defrost active
COPHtAdj number End of subhour current step adjusted heating compressor COP (reflecting all adjustments)
capRatCH FLOAT_GZ Start of phase
  • total net capC (aka rs_cap95) (cooling) / net capH (heating)
  • re consistent WSHP htg/clg size iff both autosized
  • (else inconsistency ignored)
  • default based on eyeballed manufacturers' data
  • see WshpConsistentCaps()
CHDHWSYSi TI input time
  • index of [DHWSYS][dhwsys] supplying hot water for combined heat/DWH CHDHW coil
  • nz iff rs_type is CHDHW or ACCHDHW
tCoilEW number End of subhour CHDHW heating coil entering water temp, F

compression cooling

Name Type Variability Description/Comments
cap95 FLOAT_GEZ End of phase rated full speed net total cooling capacity at 95 F (>= 0), Btuh
cap95_As FLOAT_GEZ End of phase autosize cap95 net total cooling cap, Btuh
cap95_AsNov FLOAT_GEZ End of phase
  • raw autoSized cap95 net total cooling cap w/o oversizing, Btuh
  • autoSize code ASSUMES x, x_As, x_AsNov together for access thru one ptr. cuprobe.cpp's name search also requires together.
Name Type Variability Description/Comments
COP95 FLOAT_GZ End of phase
  • rated net COP at 95 F (= rs_EER95 / 3.412)
  • rs_COP95 and rs_EER95 are consistent at runtime
EER95 FLOAT_GZ End of phase
  • rated net EER at 95 F, Btuh/W (=rs_COP95 * 3.412)
  • rs_COP95 and rs_EER95 are consistent at runtime
SEER FLOAT_GZ End of phase cooling AHRI rated SEER, Btuh/W
Name Type Variability Description/Comments
cap115 FLOAT_GEZ End of phase output: total full speed net cooling capacity at 115 F (>= 0), Btuh
COP115 FLOAT_GZ End of phase output: full speed cooling COP at 115F
cap82 FLOAT_GEZ End of phase output: total full speed net cooling capacity at 82 F (>= 0), Btuh
COP82 FLOAT_GZ End of phase output: full speed cooling COP at 82F
Name Type Variability Description/Comments
vfPerTon FLOAT_GZ Start of phase
  • operating air flow ratio, cfm/ton (= cfm/(rs_cap95/12000))
  • used for cooling and ASHPPM heating
fanSFPC FLOAT_GEZ Start of phase cooling fan full speed operating specific fan power, W/cfm (default 0.365)
fanHeatC number End of phase
  • cooling fan full speed operating electrical power, Btuh
  • used re both electricity use and air heat gain
fanDeltaTC number End of phase
  • cooling fan heat temperature rise, F
  • constant even if capacity is altered during autosize
  • Why: air flow is function of rated capacity
amfC number End of phase cooling dry air mass flow rate, lbm/hr
CdC number End of phase cooling cycling degradation factor
rhInTest number End of hour specified entering air relnum (for testing), 0-1
rhIn number End of subhour
  • plenum entering air relnum, 0-1
  • ( = rs_rhInTest if given, else from zone + return duct)
twbCoilIn number End of subhour coil entering wet bulb, F (after blow-thru fan if any)
tdbCoilIn number End of subhour coil entering dry bulb, F (ditto)
Name Type Variability Description/Comments
SHR FLOAT_GZ End of subhour
  • cooling sensible heat ratio (sensible capacity / total capacity)
  • from coil model for compression types
  • from rs_SHRtarget for fancoil
  • may be modified re humidity constraints
SHRtarget FLOAT_GZ Start of subhour
  • inputable nominal sensible heat ratio (for fancoil)
  • default 0.7
Name Type Variability Description/Comments
fChg number Start of phase
  • refrigerant charge factor (default 1, 0.9 or 0.96 for CA compliance)
  • multiplies cooling capacity (no effect on heating)
  • rs_fanSFPRtd[] rated cooling specific fan power, W/cfm see above
fanHRtdC number End of phase fan heat included in rated rs_cap95, Btuh
capnfX number End of phase constant for rs_capXxxCt calc
SEERnfX number End of phase constant for rs_SEERnf calc
EERnfX number End of phase constant for rs_EERnfCalc
Name Type Variability Description/Comments
fCondCap number End of subhour conditions factor, capacity
fCondInp number End of subhour conditions factor, input power
fCondSEER number End of subhour conditions factor, SEER
fCondEER number End of subhour conditions factor, EER

values for current step (adjusted for outdoor and indoor temps)

Name Type Variability Description/Comments
SEERnf number End of subhour SEER w/o fan power
EERnf number End of subhour EER w/o fan power
EERt number End of subhour
  • compressor EER, Btuh/W (temperature weighted mix of
  • rs_SEERnf and rs_EERnf)
capTotCt number End of subhour coil total cooling capacity at current conditions and speed, Btuh (<0)
capLatCt number End of subhour coil latent cooling capacity at current conditions and speed, Btuh (<0)
capSenCt number End of subhour coil sensible cooling capacity at current conditions and speed, Btuh (<0)
inpCt number End of subhour
  • compressor nominal electrical input power at current conditions and speed, Btuh
  • NOT adjusted by rs_fEffC
effCt number End of subhour
  • temp adjusted compressor efficiency (= CEt in ACM)
  • abs( rs_capTotCt)*rs_fEffC / rs_inpCt

Central outside air vent (aka OAV)

Name Type Variability Description/Comments
OAVType choice:RSYSOAVTY input time type: NONE, FIXEDFLOW (aka SmartVent), VARFLOW (aka SmartBreeze)
OAVReliefZi TI input time OAV relief zone index
OAVTdbInlet number Start of subhour
  • OAV inlet dry-bulb temp, F
  • default = from project weather data source (generally weather file)
  • note: default varies subhourly but input expression is hourly
OAVTdiff FLOAT_GZ Start of hour OAV temperature differential, F
OAVAvfDs FLOAT_GEZ input time OAV design air flow rate, cfm actual air
OAVFanSFP FLOAT_GEZ input time OAV design fan specific fan power (based on rs_OAVVfDs), W/cfm
OAVAvfMinF number input time OAV minimum volume flow (rs_avfOAV always >= rs_OAVAvfMinF *rs_OAVAvfDs)
Name Type Variability Description/Comments
avfOAV number Start of day OAV current air volume flow, cfm (set at beg of each day)
fanHeatOAV number Start of day ditto fan power, Btuh
amfOAV number Start of day ditto air mass flow, lbm/hr
  • Distribution losses
  • Distribution system efficiency (DSE): simplified distribution loss model
  • discards 1-DSE of heat added by system
Name Type Variability Description/Comments
DSEH FRAC_GZ Start of hour heating distribution system efficiency (DSE); <0: use DUCTSEG else apply DSEH
DSEC FRAC_GZ Start of hour cooling distribution system efficiency (DSE); <0: use DUCTSEG else apply DSEC
Name Type Variability Description/Comments
fEffH FLOAT_GZ Start of subhour heating efficiency adjustment factor (applied to substep efficency), default=1
fEffAuxHBackup FLOAT_GZ Start of subhour auxiliary heating backup mode efficiency adjustment factor (applied to substep efficency), default=1
fEffAuxHDefrost FLOAT_GZ Start of subhour auxiliary heating defrost mode efficiency adjustment factor (applied to substep efficency), default=1
fEffC FLOAT_GZ Start of subhour cooling efficiency adjustment factor (applied to substep efficency), default=1
Name Type Variability Description/Comments
tdbOut number Start of subhour
  • outdoor dry-bulb temp at condensor or other outdoor components, F
  • default = from project weather data source (generally weather file)
  • note: default varies subhourly but input expression is hourly
modeCtrl RSYSMODECTRL Start of hour mode control (off, heat, cool, auto }
mode USI End of subhour mode (rsmOFF, rsmHEAT, rsmCOOL, rsmOAV )
modeLs USI Start of subhour last step mode (rsmOFF, rsmHEAT, rsmCOOL, rsmOAV )
modeLastActive USI Start of subhour
  • last active mode (rsmOFF, rsmHEAT, rsmCOOL, rsmOAV )
  • (allows guess re e.g. heating vs cooling season)
amfReq[index] DBL Array [2] End of subhour
  • total AMF (at system) requested by zones, lbm/hr
  • [ 0] = primary source (compressor or burner)
  • [ 1] = prim+aux or aux-only (per rs_auxControl)
  • ASHP heating only else 0
znLoad[index] number Array [2] End of subhour
  • sensible load to hold zone(s) at setpoint, Btuh
  • [ 0] = primary (compressor or burner)
  • [ 1] = prim+aux or aux-only (per rs_auxControl)
  • calculated results
capSenNetFS number End of subhour net sensible capacity at full speed, Btuh
Name Type Variability Description/Comments
amf DBL End of subhour
  • current step dry air mass flow rate, lbm/hr
  • = flow at blower / coil / furnace HX etc.
  • set per rsMode from rs_amfH, rs_amfC, or OAV algorithm
  • depends on rs_speedF for VC and CHDHW; does not reflect cycling
fanPwr number End of subhour
  • current step fan power, Btuh
  • used for both air stream heat addition and electricity consumption
PLF number End of subhour
  • efficiency degradation due to cycling
  • PLF = PartLoadEfficiency / FullLoadEfficency
PLR number End of subhour current step part load ratio = sensible load / full-speed sensible capacity
runF number End of subhour primary (e.g. compressor) run fraction
speedF number End of subhour
  • primary (compressor) current speed fraction
  • = current net cap / full speed net cap
  • fixed speed: 1; var spd: <= 1 per load
speedFMin number End of subhour
  • primary (compressor) current minimum speed fraction
  • fixed speed: 1; var spd: < 1 per min current min cap
runFAux number End of subhour auxiliary run fraction
outSen DBL End of subhour
  • average primary (compressor, burner, coil, ) sensible heat delivery rate for last subhr, Btuh
  • (includes runF/speedF, does not include fan, defrost, or aux heat)
  • used for both heating and cooling
outLat DBL End of subhour average latent heat delivery rate, Btuh
outFan DBL End of subhour average fan heat added to air stream, Btuh
outDefrost DBL End of subhour
  • averate defrost heat, Btuh
  • = typically resistance heat added to prevent cold supply air
  • 0 if not ASHP or if defrost not active
outAux DBL End of subhour average auxiliary heat added to air stream, Btuh (for ASHP)
outSenTot DBL End of subhour
  • average total sensible heat delivery rate for last subhr, Btuh
  • = rs_outSen + rs_outFan + rs_outDefrost + rs_outAux
Name Type Variability Description/Comments
calcCount[index] number Array [2] End of run
  • # calls to rs_SupplyAirState, re optimizing rs_FindRequiredSpeedF()
  • [ 0] = heating, [1] = cooling
Name Type Variability Description/Comments
inPrimary DBL End of subhour primary input, Btuh (compressor, burner, )
inFan DBL End of subhour fan electricity input, Btuh (not kWh)
inDefrost DBL End of subhour defrost heating input, Btuh (ASHP only)
inAux DBL End of subhour auxiliary heating input, Btuh