window

Name Type Variability Description/Comments
ty number input time type CTEXTWALL, CTINTWALL, CTWINDOW, CTMXWALL, CTPERIM, CTKIVA set by cult or code.

inputs. *r's where set by topCkf in at least some cases.

Name Type Variability Description/Comments
area AREA_GZ Start of run (net) area, sf. Reflects window multiplier.
azm ANGLE Start of run azimuth (radians, 0 = North, Pi/2 = East)
tilt ANGLE Start of run tilt (radians, 0 = horiz up, Pi/2 = vert.
dircos[index] number Array [3] Start of run outward normal direction cosines for given azm/tilt
depthBG FLOAT_GEZ Start of run depth below grade of bottom of wall, ft
height FLOAT_GEZ Start of run height of surface, ft (currently only used for Kiva)
model choice:SFMODEL input time
  • surface model: user input
  • quick/auto/delayed(massive)/delayed_hour/delayed_subhour/forward_difference/kiva
modelr choice:SFMODEL Start of run
  • resolved to quick (runtime XSURF generated),
  • or to delayed_hour or _subhour (runtime MASS generated)
  • or to kiva (runtime KIVA generated)
lThkF number Start of run
  • thickness factor, adjusts max thickness allowed for mass sublayers
  • default = 0.5
Name Type Variability Description/Comments
gti TI Start of run window glazeType subscript. Used at runtime re incidence angle.
sco number Start of monthly-hourly window: SMSO: Solar Heat Gain Coef multiplier, shades Open
scc number Start of monthly-hourly window: SMSC: Solar Heat Gain Coef, shades Closed
sbcI inside (zone side) surface boundary conditions
SBC
Name Type Variability Description/Comments
sbcI.absSlr number Start of monthly-hourly solar (SW) absorptance, dimless
sbcI.awAbsSlr DBL Start of monthly-hourly
  • area-weighted solar absorptance
  • = sb_absSlr * area / zn_surfASlr
  • exterior surf outside: always 0
  • windows inside: TBD 12-8-10
  • ducts: always 0
sbcI.epsLW number Start of run thermal (LW) emittance
sbcI.zi TI Start of run adjacent zone idx, 0 if exposed to ambient
sbcI.F DBL Start of run solar (short wave) fraction ? TODO: NOT USED? as of 4-2012
sbcI.Fp DBL Start of run
  • "view factor" to zone radiant temp, dimless. Includes Oppenheim surface conductance.
  • aka "F-prime" in CZM documentation.
Name Type Variability Description/Comments
sbcI.frRad DBL Start of run re radiant to radiant temp (room radiant node or sky)
sbcI.fSky DBL Start of run "view factor" to radiant surround at sky temp
sbcI.fAir DBL Start of run "view factor" to radiant surround at air temp (ground, horizon)
Name Type Variability Description/Comments
sbcI.hcNat FLOAT_GEZ End of subhour surface natural convection coefficient, Btuh/ft2-F
sbcI.hcFrc FLOAT_GEZ End of subhour surface forced (wind) convection coefficient, Btuh/ft2-F
sbcI.hcMult FLOAT_GEZ End of subhour surface convection coefficient multiplier, dimless
sbcI.hxa FLOAT_GEZ End of subhour overall coeff to sb_txa = sb_hcMult*(sb_hcNat + sb_hcFrc), Btuh/ft2-F
sbcI.hxr FLOAT_GEZ End of subhour
  • surface (linearized) radiative coefficient, Btuh/ft2-F
  • = coupling to sb_txr
sbcI.hxtot number End of subhour sb_hxa + sb_hxr
sbcI.uRat DBL End of subhour
  • ratio uC/(sb_hxa + sb_hxr + uC)
  • = 1/(1 + rC*(sb_hxa + sb_hxr))
  • where uC = surface-to-surface conductance
  • rC = 1/uC
  • but: duct model outside surf to duct air
Name Type Variability Description/Comments
sbcI.fRat DBL End of subhour
  • sb_hxtot * sb_uRat, Btuh/ft2-F
  • = overall conductance not including other side
  • surface resistances
  • (ducts: overall conductance from duct air to sb_txe)
sbcI.cx DBL End of subhour air/radiant coupling due to this surface, Btuh/ft2-F
Name Type Variability Description/Comments
sbcI.sgTarg solar gain target: bm, df gain from insolation
SGTARG
Name Type Variability Description/Comments
sbcI.sgTarg.bm DBL End of subhour beam
sbcI.sgTarg.df DBL End of subhour diffuse
sbcI.sgTarg.tot DBL End of subhour total
sbcI.sg DBL End of subhour absorbed solar total, Btuh (NOT Btuh/ft2), summed from sb_sgTarg
Name Type Variability Description/Comments
sbcI.tSrf number End of subhour most recently calculated surface temp, F
sbcI.tSrfls number Start of subhour
  • last step surface temp, F
  • copied from sb_tSrf at step end
  • not *e (available for probing)
sbcI.qrAbs DBL End of subhour
  • total absorbed radiant heat gain at surface, Btuh/ft2 (+ = into surface)
  • = (sb_sg + sb_rIg)/area
sbcI.txa number End of subhour
  • adjacent air temp, F (from prior step)
  • inside: prior step zone tz
  • outside: current step ambient dry bulb temp
sbcI.txr number End of subhour
  • adjacent radiant temp, F
  • inside: prior step zone tr
  • outside: current step sky temp
sbcI.txe number End of subhour
  • adjacent environmental temp, F
  • combined sb_txa and sb_txr; simplifies calcs in some cases
  • set but unused? for inside
  • set/used for ASHWAT outside
sbcI.w DBL End of subhour
  • adjacent air humidity ratio if known (else 0)
  • used re duct leakage
sbcI.qSrf DBL End of subhour
  • conduction into surface, Btuh/ft2
  • updated at end of timestep
Name Type Variability Description/Comments
sbcI.pXS XSURFP Start of run parent pointer
sbcI.si number Start of run
  • side of *sb_pXS represented by this SBC
  • 0=inside, 1=outside
sbcI.fcWind DBL Start of run
  • wind constant re sb_hcFrc (includes roughness, unit conversion, height adj, ...)
  • value is model specific
  • Walton: sb_hcFrc = sb_fcWind * Top.windSpeedSqrtSh
  • Unified: sb_hcFrc = sb_fcWind * Top.windSpeedPt8
sbcI.fcWind2 DBL Start of run unified: add'l constant re sb_eta
sbcI.eta DBL End of subhour
  • unified: wind speed adjustment included in sb_hcNat
  • windV=0: sb_eta=1, sb_hcNat=still-air value
  • windv>0: sb_eta<1, sb_hcNat is reduced
  • characteristic dimensions re convection models
  • not always set or used
  • Note: may be derived from parent surface TODO
Name Type Variability Description/Comments
sbcI.widNom DBL Start of run nominal width, ft (smaller dimension assuming rectangle)
sbcI.lenNom DBL Start of run nominal length, ft (larger dimension assuming rectangle)
sbcI.lenCharNat DBL Start of run characteristic length for some natural convection models, ft
sbcI.lenEffWink DBL Start of run effective length for Winkelmann forced convection model, ft
Name Type Variability Description/Comments
sbcI.cosTilt DBL Start of run
  • cos( Tilt ) for the boundary -- note parent surface tilt is defined
  • relative to outside normal (sbcO), so inside sb_cosTilt is oposite (+180 deg)
sbcI.atvDeg DBL Start of run angle-to-vertical, deg (inside: 90-tilt; outside: tilt-90)
sbcI.cosAtv DBL Start of run cos( angle to vertical) 0 - 1 (never < 0)
sbcI.hcModel choice:CONVMODEL Start of run
  • surface convective coefficient model
  • specifies calc method sb_hcNat and sb_hcFrc
sbcI.hcLChar number Start of run
  • characteristic length, ft
  • used in derivation of exterior forced convective coeff
  • default = 10 ft
  • unused re natural convective coeff (interior or exterior)
sbcI.hcConst[index] DBL Array [3] Start of run
  • convection coefficient model constants
  • Unified: exposure to zone or ambient
  • hcNat = sb_hcConst[]*abs( TD)^.33)
  • [ 0]: tAir<=tSrf, [ 1]: tAir>tSrf
  • [ 2]: unused
  • ASHRAE: exposure to zone, hcNat = sb_hcConst[]
  • [ 0]: sys off, tAir<=tSrf, [ 1]: sys off, tAir>tSrf
  • [ 2]: sys on
  • re [sfExCnd][sfexcnd] = GROUND: conductances to weather vars, Btuh/ft2-F
  • correlation values derived by Bazjanac/Huang for various
  • insulation configurations
