airHandler

input -- in addition to AUTOSIZE ahhcCaptRat, ahccCaptRat, sfanVfDs, rfanVfDs: these set FsAS field status bit.

Name	Type	Variability	Description/Comments
ahTsDsH	TEMP	Start of hour	heating design supply temperature, for sizing coil vs fan. defaulted hourly to ahTsMx.
ahTsDsC	TEMP	Start of hour	cooling design supply temperature, for sizing coil vs fan. defaulted hourly to ahTsMn.
fxCapH	FLOAT_GZ	Start of phase	capacity factor for autoSized heat coils (default 1.1 = 10% oversized)
fxCapC	FLOAT_GZ	Start of phase	capacity factor for autoSized cool coils (default 1.1 = 10% oversized)
fxVfFan	FLOAT_GZ	Start of phase	volume flow factor for autoSized fan(s) (default 1.1 = 10% oversized) setup
asRfan	BOO	Start of run	TRUE to autoSize return/relief fan (to same capacity as supply fan)
asFlow	BOO	Start of run	true if autoSizing supply fan and/or flow of any connected terminal: change to const supply temp model in part A. runtime
hcAs			autoSizing working data members re heat coil
AUSZ ---setup time members Name Type Variability Description/Comments hcAs.az_active BOO Start of run TRUE iff autoSizing this member ---runtime set at initialization Name Type Variability Description/Comments hcAs.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. hcAs.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 hcAs.ldPk number End of subhour largest load this design day iteration or in main sim hcAs.ldPkAs number End of day autoSize peak load: max of warmup-converged design days hcAs.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. hcAs.plrPk number End of subhour largest plr this design day iteration or in main sim hcAs.plrPkAs number End of day autoSize peak plr: max of warmup-converged design days hcAs.xPk number End of subhour rated size (*px) when plrPk set hcAs.xPkAs number End of day rated size (xPk) when plrPkAs set - use when reducing oversize in case x has changed. 6-97. hcAs.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
ccAs			.. re cool coil (total only. sens cap: see .SHRRat. sens load: see .qcs)
AUSZ ---setup time members Name Type Variability Description/Comments ccAs.az_active BOO Start of run TRUE iff autoSizing this member ---runtime set at initialization Name Type Variability Description/Comments ccAs.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. ccAs.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 ccAs.ldPk number End of subhour largest load this design day iteration or in main sim ccAs.ldPkAs number End of day autoSize peak load: max of warmup-converged design days ccAs.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. ccAs.plrPk number End of subhour largest plr this design day iteration or in main sim ccAs.plrPkAs number End of day autoSize peak plr: max of warmup-converged design days ccAs.xPk number End of subhour rated size (*px) when plrPk set ccAs.xPkAs number End of day rated size (xPk) when plrPkAs set - use when reducing oversize in case x has changed. 6-97. ccAs.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
fanAs			.. re fan(s) -- autosized rfan slaves to sfan. values saved at entry to hvacIterSubhr for conditional backtracking during autoSizing.
AUSZ ---setup time members Name Type Variability Description/Comments fanAs.az_active BOO Start of run TRUE iff autoSizing this member ---runtime set at initialization Name Type Variability Description/Comments fanAs.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. fanAs.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 fanAs.ldPk number End of subhour largest load this design day iteration or in main sim fanAs.ldPkAs number End of day autoSize peak load: max of warmup-converged design days fanAs.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. fanAs.plrPk number End of subhour largest plr this design day iteration or in main sim fanAs.plrPkAs number End of day autoSize peak plr: max of warmup-converged design days fanAs.xPk number End of subhour rated size (*px) when plrPk set fanAs.xPkAs number End of day rated size (xPk) when plrPkAs set - use when reducing oversize in case x has changed. 6-97. fanAs.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
bVfDs	AFLOW_GEZ	End of subhour	sfan.vfDs. see COIL::bCaptRat for ahhc and ahcc. results: see ahhc.captRat_As, ahcc.captRat_As, ahcc.capsRat_As, sfan.vfDs_As, rfan.vfDs_As, ditto _AsNov's. values at time of cool coil peak load in main run or des day, for loads reports and input to -PkAs mbrs below
qcPkS	number	End of subhour	sensible load @ peak total load
qcPkL	number	End of subhour	latent cool coil load ditto
qcPkH	number	End of subhour	hour 1-24 of peak total cool coil load
qcPkD	number	End of subhour	day of month 1-31 of peak load, not used for autoSizing
qcPkM	number	End of subhour	month 1-12 of peak load, or 0 for Heat design month
qcPkTDbO	TEMP	End of subhour	outdoor temp at time of peak load
qcPkWO	HUMRAT	End of subhour	outdoor hum rat at time of peak load. w's must follow t's for reports.
qcPkTen	TEMP	End of subhour	entering air temp
qcPkWen	HUMRAT	End of subhour	hum rat
qcPkTex	TEMP	End of subhour	exiting air temp (b4 remix w bypass air)
qcPkWex	HUMRAT	End of subhour	hum rat (b4 remix w bypass air) above for autoSize pass 2 cvg'd des day with largest peak cool coil load, saved for size rpts in input rec thru main run.
qcPkSAs	number	End of subhour	sensible load @ peak total load
qcPkLAs	number	End of subhour	latent cool coil load ditto
qcPkHAs	number	End of subhour	hour 1-24 of peak total cool coil load
qcPkDAs	number	End of subhour	day of month 1-31 of peak load, not used for autoSizing
qcPkMAs	number	End of subhour	month 1-12 of peak load, or 0 for Heat design month
qcPkTDbOAs	TEMP	End of subhour	outdoor temp at time of peak load
qcPkWOAs	HUMRAT	End of subhour	outdoor hum rat at time of peak load. w's must follow t's for reports.
qcPkTenAs	TEMP	End of subhour	entering air temp
qcPkWenAs	HUMRAT	End of subhour	hum rat
qcPkTexAs	TEMP	End of subhour	exiting air temp (b4 remix w bypass air)
qcPkWexAs	HUMRAT	End of subhour	hum rat (b4 remix w bypass air)

Name	Type	Variability	Description/Comments
ahTsSp	TEMP_TSCM	Start of hour	supply temperature setpoint or control method: RA, WZ, CZ, ZN, ZN2, or number, hourly, RQD if ah has economizer or coil, else disallowed. NUMBER: a number or numeric expression can express functions of time, outdoor temp, etc. RA: controlled by return air temp. raMn, raMx, tsMn, tsMx must be input. WZ/CZ: Warmest Zone/Coolest Zone: set ts to meet load of control zone requiring the lowest/highest ts with its VAV damper 90-100% open. ZN: choose WZ or CZ per whether terminal ahCtu's t'stat is calling for heat or cold, else ah off. defaults [ahFanCycles][ahfancycles] YES. intended for single zone systems, RESYS, PTAC. ZN2: choose WZ or CZ per whether terminal ahCtu's t'stat is calling for heat or cold, else fan only. intended for single zone const vol systems, PSZ. ZN, ZN2 are the ONLY methods where demand determines whether zones are being heated or cooled; in other cases, if system can heat or cool zone, supply temp must be scheduled, reset by outside temp, etc. Optional separate setpoint inputs for setback/setup operation are below.

Name	Type	Variability	Description/Comments
ahFanCycles	NOYESVC	Start of hour	YES if fan (and coil) cycles with zone thermostat; hourly; default: YES when ahTsSp==ZN (not ZN2), else NO (defaulted dynamicaly in AH::begHour). see BOO fcc for runtime testing. 6-15-92.

min and max supply temps, always allowed, RQD when ahTsSp==RA (runtime ck), or (5-95) when ahTsSP==ZN && ahFanCyles==YES.

Name	Type	Variability	Description/Comments
ahTsMn	TEMP_GZ	Start of hour	hourly, default 40.
ahTsMx	TEMP_GZ	Start of hour	hourly, default 250.

RQD when ahTsSp is RA, else ignored;

Name	Type	Variability	Description/Comments
ahTsRaMn	TEMP_GZ	Start of hour	return air temp at which tsSp is at ahTsMx. hourly.
ahTsRaMx	TEMP_GZ	Start of hour	.. ahTsMn. hourly. If return air moves outside this range, tsSp does not change further.

Name	Type	Variability	Description/Comments
ahCtu	TI	Start of run	terminal for determining whether to heat or cool under ZN, ZN2 tsu sp control. defaults to served terminal if only one, else RQD when ahTsSp is ZN or ZN2.

Name	Type	Variability	Description/Comments
ahWzCzns[index]	TI Array [16]	Start of phase	zone names monitored for warmest zone and coolest zone Ts Sp control, respectively.
ahCzCzns[index]	TI Array [16]	Start of phase	Each input may be ALL, ALL_BUT, and/or zone names, comma-separated. default ALL. internally: TI_ALL; or TI_ALLBUT + zone subsrs; or zone subscrs; max 15, 0-terminated.

• minimun oa flow is regulated to a given cfm (VOLUME) or a fraction of the current flow (FRACTION),
• in either case multiplied by a schedulable fraction (eg to shut off vent air during warmup).
• if oaMnCm is VOL: min_oa_flow = [oaMnFrac][oamnfrac] * [oaVfDsMn][oavfdsmn]
• FRAC: min_oa_flow = [oaMnFrac][oamnfrac] * [oaVfDsMn][oavfdsmn] * curr_flow / supply_fan_design_cap

Name	Type	Variability	Description/Comments
oaMnCm	choice:OAMN	Start of phase	min OA flow Control Method, choice of VOL or FRAC, default VOL, constant.

Name	Type	Variability	Description/Comments
oaMnFrac	number	Start of hour	fraction 0-1 of minimum OA to use now, hourly, default 1.0. eg to shut off oa during warmup.

Name	Type	Variability	Description/Comments
oaVfDsMn	AFLOW_GEZ	Start of run	design minimum outside air flow (cfm actual air), constant, dfl .15 * area. for FRACTION control, this is multiplied by curr_flow/supply_fan_design_cap.

Name	Type	Variability	Description/Comments
oaEcoTy	choice:ECOTY	Start of phase	choice of NONE, NONINTEGRATED, TWO_STAGE, INTEGRATED. constant. default NONE. NONE means OA flow is the minimum, above. INTEGRATED means economizer and coil do their respective things, independently. NONINTEGRATED means coil does not run when economizer is enabled (per oaLimT, oaLimE, oaMxFrac, right?) TWO_STAGE: not needed for compliance, defer implementation til I understand coils: economizer off when coil cycles on ("requires calculating % coil runtime in subhour using minimum unloading step as capacity").

• following 2 variables disallowed if economizer type is NONE
• *declare "#define oaMxFrac (1.0)" // maximum outdoor air as a fraction of current flow: hard-code to 1.0, 10-25-92.

Name	Type	Variability	Description/Comments
oaLimT	TEMP_RA	Start of hour	economizer oa temp hi limit: number -50 to 999, or RA for current return air temp, hourly, dfl RA. oa flow reduced to minimum when oa temp > oaLimT.
oaLimE	ENTH_RA	Start of hour	economizer oa enthalpy hi limit: number or RA, constant, dfl 999 (enth limit disabled).

Name	Type	Variability	Description/Comments
oaOaLeak	number	Start of phase	outside air damper leakage to mixed air, fraction of supply fan design cfm if have economizer, else fraction of [oaVfDsMn][oavfdsmn]. Const, default .05 if return fan, .10 if relief fan or no r/r fan. Puts a floor on oa flow and thus a ceiling on ra flow, to mixed air.

Name	Type	Variability	Description/Comments
oaRaLeak	number	Start of phase	return air damper leakage to mixed air, fraction supply fan design cfm, constant, default .05 if relief fan or no r/r fan, .10 if return fan. (note I took out proposed default 0 if no economizer 3-6-92 **) Puts a floor on ra flow and thus a ceiling on oa flow, to mixed air.

Name	Type	Variability	Description/Comments
oaZoneLeakF	number	Start of hour	assumed zone leakage fraction; for zone airnet ONLY retFlow = supFlow * (1. - oaZoneLeakF * po) default: 0 if return/relief fan else .5

heat recovery

Name	Type	Variability	Description/Comments
oaHx			outdoor air heat recovery HEATEXCHANGER substruct
HEATEXCHANGER Heat exchanger inputs Name Type Variability Description/Comments oaHx.VfDs AFLOW_GZ Start of run Design supply volumetric flow rate of the heat exchanger defaults to supply fan VfDs oaHx.f2 FLOAT_GZ Start of run Flow fraction for second set of inputs (default 0.75) oaHx.senEffH[index] number Array [2] Start of run Heat exchanger heating sensible effectiveness [ 0]: at design 100% flow [ 1]: at hx_F2 oaHx.latEffH[index] number Array [2] Start of run Heat exchanger heating latent effectiveness [ 0]: at design 100% flow [ 1]: at hx_F2 oaHx.senEffC[index] number Array [2] Start of run Heat exchanger cooling sensible effectiveness [ 0]: at design 100% flow [ 1]: at hx_F2 oaHx.latEffC[index] number Array [2] Start of run Heat exchanger cooling latent effectiveness [ 0]: at design 100% flow [ 1]: at hx_F2 oaHx.bypass choice:NOYES Start of run HX can be bypassed when not adventatgeous oaHx.auxPwr FLOAT_GEZ Start of subhour Auxiliary power, W oaHx.auxMtri TI Start of run Meter for auxiliary power Outputs Name Type Variability Description/Comments oaHx.supInAF Supply inlet air flow (splits to hx_hxInAF and hx_bypassAF based on hx_bypassFrac) AIRFLOW Name Type Variability Description/Comments oaHx.supInAF.tdb DBL End of subhour air dry-bulb temp, F oaHx.supInAF.w DBL End of subhour air humidity ratio, lb moisture/lb dry air Name Type Variability Description/Comments oaHx.supInAF.amf DBL End of subhour mass flow rate, lb/hr dry air *s *e DBL as_tdb // from AIRSTATE *s *e DBL as_w oaHx.hxInAF HX supply inlet air flow AIRFLOW Name Type Variability Description/Comments oaHx.hxInAF.tdb DBL End of subhour air dry-bulb temp, F oaHx.hxInAF.w DBL End of subhour air humidity ratio, lb moisture/lb dry air Name Type Variability Description/Comments oaHx.hxInAF.amf DBL End of subhour mass flow rate, lb/hr dry air *s *e DBL as_tdb // from AIRSTATE *s *e DBL as_w oaHx.hxOutAF HX supply outlet air flow AIRFLOW Name Type Variability Description/Comments oaHx.hxOutAF.tdb DBL End of subhour air dry-bulb temp, F oaHx.hxOutAF.w DBL End of subhour air humidity ratio, lb moisture/lb dry air Name Type Variability Description/Comments oaHx.hxOutAF.amf DBL End of subhour mass flow rate, lb/hr dry air *s *e DBL as_tdb // from AIRSTATE *s *e DBL as_w oaHx.bypassAF Bypass air flow AIRFLOW Name Type Variability Description/Comments oaHx.bypassAF.tdb DBL End of subhour air dry-bulb temp, F oaHx.bypassAF.w DBL End of subhour air humidity ratio, lb moisture/lb dry air Name Type Variability Description/Comments oaHx.bypassAF.amf DBL End of subhour mass flow rate, lb/hr dry air *s *e DBL as_tdb // from AIRSTATE *s *e DBL as_w oaHx.exhInAF Exhaust inlet air flow AIRFLOW Name Type Variability Description/Comments oaHx.exhInAF.tdb DBL End of subhour air dry-bulb temp, F oaHx.exhInAF.w DBL End of subhour air humidity ratio, lb moisture/lb dry air Name Type Variability Description/Comments oaHx.exhInAF.amf DBL End of subhour mass flow rate, lb/hr dry air *s *e DBL as_tdb // from AIRSTATE *s *e DBL as_w oaHx.supOutAF Supply outlet air flow (mixes to hx_hxInAF and hx_bypassAF based on hx_bypassFrac) *s *e *nest AIRFLOW hx_exhOutAF // Exhaust outlet air flow, not yet needed AIRFLOW Name Type Variability Description/Comments oaHx.supOutAF.tdb DBL End of subhour air dry-bulb temp, F oaHx.supOutAF.w DBL End of subhour air humidity ratio, lb moisture/lb dry air Name Type Variability Description/Comments oaHx.supOutAF.amf DBL End of subhour mass flow rate, lb/hr dry air *s *e DBL as_tdb // from AIRSTATE *s *e DBL as_w Name Type Variability Description/Comments oaHx.bypassFrac number End of subhour Fraction of supply inlet air bypassing heat exchanger oaHx.tSet DBL End of subhour Setpoint temperature for air exiting heat exchanger oaHx.sensEff number End of subhour Sensible efficacy oaHx.latEff number End of subhour Latent efficacy