Name Type Variability Description/Comments
sbcI.groundModel choice:GROUNDMODEL Start of run
  • ground model in use (not input 1/1/2015)
  • C_GROUNDMODELCH_D2INP: DOE-2 model w/ user coeffs
  • C_GROUNDMODELCH_D2COR: DOE-2 model w/ correlation coeffs
sbcI.cTaDbAvgYr FLOAT_GEZ Start of run to annual avg taDb
sbcI.cTaDbAvg31 FLOAT_GEZ Start of run to last 31 day avg taDb
sbcI.cTaDbAvg14 FLOAT_GEZ Start of run to last 14 day avg taDb
sbcI.cTaDbAvg07 FLOAT_GEZ Start of run to last 7 day avg taDb
sbcI.cTGrnd FLOAT_GEZ Start of run to computed ground temp
sbcI.rGrnd FLOAT_GEZ Start of run resistance = 1/(sum of above) (0 if sum=0)
sbcI.rConGrnd FLOAT_GEZ Start of run
  • ground model implicit construction resistance, ft2-F/Btuh
  • = approx resistance of construction film/carpet/slab/soil
  • Caution: construction should be consistent with configuration
  • implicit in coefficient values.
sbcO outside (ambient or adjacent zone) surface boundary conditions
SBC
Name Type Variability Description/Comments
sbcO.absSlr number Start of monthly-hourly solar (SW) absorptance, dimless
sbcO.awAbsSlr DBL Start of monthly-hourly
  • area-weighted solar absorptance
  • = sb_absSlr * area / zn_surfASlr
  • exterior surf outside: always 0
  • windows inside: TBD 12-8-10
  • ducts: always 0