Name	Type	Variability	Description/Comments
ahSOLeak	number	Start of phase	Supply duct leakage to outdoors, 0-.1 of sfanVfDs, default .01. use 0 if duct indoors.
ahROLeak	number	Start of phase	Return duct leakage from outdoors, 0-.1, of sfanVfDs, default .01, use 0 if duct indoors.
ahSOLoss	number	Start of phase	Supply duct loss/gain to outdoors, 0-.1, default .02? (Taylor 0.5F), use 0 if duct indoors.
ahROLoss	number	Start of phase	Return duct heat loss/gain to outdoors, 0-.1, default .02? (ditto), use 0 if duct indoors.

Name	Type	Variability	Description/Comments
ahSch	AHSCHVC	Start of hour	supply fan and thus air handler schedule: choice of ON or OFF, hourly variable; default ON. ON: fan runs at varying volume (except under ahFanCyles, when fan cycles on and off at full flow). OFF: Taylor setback/setup control in effect, if specified, when/if implemented. WARMUP, OPTIMUM_START: we may add these here later when implemented. see also heat and cool coil schedules.

Name	Type	Variability	Description/Comments
sfan			supply fan FAN substruct (as declared above) following supply fan inputs are stored in FAN subrecord sfan: FANTYCH [sfanType][sfantype] // supply fan type/position: choice of DRAWTHRU (default) or BLOWTHRU. constant. AFLOW_GZ [sfanVfDs][sfanvfds] // design volume flow (cfm actual air), constant, RQD. FLOAT [sfanVfMxF][sfanvfmxf] // factor by which fan will exceed vfDs (at reduced pressure). default 1.3. constant. PRESAIR_GZ [sfanPress][sfanpress] // design pressure, "H2O, constant, default 3. //At most one of the next 2 may be given: FRAC sfanFanEff // Fan efficiency at vfDs and press, constant, default .65 or from power if given. BHP_GZ [sfanShaftBhp][sfanshaftbhp] // Fan shaft brake horsepower at vfDs and press, constant, default from eff. FRAC [sfanMotEff][sfanmoteff] // motor/drive efficiency, constant, default .9. MOTPOSCH [sfanMotPos][sfanmotpos] // motor/drive position: choice of INFLO (default), INRETURN, or EXTERNAL. INRETURN will be deferred/omitted if difficult (chip per taylor 3-4-92). [FANPLCH sfanPlCtrl // part-load control method, choice of VARSPEED (default), CYCLE, etc as above.] PYCUBIC2 sfanCurvePy // part-load energy consumption curve coefficients 6-92, default linear. MTR sfanMtri // MTR to which energy use is charged 4-11-92
FAN Name Type Variability Description/Comments sfan.fanTy choice:FANTY Start of phase 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 sfan.vfDs AFLOW_GZ End of subhour design volumetric flow (cfm actual air). constant, RQD except as noted. *s cuz varies when autoSizing. sfan.vfDs_As AFLOW Start of phase autoSized ditto for ah sfan and rfan for naming consistency. 6-95. sfan.vfDs_AsNov AFLOW Start of phase 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. sfan.vfMxF number Start of phase 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 sfan.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 sfan.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. sfan.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?? sfan.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 sfan.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 sfan.motEff FRAC_GZ Start of phase motor/drive efficiency, constant, default .9. Name Type Variability Description/Comments sfan.motPos choice:MOTPOS Start of phase 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 sfan.curvePy fan part-load energy consumption curve cubic polynomial coefficients with x0 PYCUBIC2 Name Type Variability Description/Comments sfan.curvePy.k[index] number Array [6] Start of phase FLOAT k[6]. [0..3] are coeff, [4] is minimum x, [5] is terminator needed by cul.cpp. Name Type Variability Description/Comments sfan.mtri TI Start of phase subscript of meter (MTR) to which energy consumption is charged sfan.endUse choice:ENDUSE Start of phase end use to which energy consumption is charged not used for all fans (many implicitly default to "fan") Name Type Variability Description/Comments sfan.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 sfan.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. sfan.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 sfan.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) sfan.c CFLOW End of subhour current average flow in heat cap units (Btuh/F): input saved for probing by last call to FAN::pute() sfan.t TEMP End of subhour current air temp, input saved ditto, used in converting BtuF/F to cfm sfan.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) sfan.p number End of subhour (motor) power consumption for subhour -- inPower * relLoad. *subhrDur for meter. sfan.q number End of subhour heat (power) to air this subhour: airPower * relLoad. Member needed in addition to c and dT?? sfan.dT TEMPDIFF End of subhour temp difference due to fan: q/c sfan.qAround number End of subhour heat to air around motor, if not in air flow, for use re supply fan motor in return air

Name	Type	Variability	Description/Comments
rfan			return/relief (rr) fan subsruct (decl above) if rfan.fanType is NONE, other rr fan members are disallowed. following rr fan inputs are stored in FAN subrecord rfan: RFANTYCH [rfanType][rfantype] // return fan type/position: choice of NONE (default), RETURN, or RELIEF. constant. AFLOW_GZ [rfanVfDs][rfanvfds] // design volume flow, constant, default [sfanVfDs][sfanvfds]. [ less min outside air -- undone 7-95 ] FLOAT [rfanVfMxF][rfanvfmxf] // factor by which fan will exceed vfDs (at reduced pressure). dfl 1.3. constant. PRESAIR_GZ [rfanPress][rfanpress] // design pressure, "H2O, constant, default .75. //At most one of the next 2 may be given: FRAC rfanFanEff // Fan efficiency at vfDs and press, constant, default .65 or from power if given. BHP_GZ [rfanShaftBhp][rfanshaftbhp] // Fan shaft brake horsepower at vfDs and press, constant, default from eff. FRAC [rfanMotEff][rfanmoteff] // motor/drive efficiency, constant, default .9. MOTPOSCH [rfanMotPos][rfanmotpos] // motor/drive position: choice of INFLO (default) or EXTERNAL. [FANPLCH rfanPlCtrl // part-load control method, choice of VARSPEED, CYCLE, etc. default: same as supply fan.] PYCUBIC2 rfanCurvePy // part-load energy consumption curve coefficients 6-92. default: same as supply fan. MTR rfanMtri // MTR to which energy use is charged 4-11-92
FAN Name Type Variability Description/Comments rfan.fanTy choice:FANTY Start of phase 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 rfan.vfDs AFLOW_GZ End of subhour design volumetric flow (cfm actual air). constant, RQD except as noted. *s cuz varies when autoSizing. rfan.vfDs_As AFLOW Start of phase autoSized ditto for ah sfan and rfan for naming consistency. 6-95. rfan.vfDs_AsNov AFLOW Start of phase 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. rfan.vfMxF number Start of phase 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 rfan.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 rfan.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. rfan.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?? rfan.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 rfan.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 rfan.motEff FRAC_GZ Start of phase motor/drive efficiency, constant, default .9. Name Type Variability Description/Comments rfan.motPos choice:MOTPOS Start of phase 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 rfan.curvePy fan part-load energy consumption curve cubic polynomial coefficients with x0 PYCUBIC2 Name Type Variability Description/Comments rfan.curvePy.k[index] number Array [6] Start of phase FLOAT k[6]. [0..3] are coeff, [4] is minimum x, [5] is terminator needed by cul.cpp. Name Type Variability Description/Comments rfan.mtri TI Start of phase subscript of meter (MTR) to which energy consumption is charged rfan.endUse choice:ENDUSE Start of phase end use to which energy consumption is charged not used for all fans (many implicitly default to "fan") Name Type Variability Description/Comments rfan.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 rfan.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. rfan.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 rfan.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) rfan.c CFLOW End of subhour current average flow in heat cap units (Btuh/F): input saved for probing by last call to FAN::pute() rfan.t TEMP End of subhour current air temp, input saved ditto, used in converting BtuF/F to cfm rfan.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) rfan.p number End of subhour (motor) power consumption for subhour -- inPower * relLoad. *subhrDur for meter. rfan.q number End of subhour heat (power) to air this subhour: airPower * relLoad. Member needed in addition to c and dT?? rfan.dT TEMPDIFF End of subhour temp difference due to fan: q/c rfan.qAround number End of subhour heat to air around motor, if not in air flow, for use re supply fan motor in return air

Name	Type	Variability	Description/Comments
cch			crankcase heater subrecord 10-92 for AHP's, perhaps DX, must be common to heat and cool.
CCH CCH inputs Name Type Variability Description/Comments cch.cchCM CCHCM Start of run crankcase heater presence and control method choice. Niles cchCtlMtd. Default: PTC_CLO if ahhc.coilTy is AHP, else NONE. NONE no crankcase heater present CONSTANT crankcase heater input always pMx. PTC control per oil temp when compr doesn't run (see tMx,tMn,dt); pMn if runs at all in subhour. TSTAT control per outdoor temp when compr is off; 0 if compr runs at all in subhour. See tOn,tOff. CONSTANT_CLO,PTC_CLO: same as corres choices above except 0 input during fraction of time compr is on. TSTAT_CLO omitted: moot. for all [cchCM][cchcm]'s: cch.pMx KW_GZ Start of phase Crankcase resistance heater input power; maximum power if [cchCM][cchcm] is PTC or PTC_CLO. default .4kW. entered in kW, internally in Btuh. Niles pCchMx. for PTC & PTC_CLO: cch.pMn KW_GZ Start of phase min cch input power. default .04kW. entered in kW, internally in Btuh. Niles pCchMn. cch.tMx TEMP Start of phase low temp (max power) setpoint... Default 0 F. Niles tCchPtcMx. cch.tMn TEMP Start of phase high temp (min power) setpoint for [cchCM][cchcm] = PTC or PTC_CLO. Default 150 F. Niles tCchPtcMn. For PTC or PTC_CLO, when compr does not run, cch input is pMx if oil temp below tMx, pMn above tMn, proportional between. If compr runs at all in subhr, input is pMn. See dt, next. tMn must be >= tMn. == allowed. cch.dt TEMPDIFF Start of phase how much warmer than outdoor temp crankcase oil is assumed to be, in subhrs when compr does not run. Default 20 F. Niles tCchDelta. for [cchCM][cchcm] = TSTAT: cch.tOn TEMP Start of phase outdoor temp cch turn-on setpoint ... Default 72 F. Niles tCchTstOn. cch.tOff TEMP Start of run outdoor temp cch turn-off setpoint for hours when compr does not run. Default tOn. Niles tCchTstOff. Give tOff > tOn to simulate thermostat differential. == allowed. < yeilds error message. If compr runs at all in subhour, crankcase heater is off for entire subhour. for all [cchCM][cchcm]'s: cch.mtri TI Start of phase subscript of meter to which cch energy use is to be recorded, default none. CCH setup time Rob used p not Niles' e for next 2, 10-92: *r ENERGY e47Off // energy input during off part of one cycle of ARI 47 degree cycling test, kWh. Niles eCchOffCyc47. *r ENERGY e47On // .. on .. Niles eCchOnCyc47. Name Type Variability Description/Comments cch.p47Off number Start of run power input during off part of one cycle of ARI 47 degree cycling test, kWh. *r POWER p47On // .. on .. restore if need found. cch.p17 number Start of run power input to crankcase heater in ARI 17 degree continuous operation test, kW. Niles pCch17. cch.p47 number Start of run ditto 47 degree test. Niles pCch47. p17 and p47 always the same; p47 may be used in code as crankcase heater input in any test. ??clarify while coding. CCH runtime Name Type Variability Description/Comments cch.frCprOn number End of subhour fraction of time compressor ran this subhour, input to power determination. copy of ahhc.frCprOn for AHP, frCOn * frFanOn for DX, etc. cch.tState BOO End of subhour thermostat state for cchCM = TSTAT: must remember to implement hysteresis cch.p number End of subhour cch input===output power this subhour