sbcO.epsLW number Start of run thermal (LW) emittance
sbcO.zi TI Start of run adjacent zone idx, 0 if exposed to ambient
sbcO.F DBL Start of run solar (short wave) fraction ? TODO: NOT USED? as of 4-2012
sbcO.Fp DBL Start of run
  • "view factor" to zone radiant temp, dimless. Includes Oppenheim surface conductance.
  • aka "F-prime" in CZM documentation.
Name Type Variability Description/Comments
sbcO.frRad DBL Start of run re radiant to radiant temp (room radiant node or sky)
sbcO.fSky DBL Start of run "view factor" to radiant surround at sky temp
sbcO.fAir DBL Start of run "view factor" to radiant surround at air temp (ground, horizon)
Name Type Variability Description/Comments
sbcO.hcNat FLOAT_GEZ End of subhour surface natural convection coefficient, Btuh/ft2-F
sbcO.hcFrc FLOAT_GEZ End of subhour surface forced (wind) convection coefficient, Btuh/ft2-F
sbcO.hcMult FLOAT_GEZ End of subhour surface convection coefficient multiplier, dimless
sbcO.hxa FLOAT_GEZ End of subhour overall coeff to sb_txa = sb_hcMult*(sb_hcNat + sb_hcFrc), Btuh/ft2-F
sbcO.hxr FLOAT_GEZ End of subhour
  • surface (linearized) radiative coefficient, Btuh/ft2-F
  • = coupling to sb_txr
sbcO.hxtot number End of subhour sb_hxa + sb_hxr
sbcO.uRat DBL End of subhour
  • ratio uC/(sb_hxa + sb_hxr + uC)
  • = 1/(1 + rC*(sb_hxa + sb_hxr))
  • where uC = surface-to-surface conductance
  • rC = 1/uC
  • but: duct model outside surf to duct air