Name	Type	Variability	Description/Comments
ahhc			ah heat coil subrecord. If ahhc.coilType is NONE, other hc inputs are disallowed. following ah heat coil inputs are stored in ahhc, + many additions: HCOILTYCH [ahhcType][ahhctype] // choice of NONE (default), ELEC, HW (hot water, GAS, OIL, AHP, ... constant. OFFAVAILVC ahhcSch // OFF or AVAIL, hourly, default AVAIL. POWER_GZ ahhcCaptRat // total rated capacity (Btu/hr), constant, RQD. TI [ahhcMtr][ahhcmtr] // MTR to which to charge energy use for non-plant coil types. many more now (7-92), update
AHHEATCOIL Name Type Variability Description/Comments ahhc.coilTy choice:COILTY Start of run coil type choice according to application, as follows. constant. air handler cool coil: NONE (default), ELEC, DX, CHW, ... air handler heat coil: NONE (default), ELEC, HW, GAS, OIL, AHP, ... terminal heat coil: NONE (default if no local heat), ELEC (dflt if local heat), HW, GAS,OIL??... "ELEC COOL COIL" is a testing aid that cools with 100% efficiency & capacity at any temp. Name Type Variability Description/Comments ahhc.sched OFFAVAILVC Start of hour AVAIL when coil available, OFF when disabled, hourly, default AVAIL. sensible cap'y: see COOLCOIL.capsRat. Name Type Variability Description/Comments ahhc.captRat POWER_NZ End of subhour *s *e for probes, cuz autoSize changes it. hourly for input purposes. total rated cap'y (Btuh), RQD except AHP, ?CHW, hrly vbl for furnaces, const for DX coil. ahhc.captRat_As number Start of phase captRat determined by autoSizing, w less vbly for easier use in probes in main sim. 6-95. ahhc.captRat_AsNov number Start of phase raw captRat determined by autoSizing, before overSize added, for reports/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. ahhc.bCaptRat number End of subhour start-subHr captRat, to undo size increases not in use as converged at end subhr (ahhc,ahcc). Name Type Variability Description/Comments ahhc.eirRat number Start of hour rated load energy input ratio===heat input ratio===input/output===1/efficiency for DX,GAS,OIL at least. hrly vbl for GAS,OIL; constant for DX, . effRat: see HEATCOIL. Name Type Variability Description/Comments ahhc.mtri TI Start of phase MTR to which to charge coil main energy use, if not through a plant. Name Type Variability Description/Comments ahhc.aux POWER_GEZ Start of hour additional input energy used by auxiliary controls and devices. ahhc.auxMtri TI Start of phase Meter for auxiliary energy coil runtime members Name Type Variability Description/Comments ahhc.q number End of subhour average (not fan-on) output power level for subhour ahhc.qPr number End of subhour output at which coil's plant last computed, for call-flagging plant. set: cnhp.cpp. used: cncoil.cpp ahhc.p number End of subhour input power level this subhour, from plant or to charge to meter (*subhrDur!). p = input from plant tentative 9-92; implemented for HW coils. ahhc.plr number End of subhour current fan-on (or furnace-on) relative load (part load ratio) ahhc.plrAv number End of subhour current average relative load (plr * frFanOn) ahhc.eir number End of subhour energy input ratio: current input/output, fan on===average. Rob's addition, for probes, 5-92. ahhc.capMax number End of subhour maximum capacity this subhour, used to calculate tPossH/C. ahhc.pAux number End of subhour aux power this subhour has all members of base class COIL, and... heat coil additional input members CAUTION: HEATCOIL::setup code used to assume .effRat was 1st derived class member, 7-92. for GAS or OIL furnace "coil" in ah Name Type Variability Description/Comments ahhc.effRat FRAC_GZ Start of phase efficiency @ rated load: alternate eir input, converted into eirRat in setup. ahhc.pyEi cubic polynomial coefficients to correct full-load energy input for part load ratio for GAS or OIL heat coil. Default (per DOE2): .01861, 1.094209, -.112819, 0. PYCUBIC Name Type Variability Description/Comments ahhc.pyEi.k[index] number Array [5] Start of phase FLOAT k[5]. One extra member needed as terminator by cul.cpp array input logic, 5-92. possible future setup optimizations: 1) select ptr to fcn that does not compute terms whose k is 0; 2) precalculate constants to compute in form ((x*k[3] + k[2])*x + k[1])*x + k[0] ahhc.stackEffect number Start of hour fraction of unused capacity that must be used (increasing plr) to make up for increased infiltration due to hot stack when (indoor) furnace runs but not continuously. Default 0. Expect function of Top.tDbO. for HW coil ahhc.hpi TI Start of phase subscript of [HEATPLANT][heatplant] serving HW coil heat coil setup time members for HW coil ahhc.nxTu4hp TI Start of run TuB subscr of next TU with HW coil on same HEATPLANT. 1st is HEATPLANT.tu1. ahhc.nxAh4hp TI Start of run AhB subscr of next AH with HW coil on same [HEATPLANT][heatplant]. 1st is [HEATPLANT][heatplant].ah1. heat coil runtime members for GAS or OIL furnace "coil" in ah ahhc.flueLoss number End of subhour part-load flue loss this subhour, GAS and OIL only for HW or AHP coil ahhc.qWant number End of subhour HW: desired output===input, doHWCoil to hpCompute, used in determining capF. AHP: desired output, doAhpHeatCoil to doAhpHeat *s *e POWER q // current output power: is a COIL member. *s *e POWER qPr // output at which coil's plant last computed, for change-flagged plant: COIL member AHP steady state heating capacity Name Type Variability Description/Comments ahhc.cap17 POWER_GZ Start of phase ARI steady state rated cap @ 17 out, 70 indoor (return) air, Btuh, RQD for AHP, Niles pCapSs17. ahhc.capRat1747 FRAC_GZ Start of run cap17 / cap47 ratio (re autosizing) ahhc.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() ahhc.cap35 POWER_GZ Start of run ARI steady state rated cap @ 35F outdoor, Btuh, default per fd35Df, Niles pCapSs35. Reflects frost buildup and defrost degradation but no cycling. Unlikely to be known; defaults to fd35Df (next) times a value linearly interpolated between cap17 & cap47. If given, error if greater than value linearly interpolated between cap17 & cap47. ahhc.fd35Df number Start of phase Default frost/defrost degradation factor at 35 F, default .85, Niles fdf35dft. Reduction of output at unchanged input, due to defrosting and due to frost on outdoor coil. Used in determining default value for cap35 (preceding); not used if cap35 is given. ahhc.capIa number Start of phase Capacity correction factor for indoor (return) air temperature, default .004, Niles iacCap. Expressed as a fraction reduction in capacity per degree above 70F. ahhc.capSupHeat FLOAT_GEZ Start of phase Output of supplemental coil, Btu/h. ahhc.effSupHeat FLOAT_GZ Start of hour Supplemental heat efficiency ahhc.supHeatMtri TI Start of phase meter for supplemental heat energy use ahhc.tFrMn TEMP Start of phase lowest temp for frost buildup & defrost effects, default 17F, Niles tFrstMn. ahhc.tFrMx TEMP Start of phase highest temp for frost buildup & defrost effects, default 47F, Niles tFrstMx. ahhc.tFrPk TEMP Start of phase temp for peak frost buildup & defrost effects, default 42F, Niles tFrstPk. Frost buildup & defrost capacity reduction comes from frost buildup on outdoor coil, plus time spent doing reverse cycle defrosting (heating outdoor coil: cools indoor coil). Error if not tFrMn < tFrPk < tFrMx. ahhc.dfrFMn number Start of phase min frac time in reverse cycle cooling, default .0222 (2/90 min), Niles tmFrcDefMn. ahhc.dfrFMx number Start of phase max frac time in reverse cycle cooling, default .0889 (8/90 min), Niles tmFrcDefMx. Error if dfrFMx <= dfrFMn. Fraction of time defrosting is min is at/below tFrMn and at (not above) tFrMx. Max used at tFrPk. Linear interp between. 0 time defrosting above tfrMx. During defrosting time, cold output (see dfrCap) not heat is delivered to load, addl heater (see dfrRh) is operated. ahhc.dfrCap POWER_NZ Start of run cooling capacity (to ah supply air) during defrosting, default 2 * cap17, Niles pDefCool. Should include any effects of switchover transient; program will compute lost heating cap. Negative internally. (future) should check or default somehow vs ahp cooling inputs if given? *f KW_GZ dfrRh /* input (& output) power of addl reheat coil run during defrost, default 5kW, Niles pDefRh. entered as kW, converted to Btuh internally by units stuff. */ AHHEATCOIL inputs for AHP low temperature cutout ahhc.tOff TEMP Start of phase low temp cutout setpoint, default 5 F, Niles tOff. ahhc.tOn TEMP Start of phase low temp cut-back-in setpoint, default 12 F, Niles tOn. tOn==tOff ok, error if <. AHHEATCOIL AHP (air source heat pump) heating power input inputs ahhc.COP17 FLOAT_GZ Start of phase COP input @ 17 outdoor, 70 indoor (return). RQD for AHP. Niles pInSs17. ahhc.COP47 FLOAT_GZ Start of phase COP input @ 47 outdoor, 70 indoor (return). RQD for AHP. Niles pInSs47. ahhc.inIa number Start of phase indoor (return) air temp power input correction factor, default .004, Niles iacIn. Fraction decrease in steady-state input per degree above 70F. ahhc.cd number Start of phase ARI cycling degradation coefficient, default .25, Niles cd. Ratio of fraction drop in system COP (incl cch, defrost) to fraction drop in capacity when cycling, from steady-state values, in ARI 47 F cycling performance tests. A value of .25 means that if the heat pump is cycled to drop its output to 20% of full capacity (i.e. by the fraction .8), its COP will drop by .8 * .25 = .2. meter: COIL.mtri is used; compr input power to category htg, and suppl heater input to catagory hp. AHP non-inputtable contants AHHEATCOIL AHP setup time members Name Type Variability Description/Comments ahhc.in17 KW_GZ Start of run steady state power @ 17 outdoor, 70 indoor (return). RQD for AHP. Niles pInSs17. ahhc.in47 KW_GZ Start of run steady state power @ 47 outdoor, 70 indoor (return). RQD for AHP. Niles pInSs47. These reflect full power, no cycling, include compr & crankcase heater. Program removes cch input energy. Externally kW, internally Btuh. ahhc.in17c number Start of run compressor input power @ 17 degrees out, 70 in: in17 with cch power removed. Niles pInSs17. ahhc.in47c number Start of run ditto 47 degrees. Niles pInSs47. ahhc.cdm number Start of run modified cd: cycling degradation coefficient adjusted to remove cch. Niles cdm. AHHEATCOIL AHP runtime input members Name Type Variability Description/Comments ahhc.tIa TEMP End of subhour indoor air temp: copy of tmix or whatever ah variable is chosen qWant desired output: HEATCOIL member used. ahhc.qSupLim number End of subhour caller-set heat output limit for when suppl heat in use: kludge when fan cycling to prevent raising ts and dropping fanFrOn to where suppl heat cuts out --> ah oscillation ahhc.frFanOn DBL End of subhour fraction of time fan runs, 1.0 if not cycling, copy of AH.frFanOn. AHHEATCOIL AHP runtime internal members ahhc.loTLockout BOO End of subhour TRUE if compressor locked out due to low outdoor temp (see tOff, tOn) ahhc.supOn BOO End of subhour TRUE if supplementary heat enabled (frFanOn is ~1.0, with hysterisis to keep ah stable). ahhc.capCon number End of subhour continuous cpr capac incl frost/defrost @ actual indoor temp, excl def & reg rh. Niles pCapMx. ahhc.qDfrhCon number End of subhour continuous avg heat ouput to defrost heater @ outdoor temp (not cycling). Niles pDefRhMx. made local, only set in cases needed: *s *e FRAC hlf // heating load factor: hp compr heat used/capCon. Excludes reg & dfr rh. frCprOn may be larger. *s *e FRAC plf // part load factor, by which COP falls due to cycling. *s *e FRAC frTmDfr // fraction of time defrosting, this subhour. Niles tmFrDef. AHHEATCOIL AHP runtime output members q: coil member: heat delivered, by heat pump incl suppl heaters (qSh). Niles pDel. ahhc.frCprOn number End of subhour fraction of time compressor runs, this subhour. May be used by cch code. Niles tmFrRun. ahhc.pCpr number End of subhour power input to compressor (Niles pInComp): copy to .p in coilsEndSubhr. ahhc.qSh number End of subhour output of reg (not defrost) supplemental heaters. Included in q of coil. ahhc.pSh number End of subhour input of reg & dfr supplemental resistance heaters. crankcase heater input power: see CCH.p. Niles pCch.