Name Type Variability Description/Comments
sbcO.fRat DBL End of subhour
  • sb_hxtot * sb_uRat, Btuh/ft2-F
  • = overall conductance not including other side
  • surface resistances
  • (ducts: overall conductance from duct air to sb_txe)
sbcO.cx DBL End of subhour air/radiant coupling due to this surface, Btuh/ft2-F
Name Type Variability Description/Comments
sbcO.sgTarg solar gain target: bm, df gain from insolation
SGTARG
Name Type Variability Description/Comments
sbcO.sgTarg.bm DBL End of subhour beam
sbcO.sgTarg.df DBL End of subhour diffuse
sbcO.sgTarg.tot DBL End of subhour total
sbcO.sg DBL End of subhour absorbed solar total, Btuh (NOT Btuh/ft2), summed from sb_sgTarg
Name Type Variability Description/Comments
sbcO.tSrf number End of subhour most recently calculated surface temp, F
sbcO.tSrfls number Start of subhour
  • last step surface temp, F
  • copied from sb_tSrf at step end
  • not *e (available for probing)
sbcO.qrAbs DBL End of subhour
  • total absorbed radiant heat gain at surface, Btuh/ft2 (+ = into surface)
  • = (sb_sg + sb_rIg)/area
sbcO.txa number End of subhour
  • adjacent air temp, F (from prior step)
  • inside: prior step zone tz
  • outside: current step ambient dry bulb temp
sbcO.txr number End of subhour
  • adjacent radiant temp, F
  • inside: prior step zone tr
  • outside: current step sky temp
sbcO.txe number End of subhour
  • adjacent environmental temp, F
  • combined sb_txa and sb_txr; simplifies calcs in some cases
  • set but unused? for inside
  • set/used for ASHWAT outside
sbcO.w DBL End of subhour
  • adjacent air humidity ratio if known (else 0)
  • used re duct leakage
sbcO.qSrf DBL End of subhour
  • conduction into surface, Btuh/ft2
  • updated at end of timestep
Name Type Variability Description/Comments
sbcO.pXS XSURFP Start of run parent pointer
sbcO.si number Start of run
  • side of *sb_pXS represented by this SBC
  • 0=inside, 1=outside
sbcO.fcWind DBL Start of run
  • wind constant re sb_hcFrc (includes roughness, unit conversion, height adj, ...)
  • value is model specific
  • Walton: sb_hcFrc = sb_fcWind * Top.windSpeedSqrtSh
  • Unified: sb_hcFrc = sb_fcWind * Top.windSpeedPt8
sbcO.fcWind2 DBL Start of run unified: add'l constant re sb_eta
sbcO.eta DBL End of subhour
  • unified: wind speed adjustment included in sb_hcNat
  • windV=0: sb_eta=1, sb_hcNat=still-air value
  • windv>0: sb_eta<1, sb_hcNat is reduced
  • characteristic dimensions re convection models
  • not always set or used
  • Note: may be derived from parent surface TODO
Name Type Variability Description/Comments
sbcO.widNom DBL Start of run nominal width, ft (smaller dimension assuming rectangle)
sbcO.lenNom DBL Start of run nominal length, ft (larger dimension assuming rectangle)
sbcO.lenCharNat DBL Start of run characteristic length for some natural convection models, ft
sbcO.lenEffWink DBL Start of run effective length for Winkelmann forced convection model, ft
Name Type Variability Description/Comments
sbcO.cosTilt DBL Start of run
  • cos( Tilt ) for the boundary -- note parent surface tilt is defined
  • relative to outside normal (sbcO), so inside sb_cosTilt is oposite (+180 deg)
sbcO.atvDeg DBL Start of run angle-to-vertical, deg (inside: 90-tilt; outside: tilt-90)
sbcO.cosAtv DBL Start of run cos( angle to vertical) 0 - 1 (never < 0)
sbcO.hcModel choice:CONVMODEL Start of run
  • surface convective coefficient model
  • specifies calc method sb_hcNat and sb_hcFrc