Name	Type	Variability	Description/Comments
ahccBypass	FRAC_GZ	Start of phase	fraction of air flow which bypasses cool coil (for better humidity control), constant, dfl 0. Bypass is fixed at given fraction; no damper control is modelled.

Name	Type	Variability	Description/Comments
ahcc			cool coil subrecord. If ahcc.coilType is NONE, other cc inputs are disallowed. following cool coil inputs are stored in ahcc: CCOILTYCH [ahccType][ahcctype] // choice of NONE (default), ELEC, DX, CHW, ... . constant. OFFAVAILVC ahccSch // OFF or AVAIL, hourly, default AVAIL. POWER_GZ ahccCaptRat // total rated capacity (Btu/hr), constant, RQD. POWER_GZ ahccCapsRat // sensible rated capacity 1-CaptRat Btu/hr, constant. Can it default to a % of CaptRat? FRAC_GZ [ahccSHRRat][ahccshrrat] // sensible heat ratio (caps/capt) for cooling coil TI [ahccMtr][ahccmtr] // MTR to which to charge energy use for non-plant-supported coil types. many more now -- should update this, 5-92.
COOLCOIL Name Type Variability Description/Comments ahcc.coilTy choice:COILTY Start of run coil type choice according to application, as follows. constant. air handler cool coil: NONE (default), ELEC, DX, CHW, ... air handler heat coil: NONE (default), ELEC, HW, GAS, OIL, AHP, ... terminal heat coil: NONE (default if no local heat), ELEC (dflt if local heat), HW, GAS,OIL??... "ELEC COOL COIL" is a testing aid that cools with 100% efficiency & capacity at any temp. Name Type Variability Description/Comments ahcc.sched OFFAVAILVC Start of hour AVAIL when coil available, OFF when disabled, hourly, default AVAIL. sensible cap'y: see COOLCOIL.capsRat. Name Type Variability Description/Comments ahcc.captRat POWER_NZ End of subhour *s *e for probes, cuz autoSize changes it. hourly for input purposes. total rated cap'y (Btuh), RQD except AHP, ?CHW, hrly vbl for furnaces, const for DX coil. ahcc.captRat_As number Start of phase captRat determined by autoSizing, w less vbly for easier use in probes in main sim. 6-95. ahcc.captRat_AsNov number Start of phase raw captRat determined by autoSizing, before overSize added, for reports/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. ahcc.bCaptRat number End of subhour start-subHr captRat, to undo size increases not in use as converged at end subhr (ahhc,ahcc). Name Type Variability Description/Comments ahcc.eirRat number Start of hour rated load energy input ratio===heat input ratio===input/output===1/efficiency for DX,GAS,OIL at least. hrly vbl for GAS,OIL; constant for DX, . effRat: see HEATCOIL. Name Type Variability Description/Comments ahcc.mtri TI Start of phase MTR to which to charge coil main energy use, if not through a plant. Name Type Variability Description/Comments ahcc.aux POWER_GEZ Start of hour additional input energy used by auxiliary controls and devices. ahcc.auxMtri TI Start of phase Meter for auxiliary energy coil runtime members Name Type Variability Description/Comments ahcc.q number End of subhour average (not fan-on) output power level for subhour ahcc.qPr number End of subhour output at which coil's plant last computed, for call-flagging plant. set: cnhp.cpp. used: cncoil.cpp ahcc.p number End of subhour input power level this subhour, from plant or to charge to meter (*subhrDur!). p = input from plant tentative 9-92; implemented for HW coils. ahcc.plr number End of subhour current fan-on (or furnace-on) relative load (part load ratio) ahcc.plrAv number End of subhour current average relative load (plr * frFanOn) ahcc.eir number End of subhour energy input ratio: current input/output, fan on===average. Rob's addition, for probes, 5-92. ahcc.capMax number End of subhour maximum capacity this subhour, used to calculate tPossH/C. ahcc.pAux number End of subhour aux power this subhour additional inputtable members for cooling coil CAUTION: cncult5:COOLCOIL::setup code used to assume .cppapsRat was 1st derived class member 5-92. total rated capacity: see COIL::captRat. Not used for CHW. Name Type Variability Description/Comments ahcc.capsRat POWER_NZ End of subhour dx: sensible rated capacity <= CaptRat Btu/hr, const for input, *s cuz varies during autoSize. ahcc.capsRat_As number Start of phase AutoSized ditto for naming consistency. 6-95. ahcc.capsRat_AsNov number Start of phase Raw autoSized ditto, b4 oversize added, for report & probing. 7-95. ahcc.SHRRat FRAC_GZ Start of phase sensible heat ratio (caps/capt) for cooling coil cnausz.cpp code ASSUMES x, x_As, x_AsNov together for access thru one ptr. cuprobe.cpp's name search also requires together. ahcc.minTEvap TEMP_GZ Start of phase dx: min evaporator (effective surface) temp (below which compressor cuts out), default 35F. (40F til 8-95) ahcc.k1 FLOAT_LZ Start of phase dx, chw: power of relative air flow to which outside number of transfer units is proportional. Used in formula of form: ntuO = ntuoDs*(relCfm)^k1. Default dx: -.3, chw: -.2. Niles k1. (dx,chw) coil rating (design) conditions. otta make names consistent: change vfR to vfDs? Name Type Variability Description/Comments ahcc.dsTDbCnd TEMP_GZ Start of phase design (rating) (dx) condenser temp (outdoor temp pending water option), default = ARI = 95F. ahcc.dsTDbEn TEMP_GZ Start of phase design (rating) (dx,chw) entering air dry bulb temp, default = ARI = 80F. ahcc.dsTWbEn TEMP_GZ Start of phase design (rating) (dx) entering air wet bulb temp, default = ARI = 67F. replaces Taylor's dsEAWB. ahcc.vfR AFLOW_GZ Start of run rating (dx,chw) air flow (cfm). default: DX: per vfRperTon. CHW: sfan.vfDs. ahcc.vfRperTon number Start of run DX default vfR per ton (12000 Btuh) of captRat. default: 400. re dx cool coil compressor cycling and energy consumption Name Type Variability Description/Comments ahcc.minUnldPlr number Start of phase part load ratio (fraction of full load) at/above which "compressor unloading" is used. dfl 1. ahcc.minFsldPlr number Start of phase plr above which "false loading" is used (up to minUnldPlr). dfl minUnldPlr: no false loading. eirMinUnldPlr below: pydxEirUl(minUnldPlr) precomputed at setup. *h FLOAT eirRAT // rated load energy input ratio: is a COIL member inputtable coefficients for dx polynomial correcting fcns. Defaulted to DOE2 "PTAC" values (or as changed) by cncult5 code. enter comma-separated list of coefficients in order: PYCUBIC: cubic(x): constant, coeff x, coeff x^2, coeff x^3. PYBIQUAD: biquadratic(x,y): constant, coeff x, coeff x^2, coeff y, coeff y^2, coeff x*y. corrects... Name Type Variability Description/Comments ahcc.pydxCaptT dx capt for (off-rated) tWbEn and tDbCnd (entering wetBulb, condenser dryBulb temps) PYBIQUAD Name Type Variability Description/Comments ahcc.pydxCaptT.k[index] number Array [7] Start of phase FLOAT k[7]. One extra member needed as terminator by cul.cpp array input logic, 5-92. ahcc.pydxCaptF dx capt (off-rated) relative flow; arg is plrVf PYCUBIC Name Type Variability Description/Comments ahcc.pydxCaptF.k[index] number Array [5] Start of phase FLOAT k[5]. One extra member needed as terminator by cul.cpp array input logic, 5-92. possible future setup optimizations: 1) select ptr to fcn that does not compute terms whose k is 0; 2) precalculate constants to compute in form ((x*k[3] + k[2])*x + k[1])*x + k[0] ahcc.pydxCaptFLim number Start of phase upper limit for value of pydxCaptF, 8-28-95 ahcc.pydxEirT dx energy input for tWbEn and tDbCnd PYBIQUAD Name Type Variability Description/Comments ahcc.pydxEirT.k[index] number Array [7] Start of phase FLOAT k[7]. One extra member needed as terminator by cul.cpp array input logic, 5-92. ahcc.pydxEirUl dx energy in for part load in dx compr-unloading range (minUnldPlr <= plr <= 1). (Adjusts full-load input (eirRat*capt): I claim eir in name is misnomer, rob 5-92). note for minFsldPlr < plr < minUnldPlr, input remains at minUnldPlr's; for plr <= minUnldPlr, input does straight line to 0. PYCUBIC Name Type Variability Description/Comments ahcc.pydxEirUl.k[index] number Array [5] Start of phase FLOAT k[5]. One extra member needed as terminator by cul.cpp array input logic, 5-92. possible future setup optimizations: 1) select ptr to fcn that does not compute terms whose k is 0; 2) precalculate constants to compute in form ((x*k[3] + k[2])*x + k[1])*x + k[0] inputtable COOLCOIL members for CHW coil, 10-92. all const. Name Type Variability Description/Comments ahcc.cpi TI Start of phase subscript of COOLPLANT serving CHW coil, RQD for chw. ahcc.gpmDs H2OFLOW_GZ Start of phase design (i.e. maximum) chilled water flow, gpm, RQD for chw. Niles mwd[g]. ahcc.ntuoDs FLOAT_GZ Start of phase outside number of transfer units at design air flow (vfR), default 2. Niles ntuOd. ahcc.ntuiDs FLOAT_GZ Start of phase inside number of transfer units at design water flow (gpmDs), default 2. Niles ntuId. also used, above: vfR, dsTDbEn, k1. Not used for chw: captRat, capsRat, . note Niles k2 not used as not simulating flow/exit temp. COOLCOIL setup time: dx: Name Type Variability Description/Comments ahcc.wsatMinTEvap DBL Start of run hum ratio of saturated air at minTEvap (minimum evaporator temp) ahcc.hsatMinTEvap DBL Start of run enthalpy of saturated air at minTEvap ahcc.efecOR DBL Start of run (outside) effectiveness at rated conditions (in record for probing only) ahcc.ntuR DBL Start of run number of trasfer units (like time constants) at rated conditions ahcc.eirMinUnldPlr DBL Start of run pydxEirUl(minUnldPlr): precomputed dx input correction for falseLoading; prorate for cycling. dx and chw: ahcc.menR DBL Start of run chw/dx coil rating air flow (lb/hr) (for chw, Niles 'mad') vfR * air density @ dsTDbEn, @ sea level 1-95 chw setup time: ahcc.nxAh4cp TI Start of run 0 or subscr of next AH with CHW coil served by same COOLPLANT. 1st is COOLPLANT.ah1. ahcc.mwDs DBL Start of run MFLOW design (max) chilled water flow: .gpmDs converted to lb/hr. COOLCOIL runtime members Name Type Variability Description/Comments ahcc.wantQflag BOO End of subhour nz if cooling desired (texWant < ten) regardless of sched, etc. doCoils-->cpEstimate. chw: ahcc.tewd DBL End of subhour TEMP chw internal: full-water-flow effective temp: prior value used next time called. ahcc.chwQ DBL End of subhour POWER heat taken from primary loop water, negative: chw load, to [COOLPLANT][coolplant] (same as ahcc.q). ahcc.tr DBL End of subhour TEMP water return temp to coolplant ahcc.cpTsPr TEMP End of subhour cp ts for which coil last computed, re compute-flagging coil from plant ahcc.trPr TEMP End of subhour coil tr at last coil compute, re call-flagging cp from coil model ahcc.fullLoadWet BOO End of subhour true if CHW coil wet @ full load, with hysterisis cuz CHW coil model has output discontinuity 10-92. dx mainly... ahcc.frCprOn DBL End of subhour dx: output to crankcase heater (via coilsEndSubhr): fraction of time compressor on. Move to COIL or AH if additional applicabilities found: ahcc.tWbEn DBL End of subhour TEMP dx coil entering air wetBulb temp: doDxCoil to coilsEndSubhr. ahcc.hen DBL End of subhour ENTHALPY dx,chw coil entering air enthalpy / is member for probeing ahcc.tDbCnd DBL End of subhour TEMP dx system condenser temp: Top.tDbO or (future) water temp) dx... following are members for probe-ability where local variable might [would] otherwise suffice: review for unused ones and delete: ahcc.efecO DBL End of subhour FRAC current (dx coil) effectiveness ahcc.capt DBL End of subhour POWER current (dx or any cool coil) total capacity ahcc.caps DBL End of subhour POWER current (dx coil) sensible capacity ahcc.plrVf DBL End of subhour FRAC current (dx coil) fan-on relative flow (part fan load ratio, cfm, Niles' plrCfm). ahcc.plrSens DBL End of subhour FRAC current (dx coil) fan-on relative sensible load (part load ratio) ahcc.qs DBL End of subhour POWER current (dx coil) sensible load ahcc.ql DBL End of subhour POWER current (dx coil) latent load general *s *e POWER q COIL member above: current total load: q = qs + ql *s *e POWER p COIL member above: current (electrical or ?plant) input power *s *e FRAC plr COIL member above: current fan-on relative load (part load ratio) *s *e FLOAT eir COIL member above: current (dx,elec) energy input ratio: eir = p / q *s *e POWER qPr COIL member; currently 10-92 not used for coolcoil *s *e TEMP tsPr plant supply temp at which coil last computed, for compute-flagging coil: COIL member ahcc.xLGain ENERGY End of subhour condensation heat added to air (const enthalpy) to fix supersaturated wen, this subhr. ahcc.xLGainYr ENERGY End of subhour .. cumulative over run, for message at end run. ahcc.nSubhrsLX number End of subhour number of subhours in which supersaturated entering air fixed flags for messages at end autoSize (or run, future?) ahcc.minTLtd BOO End of subhour output limited by minTEvap b4 reaching ahTsMn (DX, 7-95) ahcc.cfm2Few BOO End of subhour too little flow to permit sizing coil to meet load at min temp (DX, 7-95)