sbcO.hcLChar number Start of run
  • characteristic length, ft
  • used in derivation of exterior forced convective coeff
  • default = 10 ft
  • unused re natural convective coeff (interior or exterior)
sbcO.hcConst[index] DBL Array [3] Start of run
  • convection coefficient model constants
  • Unified: exposure to zone or ambient
  • hcNat = sb_hcConst[]*abs( TD)^.33)
  • [ 0]: tAir<=tSrf, [ 1]: tAir>tSrf
  • [ 2]: unused
  • ASHRAE: exposure to zone, hcNat = sb_hcConst[]
  • [ 0]: sys off, tAir<=tSrf, [ 1]: sys off, tAir>tSrf
  • [ 2]: sys on
  • re [sfExCnd][sfexcnd] = GROUND: conductances to weather vars, Btuh/ft2-F
  • correlation values derived by Bazjanac/Huang for various
  • insulation configurations
Name Type Variability Description/Comments
sbcO.groundModel choice:GROUNDMODEL Start of run
  • ground model in use (not input 1/1/2015)
  • C_GROUNDMODELCH_D2INP: DOE-2 model w/ user coeffs
  • C_GROUNDMODELCH_D2COR: DOE-2 model w/ correlation coeffs
sbcO.cTaDbAvgYr FLOAT_GEZ Start of run to annual avg taDb
sbcO.cTaDbAvg31 FLOAT_GEZ Start of run to last 31 day avg taDb
sbcO.cTaDbAvg14 FLOAT_GEZ Start of run to last 14 day avg taDb
sbcO.cTaDbAvg07 FLOAT_GEZ Start of run to last 7 day avg taDb
sbcO.cTGrnd FLOAT_GEZ Start of run to computed ground temp
sbcO.rGrnd FLOAT_GEZ Start of run resistance = 1/(sum of above) (0 if sum=0)
sbcO.rConGrnd FLOAT_GEZ Start of run
  • ground model implicit construction resistance, ft2-F/Btuh
  • = approx resistance of construction film/carpet/slab/soil
  • Caution: construction should be consistent with configuration
  • implicit in coefficient values.
Name Type Variability Description/Comments
fenModel choice:FENMODEL input time fenestration model: user input
SHGC number input time rated SHGC of assembly
fMult FLOAT_GEZ Start of run window frame/mullion multiplier (input or from GT)
UNFRC UH_GZ input time overall U-factor evaluated under per NFRC heating conditions
NGlz number input time # of glazings bare-glass assembly
exShd choice:EXSHD input time exterior shade (ASHWAT only)
inShd choice:INSHD input time interior shade (ditto)
dirtLoss FLOAT_GEZ Start of run window dirt loss factor (input or from GT)

next 3 are input for surface, copied from surface of door or window

Name Type Variability Description/Comments
sfExCnd choice:EXCND Start of run adjacent cond: adiabatic/ambient/specT/adjZn.
sfExT TEMP Start of subhour outside temp if .sfExCnd==C_EXCNDCH_SPECT
sfAdjZi TI input time zone for sfExCnd==ADJZN, or 0 for exterior surface/door/window.
uI UH_GZ Start of run interior surf (air film) conductance. input.
uC UH_GZ Start of run uval of construction, excl surfaces (air films). From CON, GT, or SFI.sfU user input.
uX UH_GZ Start of run exterior surface (air film) conductance. input.
Rf number Start of run
  • exterior roughness factor, re convection (new 10-10)
  • default: windows=1, all others=2.17
grndRefl number Start of monthly-hourly ground reflectivity, default: wall: Top.grndRefl; door/win: owning wall.

view factors for diffuse (only) radiation so user can precompute shading effects of window overhang/fins

Name Type Variability Description/Comments
vfSkyDf number Start of monthly-hourly sky view factor for diffuse solar, default .5 + .5*cos(tilt)
vfGrndDf number Start of monthly-hourly ground view factor for diffuse solar, default .5 - .5*cos(tilt)

view factors re outside surface LW (thermal) radiant exchange

Name Type Variability Description/Comments
vfSkyLW number Start of run sky view factor for long-wave radiation, hard-coded .5 + .5*cos( tilt)
vfGrndLW number Start of run ground view factor for long-wave radiation, hard-coded .5 - .5*cos( tilt)
Name Type Variability Description/Comments
uval UH_GZ Start of run
  • Overall air-to-air conductance, Btuh/sf-F
  • includes uX and uC surf cond
  • *Nominal* U-factor etc including ASHRAE heating surface resistance
  • documentation only!
Name Type Variability Description/Comments
UNom UH_GZ Start of run nominal air-to-air U-factor, Btuh/sf-F
UANom UA Start of run
  • area * xs_UNom, Btuh/F
  • surface values, [0]=inside, [1]=outside
rSrfNom[index] number Array [2] Start of run surface resistance sf-F/Btuh
hSrfNom[index] number Array [2] Start of run surface conductance (1/xs_rSrfNom), Btuh/sf-F
Name Type Variability Description/Comments
cFctr UH_GZ Start of run surface-to-surface conductance (not populated!)
Name Type Variability Description/Comments
iwshad TI Start of run 0 if none or subscr in WSHADRAT of overhang/fin info for a shaded window
msi TI Start of run 0, or mass (MsR) subscript for CTMXWALL.
tLrB[index] number Array [XSMXTLRB] End of hour
  • layer boundary temps re probes
  • populated at end of hour

solar gain distributions: [partly] based on SGDIST inputs

Name Type Variability Description/Comments
nsgdist number Start of run
  • Number of SG distributions
  • [SGDIST][sgdist] sgdist[ HSMXSGDIST]:
sgdist[index] Array [HSMXSGDIST]
  • =8 (2-95), cndefns.h. explicit solar gain distribs
  • *r -> min variation here: no members set at input time
  • *nest [SGDIST][sgdist] sgdist -> solar gain distribution (struct just above). set: cncult3.cpp:cnuSgDist().
SGDIST
Name Type Variability Description/Comments
sgdist[index].targTy number Start of run
  • target type: define (cnguts.h) basAnc & member
  • zone air SGDTTZNAIR ZNR.qSgAir
  • (zone check/results total SGDTTZNTOT ZNR.qSgTot/qSgTotSh (not here; gen'd in cgsolar 2-95)
  • surface in/outside SGDTSURFI/O
sgdist[index].targTi TI Start of run subscript of targeted entry in RAT above: *i in SGI; *nest merges variation flags.
sgdist[index].FSO number Start of monthly-hourly frac of gain to target, shades open
sgdist[index].FSC number Start of monthly-hourly frac of gain to target, shades closed (defaults to sgd_FSO)
  • surface/door/window
  • .ownTi (base class) is zone for surface, or surface for window or door.
  • CAUTION: ambiguous base
Name Type Variability Description/Comments
sfClass number input time sfcNUL, sfcSURF, sfcDOOR, sfcWINDOW
sfArea AREA_GZ input time surface: gross area, net in x.xs_area.
sfU UH_GZ input time
  • uval input if no [sfCon][sfcon] given (excl surf films)
  • [sfInH][sfinh], [sfExH][sfexh]: input/default to x.uI, x.uX.
sfCon TI input time
  • surface construction (optional)
  • [sfInAbs][sfinabs], [sfExAbs][sfexabs]: input/default to x.xs_AbsSlr(0, 1)
  • surface only
sfTy choice:OSTY constant wall/floor/ceil/[intmass1/2]: for input cking.
sfFnd TI input time surface foundation object (floors only, optional)
sfFndFloor TI input time surface foundation floor object (walls only, optional)
sfExpPerim LEN input time
  • foundation floor exposed perimeter (floors only)
  • window only
width LEN_GZ input time width and height: used to compute shading,
height LEN_GZ input time ... and to compute area b4 mutliplier.
mult FLOAT_GZ input time
  • area multiplier (for multiple identical windows)
  • derived/internal
xi TI Start of run subscript in runtime XSRAT, to facilitate access by probers 1-92
msi TI Start of run
  • 0 or MSRAT MsR subscr which will be used if delayed model
  • (must be known eg for sgdists b4 MsR record can be made eg because net area must be known)