Name	Type	Variability	Description/Comments
tu1	TI	Start of run	chain head: TuB ss of 1st terminal for air handler. Next is TU.nxTu4a.
zhx1	TI	Start of run	chain head of ah's ZHX's (Zone Hvac Xfers): 0 or ZhxB subscript of first. next: ZHX.nxZhx4a.

ah runtime, terminals interactions:

Name	Type	Variability	Description/Comments
ahMode	AHMODE	End of subhour	what ah is doing: set to: ahOFF/ahFAN/ahHEATING/ahCOOLING/ahON(normal). test: & ahFAN, & ahHEATBIT, & ahCOOLBIT for fan, heatcoil, coolcoil enabled.
tSup	DBL	End of subhour	TEMP supply temp FOR TERMINALS, F. Set from working copy aTs at ahCompute exit. Differs from tsSp1 by duct loss and leakage (as well as coil limitations).
wSup	DBL	End of subhour	HUMRAT supply air humidity ratio for TERMINALS, set from working copy aWs at ah exit
wSupLs	DBL	Start of subhour	HUMRAT end prior subhr ah_wSup (=ah_wSup in 1st iteration), AH:ah_AfterSubhr to ZNR::ztuMdSets
airxTs	DBL	End of subhour	HC_VOL Btuh/cfm-F volumetric flow heat capacity of air at ts (airVsh, * 60 min/hour).
tsMnFo	DBL	End of subhour	TEMP ctu min flow, coil-off supply temp, calc'd & ret'd by getTsMnFo. See tsMnFoOk.
tsMnFoOk	BOO	End of subhour	TRUE if tsMnFo has been calc'd since last ahEstimate/ahCompute. set/used in getTsMnFo().
tsMxFo	DBL	End of subhour	TEMP ctu max flow, coil-off supply temp, calc'd & ret'd by getTsMxFo. See tsMxFoOk.
tsMxFoOk	BOO	End of subhour	TRUE if tsMxFo has been calc'd since last ahEstimate/ahCompute. set/used in getTsMxFo().

input used for this iteration: return air as it left (future) plenum, b4 return duct: weighted average zones

Name	Type	Variability	Description/Comments
tr	DBL	End of subhour	TEMP return air temp (wtd avg zones, adj for (future) plenum)
wr	DBL	End of subhour	HUMRAT return air humidity ratio
cr	DBL	End of subhour	CFLOW return air flow (heat cap units); same as total supply air to zones
cMxfcc	DBL	End of subhour	CFLOW max flow used re deterimining frFanOn (member for probes / dbg aid).
frFanOn	DBL	End of subhour	FRAC if fcc, fraction of time coil/fan are on (cr/max poss c), else 1.0 (fan always on).
leakCOn	DBL	End of subhour	CFLOW fan-on rtn duct leak in === sup duct leak out (6-92). mbr for probes / dbg aid. at entry to air handler, this iteration -- see Nx's below.
tr1	DBL	End of subhour	TEMP return air temp after return duct loss and leakage
wr1	DBL	End of subhour	HUMRAT hum rat after return duct leakage
cr1	DBL	End of subhour	CFLOW flow ditto, heat cap units (Btuh/F) after return fan, if any, this iteration; at entry to economizer. w: use wr1. c: use cr1.
tr2	DBL	End of subhour	TEMP temp after rfan, b4 eco, for next iteration: copied to tr3 after conditional exit.
rfanQ	number	End of subhour	return fan power copied at commitment to this iteration (rfan.q is next iter)

after economizer, before supply fan and coil(s).

Name	Type	Variability	Description/Comments
tmix	DBL	End of subhour	TEMP temp after outside air/economizer
wen	DBL	End of subhour	HUMRAT hum after outside air/economizer, and at coil entry
cmix	DBL	End of subhour	CFLOW flow after outside air/eco, thru supply fan, and at supply duct (but not in cool coil) at coil entrance: after blowthru supply fan if any; excludes flow that bypasses coil
dtMixEn	DBL	End of subhour	TEMPDIFF eco to coil entry temp diff: supply fan heat if blowthru, else 0
ten	DBL	End of subhour	TEMP coil entry temp: poss fan heat added. wen: is just above.
cen	DBL	End of subhour	CFLOW flow into coil: cmix less any bypassing air, heat cap units (Btuh/F)
men	DBL	End of subhour	MFLOW same flow in mass units (lb/hr). tWbEn: see COOLCOIL. hen: see COOLCOIL. at coil exit
tex	DBL	End of subhour	TEMP coil exit temp: coil Q added.
wex	DBL	End of subhour	HUMRAT coil exit humidity ratio after coil flow mixed with bypassing air
tex1	DBL	End of subhour	TEMP add fan heat to get tSen. wex1: use aWs (below), later copied to ws (above). flow: cmix again. at ts sensor: after drawthru supply fan if any: ie at air handler exit, before supply duct. c: is cmix. w: use aWs.
dtExSen	DBL	End of subhour	TEMPDIFF coil exit to ts sensor temp difference: drawthru fan heat, else 0
tSen	DBL	End of subhour	TEMP temp at supply temp sensor (before supply duct). ahTsSp1 is setpoint for tSen. at delivery to individual terminal supply ducts, after shared supply duct leakage and loss if any w: use aWs. c: is cr, or sum of terminal c's.
dtSenS	DBL	End of subhour	TEMPDIFF supply duct temp diff, due to [ahSOLeak][ahsoleak] and [ahSOLoss][ahsoloss]
aTs	DBL	End of subhour	TEMP supply temp (air handler output). aTs is ah working copy used so last value used for ztuCompute (ts, above) remains avail thru AH::ahCompute. Elsewhere, same as ts.
aWs	DBL	End of subhour	HUMRAT hum rat of supply air, working copy, used to set ws at ah exit. CFLOW cs: expect to need when return flow != supply.

• --- temps etc... trNx...tr2Nx are values for use as inputs to NEXT iteration, resulting from current ah outputs.
• they are copied to tr...tr2 above at use (commitment to another iteration) by pute4Fs.
• next-iteration return air as it leaves (future) plenum, before return duct: weighted average zones

Name	Type	Variability	Description/Comments
trNx	DBL	End of subhour	TEMP return air temp (wtd avg zones, adj for (future) plenum)
wrNx	DBL	End of subhour	HUMRAT return air humidity ratio
crNx	DBL	End of subhour	CFLOW return air flow (heat cap units); same as total supply air to zones
cMxnx	DBL	End of subhour	CFLOW flow for frFanOnNx = 1.0: min( crNx, sfan.cMx-leak). Member just for probes/dbg aid.
frFanOnNx	DBL	End of subhour	FRAC if fcc, fraction of time coil/fan are on (crNx/max poss flow), else 1.0 (fan always on).
leakCOnNx	DBL	End of subhour	CFLOW fan-on leak into return duct === leak out of supply duct at present 6-92. member for probes/debug aid; cd remove setFrFanOn arg. at entry to air handler, next iteration
tr1Nx	DBL	End of subhour	TEMP return air temp after return duct loss and leakage
wr1Nx	DBL	End of subhour	HUMRAT hum rat ditto
cr1Nx	DBL	End of subhour	CFLOW flow ditto [formerly named cAh]; heat cap units (Btuh/F) after return fan, if any; at entry to economizer; next iteration. w: use wr1Nx. c: use cr1Nx.
tr2Nx	DBL	End of subhour	TEMP temp after rfan, b4 eco, for next iteration: copied to tr3 after conditional exit.

ah run, internal, general/miscellaneous

Name	Type	Variability	Description/Comments
uUseAr	TCUSE	End of subhour	'or' of tu.useAr's at refine() entry, for detecting pegged terminals, set in zRat, tentative.
fcc	BOO	End of hour	TRUE if fan cycles: fan runs only fraction of subhour requested by control terminal, else off. when on, fan runs full flow and coil usually at a high power. set hourly from [ahFanCycles][ahfancycles] else ahTsSp==ZN by AH::begHour. when TRUE: frFanOn is fraction time on for fan (and usually coil). flows and powers become average, divide by frFanOn for fan-on value. ah Temps, w's, plr's, po remain fan-on values. when FALSE: fan runs all the time (normal VAV case), frFanOn is 1.0.
isZNorZN2	BOO	End of hour	TRUE if ahTsSp is ZN or ZN2 this hour. 5-95.
tsSp1	DBL	End of subhour	TEMP ahTsSp as number: WZ/CZ/ZN/ZN2 resolved to temp now needed, set by AH::setTsSp1.
tsFullFlow	DBL	End of subhour	TEMP heating ts for full flow, special re AHP suppl rh stability, usually not set, cnah2.cpp:setTsSp1 to cncoil.cpp:doAhpHeatCoil
ecoEnabled	BOO	End of subhour	TRUE if economizer present and currently enabled
coilLockout	BOO	End of subhour	TRUE if cooling coil disabled by full-open non-integrated economizer
po	DBL	End of subhour	current fraction outside air
coilUsed	COILUSED	End of subhour	coil in use, doCoils to coilsEndSubhr: cuNONE, cuHEAT, or cuCOOL. 12-3-92.

ah run, internal, fan/coil overload handling

Name	Type	Variability	Description/Comments
fanF	DBL	End of subhour	"fan factor" used in determining current max flows. reduce when fan overloads.
fanFMax	DBL	End of subhour	fanF value for full flow: max tu vfMx/vfDs, reflecting both vfMxH's & vfMxC's. can change hourly, more often during autoSizing 7-95. CAUTION: fanF below fanFMax won't NECESSARILY reduce flow for current useAr's.
fanLimited	BOO	End of subhour	TRUE if using full capacity of fan without getting desired flow
coilLimited	BOO	End of subhour	TRUE if using full capacity of available coil without getting desired delta-T
tPossH	DBL	End of subhour	TEMP heating coil exit temp probably now possible, for ah estimating, doCoils to setTsSp1.
tPossC	DBL	End of subhour	TEMP cooling coil exit temp probably now possible, for ah estimating, doCoils to setTsSp1.

changes flag (many ah change conditionals use a -Pr (prior) directly, without a flag)

Name	Type	Variability	Description/Comments
ahClf	BOO	End of subhour	call-flag: set nz if must call ahCompute so it can test tr,cr etc to see if computation needed.
ahPtf	BOO	End of subhour	compute-flag: set if must call ahCompute and it should unconditionally recompute this AH: setters include: exman chaf's for ahTsSp, ahSch, ahhc.sched, ahcc.sched, etc; AH::estimate, ahCompute, ah_SetMode, ; ZNR::ztuMdSets, . tested: hvacIterSubhr(), AH::ahCompute. cleared: AH::ahCompute.
ahPtf2	BOO	End of subhour	secondary flag for compute only after zones computed again, for non-convergence. set: AH::iter4Fs. tested: hvacIterSubhr(), AH::ahCompute. cleared: AH::ahCompute.