top
TOP: user inputs (& some derived): overall control
| Name |
Type |
Variability |
Description/Comments |
| bAutoSizeCmd |
BOO |
input time |
- non-0 if any [AUTOSIZE][autosize] commands seen in input, set via arg to cul() from cse.cpp. 6-95.
- both FALSE for input check only:
|
| chAutoSize |
choice:NOYES |
Start of run |
whether to do autosizing, default per bAutoSizeCmd |
| chSimulate |
choice:NOYES |
input time |
- whether to do main simulation, default TRUE, can input FALSE for autosizing only. 6-95.
- runtime phase: see .autoSizing below.
|
| begDay |
DOY |
input time |
1st 1-based Julian day of year of run |
| endDay |
DOY |
input time |
last ditto, inclusive |
| nDays |
number |
Start of run |
derived: # days in run |
| jan1DoW |
choice:DOW |
input time |
January 1 day of week, sun=1 SUBTRACT 1 FOR MOST INTERNAL USES |
| year |
number |
Start of run |
derived: tdpak generic non-leap year, -1 = jan 1 is Monday ... -7 = jan 1 is Sunday. |
| wuDays |
SI_GEZ |
input time |
number of warmUp days |
| nSubSteps |
SI_GZ |
input time |
- # subhours per hour, determines subhour duration.
- typically 4 for (old) ZNMODELCH_CNE (combined coefficent) models
- 5 - 30 for convective/radiant models
- some models require substep duration to be integral minutes (e.g. HPWH)
- see tp_SetCheckTimesteps()
|
TOP: inputs: location/air properties/ground properties
| Name |
Type |
Variability |
Description/Comments |
| wfName |
CULSTR |
Start of phase |
weather file path string |
| TDVfName |
CULSTR |
Start of phase |
TDV (time dependent value) file path string |
| elevation |
LEN |
Start of run |
site elevation (for determining air density) (ft). defaults from weather file 1-95. |
| refTemp |
TEMP |
Start of phase |
temp for computing the hum ratio (w) used in air-density calculations, default 70 F |
| refRH |
FRAC_GZ |
Start of phase |
relative humidity (as fraction) ditto, default .6 (60%). |
ground properties
| Name |
Type |
Variability |
Description/Comments |
| grndRefl |
number |
Start of monthly-hourly |
- ground surface reflectivity, re solar gain.
- dflt .2. Used: cgsolar.cpp and Kiva. [wnGrndRefl][wngrndrefl] Overrides.
|
| grndEmit |
number |
input time |
ground surface emittance, re long wave exchange in Kiva. dflt .8. |
| grndRf |
number |
input time |
ground surface roughnes, ft, re exterior convection in Kiva. dflt 0.1. |
| soilDiff |
FLOAT_GZ |
input time |
- local soil diffusivity, ft2/hr, re annual deep ground temp cycle estimation
- see CalcGroundTemp(). dflt=0.025.
|
| soilCond |
FLOAT_GZ |
input time |
local soil conductivity, Btuh-ft/ft2-F, re Kiva calcs. dflt=1.0. |
| soilSpHt |
FLOAT_GZ |
input time |
local soil specific heat, Btu/lb-F, re Kiva calcs. dflt=0.1. |
| soilDens |
FLOAT_GZ |
input time |
local soil density, lb/ft3, re Kiva calcs. dflt=115. |
| farFieldWidth |
FLOAT_GZ |
input time |
far-field boundary distance, ft, re Kiva calcs. dflt=130. |
| deepGrndCnd |
choice:DG |
input time |
- deep ground boundary type
- C_DGCH_WATERTABLE: Water Table
- C_DGCH_ZEROFLUX: Zero-Flux (default)
|
| deepGrndDepth |
FLOAT_GZ |
input time |
deep-ground boundary distance, ft, re Kiva calcs. dflt=130. |
| deepGrndT |
number |
input time |
deep-ground boundary temperature, F, re Kiva calcs. dflt=annual average db. |
TOP: inputs: check tolerances and precisions
| Name |
Type |
Variability |
Description/Comments |
| tol |
FLOAT_GZ |
input time |
(relative) tolerance used in many hvac calculations, default .001f or as changed |
| humTolF |
FRAC_GZ |
input time |
w change to consider as important as 1F temp re convergedness |
| ebTolMon |
FLOAT_GZ |
input time |
monthly tolerance |
| ebTolDay |
FLOAT_GZ |
input time |
daily .. |
| ebTolHour |
FLOAT_GZ |
input time |
hourly .. |
| ebTolSubhr |
FLOAT_GZ |
input time |
subhourly .. |
| unMetTzTol |
FLOAT_GEZ |
input time |
unmet zone air temp tolerance, F (default = 1 F) |
| unMetTzTolWarnHrs |
FLOAT_GEZ |
input time |
- unmet warning threshold, hr (default 150)
- Warning(s) issued when zone heating or cooling unmet tzTol hrs exceed threshold
|
TOP: inputs: Kiva calculation settings
| Name |
Type |
Variability |
Description/Comments |
| grndMinDim |
FLOAT_GZ |
input time |
minimum cell dimension in Kiva, ft, default .066f |
| grndMaxGrthCoeff |
FLOAT_GZ |
input time |
maximum cell growth in Kiva, default 1.5f |
| grndTimeStep |
choice:TS |
input time |
- Kiva time step
- C_TSCH_H: Hourly (default)
- C_TSCH_SH: Sub-hourly
|
- TOP: inputs: ASHWAT calculation trigger thresholds
- full ASHWAT calcs are performed when *any* of the following changes
- by the the trigger amount
- else prior results used
| Name |
Type |
Variability |
Description/Comments |
| AWTrigT |
FLOAT_GZ |
input time |
inside or outside environmental temperature, F (default = 1) |
| AWTrigSlr |
FLOAT_GZ |
input time |
incident solar, fraction (default = .05) |
| AWTrigH |
FLOAT_GZ |
input time |
total surface coefficient (conv+rad), fraction (default=.1) |
- TOP: inputs: AirNet convergence and error criteria
- a zone is deem converged iff
- AMFnet <= max( tolAbs, tolRel*AMFTot)
| Name |
Type |
Variability |
Description/Comments |
| ANTolAbs |
FLOAT_GZ |
input time |
absolute tolerance, lbm/sec, dflt=.00125 (about 1 cfm) |
| ANTolRel |
FLOAT_GZ |
input time |
relative tolerance, dflt = .0001 |
| ANPressWarn |
FLOAT_GZ |
input time |
AirNet pressure that triggers a warning, lb/ft2 |
| ANPressErr |
FLOAT_GZ |
input time |
AirNet pressure that triggers a run-ending error, lb/ft2 |
TOP: inputs: other
| Name |
Type |
Variability |
Description/Comments |
| bldgAzm |
ANGLE |
input time |
angle to add to all zone/surface azms |
| skyModel |
choice:SKYMOD |
input time |
sky model: C_.._ISO or _ANISO |
| skyModelLW |
choice:SKYMODLW |
input time |
long-wave sky model |
| exShadeModel |
choice:EXSHMODEL |
input time |
- exterior shading model (other than overhang/fins)
- C_EXSHMODELCH_NONE: none ([SHADEX][shadex] etc ignored)
- C_EXSHMODELCH_PENUMBRA: use Penumbra GPU calcs
|
| slrInterpMeth |
SLRINTERPMETH |
input time |
solar interpolation method |
| Name |
Type |
Variability |
Description/Comments |
| humMeth |
choice:HUMTH |
input time |
humidity calculation method: Rob (w = wa/wb) or Phil (central difference), 6-92 |
| dflExH |
UH_GZ |
input time |
default ext (air film) cond for os & gz. 2-91 |
| workDayMask |
USI |
input time |
- mask with bits set for "work" days, clear for "non-work" days, default Mon..Fri, 5-95.
- For $isWorkDay, and passed thru binres file to OPK eg for ET.
- bits: Sun=1,Mon=2,Tu=4,W=8,Th=16,F=32,Sat=64,holidays=128,
- heatDsnDay=256, coolDsnDays=512 (but no autosizing data in bin res file yet 6-95).
- CAUTION: hard-coded encoding MATCHES cncult.cpp default, ResfH.workDayMask,
- brfr.h:getWorkDayMask() default, opk\progr.h/cpp:ProGrSub::workDayMask.
|
| DT |
choice:NOYES |
input time |
YES (default) to enable daylight saving time |
| DTBegDay |
DOY |
Start of run |
Daylight saving start day, 1-365, default 1st Sun (Sun after 1st Sat?) in April |
| DTEndDay |
DOY |
Start of run |
Daylight saving end day, 1-365, defaulted by cncult2.cpp code to last Sun in October |
- wind speed adjustment, see cgwthr.cpp
- appl sees Top.[windF][windf] * max( wthrfile.wndSpd, Top.[windSpeedMin][windspeedmin]);
| Name |
Type |
Variability |
Description/Comments |
| windSpeedMin |
FLOAT_GEZ |
input time |
minimum, mph (default=.5) |
| windF |
FLOAT_GEZ |
input time |
factor (default=1) |
| terrainClass |
number |
input time |
terrain class (1-5) re wind speed adjustment |
| radBeamF |
FLOAT_GEZ |
input time |
Beam radiation fctr. appl sees ANISO( ) * radBeamF. cgwthr.cpp. |
| radDiffF |
FLOAT_GEZ |
input time |
Diffuse radiation fctr. appl sees ANISO( ) * radDiffF. |
| ventAvail |
VENTAVAILVC |
Start of hour |
- all-zone ventilation availability (default=C_VENTAVAILCH_WHOLEBLDG)
- C_VENTAVAILCH_NONE: none
- C_VENTAVAILCH_WHOLEBLDG: airnet windows / fans
- C_VENTAVAILCH_ZONAL: airnet windows / fans (controlled by zone)
- C_VENTAVAILCH_RSYSOAV: [RSYS][rsys] outside air vent (central mechanical)
|
| Name |
Type |
Variability |
Description/Comments |
| fVent |
number |
End of subhour |
- consensus whole building vent fraction (if not RSYSOAV)
- = fraction of full vent flow to use
- determined by zone that wants the least vent
- or -1 for zonal vent control
|
| Name |
Type |
Variability |
Description/Comments |
| hConvMod |
choice:NOYES |
Start of run |
- enable/disable convection convective coefficient pressure modification factor (tp_hConvF below)
- mostly for debugging.
|
| verbose |
number |
Start of phase |
- screen messages: autosizing: 0 none, 1 some (dflt?), 2-5 more
- -1: suppress progress messages ("Input", "Warmup", etc.) via setScreenQuiet()
|
| dbgPrintMask |
number |
Start of hour |
debug print mask, controls DbPrintf() etc., schedulable via std capabilities |
| dbgPrintMaskC |
number |
input time |
debug print mask constant portion (value known during setup) |
| dbgFlag |
number |
Start of subhour |
debug flag value for passing testing info to code; normally no effect |
| doCoverage |
choice:NOYES |
input time |
- track expression processing code coverage / report to log
- (testing/development aid)
|
TOP: inputs: autoSizing
| Name |
Type |
Variability |
Description/Comments |
| auszTol |
FRAC_GZ |
input time |
autosizing result tolerance, dfl .005 |
| heatDsTDbO |
TEMP |
Start of hour |
- heat design outdoor temp, dfl per ET1 wthr file hdr.
- Impl may be incomplete for non-constant.
|
| heatDsTWbO |
TEMP |
Start of hour |
heating design outdoor wetbulb temp, dfl for 70% RH @ heatDsTDbO. |
| coolDsMo[index] |
number Array [13] |
input time |
SI[13] cooling design month(s) 1-12 + 0 terminator. Default per ET1 wthr file hdr. |
| coolDsDay[index] |
DOY Array [13] |
input time |
DOY[13] design day(s) read from weather file + 0 terminator |
| coolDsCond[index] |
TI Array [13] |
input time |
TI[ 13] DESCOND idx(s) + 0 terminator |
TOP: inputs: reporting and exporting
| Name |
Type |
Variability |
Description/Comments |
| exePath |
CULSTR |
Start of run |
full path to current .exe |
| exeInfo |
CULSTR |
Start of run |
- info about current .exe (from header)
- build timestame, linker version, code size
|
| exeCodeSize |
number |
Start of run |
code size, bytes (from exe header) |
| progVersion |
CULSTR |
Start of run |
program version identifier as string (for probing); set from ::ProgVersion |
| HPWHVersion |
CULSTR |
Start of run |
Ecotope HPWH (heat pump water heater) model version |
| cmdLineArgs |
CULSTR |
Start of run |
- command line args for current input file
- updated during session if multiple input files specified on command line
|
| runSerial |
number |
input time |
run #, 000-999, per (future 11-91) status file (meanwhile, see cnguts:cnRunSerial 7-92). |
| runTitle |
CULSTR |
input time |
user text for report titles, footers, export title 11-22-91. |
| runDateTime |
CULSTR |
Start of run |
- run date & time string, set by cncult2.cpp:topStarPrf2(), used in reports & bin res file, 9-94.
- inputs for binary results files, for NREL, rob 11-93. *r cuz settable from cmd line switches.
|
| brs |
choice:NOYES |
Start of run |
YES to generate basic binary results file, default NO. From input file or cmd line switch. |
| brHrly |
choice:NOYES |
Start of run |
- YES to generate hourly binary results file, default NO. From input file or cmd line.
- brf and brfHrly are intended to be independent, except monthly-hourly averages
- in basic file may only be computed if brfHrly is also on, 11-20-93.
|
| brFileName |
CULSTR |
input time |
- file name for binary results, extension .brs and/or .bhr added. default: input file name.
- settable in DLL version only, only by command line switches. Default is file output (if brs/brHrly) only.
|
| brMem |
BOO |
Start of run |
Put binary results in Windows global memory and return handles; do not write file. |
| brDiscardable |
BOO |
Start of run |
Put binary results in discardable memory as well as file, return handles. overrides brfMem. |
TOP: inputs: report page formatting
| Name |
Type |
Variability |
Description/Comments |
| repHdrL |
CULSTR |
input time |
user-spec'd text for left end of report header line |
| repHdrR |
CULSTR |
input time |
.. right |
| repCpl |
number |
input time |
report characters per line |
| repLpp |
number |
input time |
total number of lines per page (paper size) |
| repTopM |
number |
input time |
top margin in lines; # newlines written above header |
| repBotM |
number |
input time |
bottom margin in lines; not actually output |
| repTestPfx |
CULSTR |
input time |
- prefix pre-pended to e.g. footer lines re hiding lines re automated testing
- "" for normal runs, "!" re 3-2010 test framework. new 3-28-10
|
TOP: setup: exterior (non-overhang/fin) shading
| Name |
Type |
Variability |
Description/Comments |
| exshNShade |
number |
Start of run |
# of shading surfaces in model |
| exshNRec |
number |
Start of run |
# of receiving surfaces in model (may also be shading) |
TOP: setup: location info from weather file. Uses include solar calculations. 1-95.
| Name |
Type |
Variability |
Description/Comments |
| latitude |
number |
Start of run |
degrees north |
| longitude |
number |
Start of run |
degress west |
| timeZone |
number |
Start of run |
- hours west (fraction ok)
- also [elevation][elevation] is above (user-inputtable).
|
- TOP: setup: air properties approximated @[elevation][elevation], [refTemp][reftemp], [refRH][refrh], set in cucult2:topPsychro().
- UNITS/FIELDS needed for floats for proper probe behavior ***
| Name |
Type |
Variability |
Description/Comments |
| presAtm |
number |
Start of run |
- nominal atmospheric pressure at Top.[elevation][elevation] (in Hg)
- (constant for simulation)
|
| refW |
HUMRAT_GZ |
Start of run |
- humidity ratio for [refTemp][reftemp], [refRH][refrh] (ratio)
- psyHumRat2( Top.[refTemp][reftemp], Top.[refRH][refrh]) dfl ~.0066
|
| refWX |
DBL |
Start of run |
1/(1.+rp_refW) |
| airSH |
SPECHEAT |
Start of run |
- air specific heat (Btu/lbDryAir-F) @ tp_refW
- .240 + .444*tp_refW dfl ~.24293
|
| airVK |
number |
Start of run |
- specific volume per temp(ft3/lb-F): multiply by abs temp.
- PsyRAir*(1.f+tp_refW/PsyMwRatio)/PsyPBar; dfl ~.02547
|
| airRhoK |
number |
Start of run |
- density*temp (lb-F/ft3): divide by abs temp to get density.
- 1/airVK. dfl ~39.25
|
| airVshK |
number |
Start of run |
- volumetric specific heat/temp (Btu/ft3-F): div by abs temp for heat capacity per ft3
- airRhoK*tp_airSH dfl ~9.535 NEEDS UNITS
|
| airXK |
number |
Start of run |
- divide by abs temp for specific heat of flow (Btuh/cfm-F)
- airVshK, times 60 to match time units. dfl ~572.1
|
| hConvF |
number |
Start of run |
- convective coefficient pressure modification factor
- =(.24 + .76*PresAtm/PresAtmSeaLevel)
- used in some surface transfer models, reduces convection as function of [elevation][elevation]
- source = ASHRAE 1199-RP Barnaby et al. 2004
- and: enthalpy/lb is airSh * absTemp + 1061 * w. (Btu/lb)
|
TOP: setup time: autosizing
| Name |
Type |
Variability |
Description/Comments |
| nDesDays |
number |
Start of run |
number of design days: 1 for heating + number of non-0 coolDsMo's. |
| auszSmTol |
FLOAT_GZ |
Start of run |
autosizing small tolerance, eg auszTol/10 (.001) |
| auszTol2 |
FLOAT_GZ |
Start of run |
half of given tolerance -- added to values; used in convergence tests. |
| auszHiTol2 |
FLOAT_GZ |
Start of run |
1 + half of tolerance, eg 1 + auszTol/2. |
TOP: setup time: reports info for this run
| Name |
Type |
Variability |
Description/Comments |
| vrSum |
number |
Start of run |
- vrh for Summary report (not written to as of 11/22/91)
- int VrErr vrh for ERR report... is not in Top... must be open for messages during Top init.
- int VrLog vrh for LOG report... ditto. open in case want to write to it during input.
- int VrInp vrh for INPut listing report ... ditto, is being written during input and thus Top init.
|
- TOP: runtime: reports info for this run
- Date-dependent report/exports, including all zone-specific reports, etc: ZEB, ZST, MTR, etc:
- cncult4.cpp makes DVRI record for each requested such report and generates unspool requests for it;
- cgresult.cpp generates text to active reports each interval using the following lists it generates daily:
- Reports/exports active today, ordered for subscripting by IVLCH-1, heads of .nextNow lists in DvrIB (next 6 items):
| Name |
Type |
Variability |
Description/Comments |
| dvriY |
TI |
Start of day |
0 or DvriB subscript of 1st rpFreq=YEAR report or export |
| dvriM |
TI |
Start of day |
.. MONTH report/export currently active |
| dvriD |
TI |
Start of day |
.. DAY report/export to write to today |
| dvriH |
TI |
Start of day |
.. Hourly .. |
| dvriS |
TI |
Start of day |
.. Subhourly .. |
| dvriHS |
TI |
Start of day |
- .. Hourly and Subhourly. A vr can only be in one list, so this list is
- checked at hourly and subhourly intervals in addition to -H or -S. */
|
| hrxFlg |
number |
Start of day |
nz if any hour reporting or exporting today: dvriH | -HS |
| shrxFlg |
number |
Start of day |
nz if any subhour reporting or exporting today: dvriS | -HS |
TOP: runtime: probe-able timing info
| Name |
Type |
Variability |
Description/Comments |
| tmrInput |
DBL |
End of day |
input processing time, sec |
| tmrAusz |
DBL |
End of day |
autosizing time, sec |
| tmrRun |
DBL |
End of day |
main simulation time, sec |
| tmrTotal |
DBL |
End of day |
total execution time (not including reports), sec |
| tmrAirNet |
DBL |
End of day |
add'l timers active iff DETAILED_TIMING |
| tmrAirNetSolve |
DBL |
End of day |
|
| tmrAWTot |
DBL |
End of day |
|
| tmrAWCalc |
DBL |
End of day |
|
| tmrCond |
DBL |
End of day |
|
| tmrKiva |
DBL |
End of day |
|
| tmrBC |
DBL |
End of day |
|
| tmrZone |
DBL |
End of day |
|
TOP: runtime: re subHour and sub-subhour (aka ticks)
| Name |
Type |
Variability |
Description/Comments |
| subhrDur |
number |
Start of run |
duration of subhour, hr (= 1/tp_nSubSteps) |
| nSubhrTicks |
SI_GZ |
Start of run |
- # of subhour ticks for e.g. HPWH simulation
- 1 per minute or as generalized
|
| tickDurMin |
DBL |
Start of run |
- duration of subhr tick, min
- = 1 min or as generalized
- used for e.g. HPWH simulation
|
| tickDurHr |
DBL |
Start of run |
duration of subhr tick, hr |
TOP: runtime: simulation date/time variables
| Name |
Type |
Variability |
Description/Comments |
| monStr |
CULSTR |
Unknown |
- Month being simulated
- autoSizing: "heating design day", or month for cooling.
|
| dateStr |
CULSTR |
Start of day |
- Date being simulated as string
- autoSizing: eg "heating design day" or "Jul cooling design day".
|
| date |
IDATE |
Start of day |
- Date: .month is 1-12, .mday 1-31, .wday 0-6. set/used: cnguts. used:cuparse;cgsolar;cgresult;cgenbal.
- autoSizing: cool: near-mid-month day as used for solar calcs; heat: Dec 21. jDay ditto.
|
| jDay |
DOY |
Start of day |
Day of year now simulating, 1..365. set: tp_MainSimI; used:cnguts;cuparse;cgwthr;cgsolar;cgresult. |
| xJDay |
DOY |
Start of day |
extended jDay: same for main sim, 512 heat autosizing, 529-540 cooling autosizing. |
| Name |
Type |
Variability |
Description/Comments |
| iHr |
number |
Start of hour |
Hour of day, 0-23. set/used: tp_MainSim() |
| iSubhr |
number |
Start of subhour |
subhour of hour being simulated, 0.. . set cnguts.cpp |
| shoy |
SHOY |
Start of subhour |
extended subhour of year, for reporting peaks: subhr + 4 * (hr + 24*xJDay). set/used: cnguts. |
| isDT |
BOO |
Start of hour |
- 1 if daylight saving time in effect, 0 if not. Unspecified time/date variables are daylight.
- Standard Time variables, for weather file interface and solar calcs. Note std time date changes an hour later than daylight.
|
| iHrST |
number |
Start of hour |
Standard time Hour of day now simulating, 0-23. set/used cnguts, used cgsolar.cpp. |
| jDayST |
DOY |
Start of hour |
Standard time day of year, 1..365. changes @ 1am -->*h. set/used cnguts, used cgsolar.cpp. |
TOP: autosizing phase/date variables
| Name |
Type |
Variability |
Description/Comments |
| autoSizing |
BOO |
Start of phase |
TRUE if setting up for or doing autosizing, 0 for main simulation setup/run |
| pass1 |
BOO |
Start of day |
TRUE autoSizing pass 1 (A or B) thru dsn days: find big-enuf sizes with open-ended models |
| pass1A |
BOO |
Start of day |
TRUE for pass 1A of each dsn day: use idealized const-supply-temp models |
| pass1B |
BOO |
Start of day |
TRUE for pass 1B of each dsn day: use real models |
| pass2 |
BOO |
Start of day |
TRUE autoSizing for pass 2 thru dsn days: determine loads, reduce oversize sizes. |
| sizing |
BOO |
Start of day |
TRUE when can increase sizes. eg FALSE during pass 2: warming up. |
| dsDayI |
number |
Start of day |
index of design day being simulated: 0 heat, 1-12 coolDsMo[..-1]. set in cnausz.cpp. 6-95. |
| dsDay |
number |
Start of day |
0 main sim, 1 heating autoSize design day, 2 cooling ausz |
| auszMon |
number |
Start of day |
cool design day month 1-12 or generic month 0 for heat. 6-95. |
TOP: runtime time/day classification
| Name |
Type |
Variability |
Description/Comments |
| ivl |
choice:IVL |
Start of subhour |
- interval now starting or ending (C_IVLCH_Y, _M, etc),
- doEndIvl/doBegIvl to doIvlExprs, doIvlAccum, mtr_Accum1, cgaccum, doIvlPrior, etc
|
| isBegOf |
choice:IVL |
Start of subhour |
0 or interval now starting (for exprssion eval) (C_IVLCH_Y, _M, etc; 0 except during expr eval) ... |
| isEndOf |
choice:IVL |
Start of subhour |
- ditto ending. ... set in cnguts.cpp, tested in cueval.cpp.
- autoSizing gets no end-month nor end-year unless caller sets isLastDay & does extra final rep 6-95.
|
| isBegRun |
BOO |
Start of subhour |
- 1st subhr of warmup, not set for run unless no warmup.
- autoSizing: true if 1st subr of 1st repetition of dsn day.
|
| isBegMainSim |
BOO |
Start of subhour |
1st subhr of main sim (not warmup, not autosize) |
| isFirstMon |
BOO |
Unknown |
- TRUE if 1st month of main sim. set: doBeg/EndIvl. used: doIvlAccum.
- ** autoSizing: moot; probably always on, depending how ivl comes out.
|
| isLastDay |
BOO |
Start of day |
- Last day of main sim
- ** autoSizing: only set if (poss future 7-95) caller sets & does extra last rep of dsn day,
- else end-month and end-year exprs, reports, etc skipped (all moot?).
- See comment in doEndIvl(). ******* Clarify this comment when get clear re final reps 6-95.
|
| isLastWarmupDay |
BOO |
Start of day |
- TRUE iff last day of main sim warmup. set: cgMainsimI. used: cgwthr.cpp. 1-95.
- autoSizing: not set; coding so moot.
|
| isBegHour |
BOO |
Start of subhour |
TRUE if subhour 0 of hour. set cnztu.cpp/cnguts.cpp, used cnguts.cpp, . |
| isEndHour |
BOO |
Start of subhour |
TRUE if last subhour of hour. set cnguts.cpp, used cnguts, cgresult.cpp. |
| isBegDay |
BOO |
Start of hour |
TRUE if hour 0. set: doBegIvl. used: doBegIvl,doIvlAccum; cgresult.cpp |
| isEndDay |
BOO |
Start of hour |
TRUE if hour 23. set: doBegIvl. used: doEndIvl,doIvlAccum; cgresult.cpp |
| isBegMonth |
BOO |
Start of day |
1st day of month/run/warmup or 1st rep of dsn day. |
| isEndMonth |
BOO |
Start of day |
- Mon/run, not warmup, last day.
- ** autoSizing: moot; only set if caller sets isLastDay & does final extra rep of dsn day.
|
| isSolarCalcDay |
BOO |
Start of day |
TRUE if 1st day of month/run or 1st rep of dsn day: do 24 hours of solar calcs today. cnguts. |
| isWarmup |
BOO |
Start of day |
- TRUE if main sim warmup. set/used: cgMainsimI. used: doBegIvl,doEndIvl,doIvlAccum,doIvlReports; exman,impf.
- autoSizing: keep moot for now; may be on except for (future 6-95) extra last day eg for reports.
|
| dowh |
number |
Start of day |
- autoSizing: 8 heat 9 cool, else 7 if observed holiday, else day of week 0-6, for $dowh.
- weekend/holiday flags for probes / $variables (ul/cuparse.cpp). Set in cnguts.cpp.
|
| isHoliday |
BOO |
Start of day |
TRUE on observed holiday: Monday after certain true holidays on weekend. Same as old isHoliObs, 7-92. |
| isHoliTrue |
BOO |
Start of day |
TRUE (non-0) on true date of holiday |
| isWeHol |
BOO |
Start of day |
weekend or holiday |
| isWeekend |
BOO |
Start of day |
Saturday or Sunday |
| isBegWeek |
BOO |
Start of day |
Non-WeHol after WeHol |
| isWeekday |
BOO |
Start of day |
Mon-Fri |
| isWorkDay |
BOO |
Start of day |
workday per Top.workDayMask (default Mon-Fri), 5-95 |
| isNonWorkDay |
BOO |
Start of day |
non-workDay ditto 5-95 |
| isBegWorkWeek |
BOO |
Start of day |
workday after non-workday ditto 5-95 |
- TOP: runtime: autosizing
- above: autoSizing, tp_dsDayI, tp_dsDay, auszMon.
| Name |
Type |
Variability |
Description/Comments |
| auszNotDone |
BOO |
Start of day |
combined results of autoSize pass endtests |
| auszDsDayItr |
number |
Start of day |
- current design day iteration (1 based)
- (0 when not autosizing)
|
| auszDsDayItrMax |
number |
Start of day |
design day iteration limit for current pass |
- irradiance. Weather file values are energy integrated over hour.
- program needs [both] interval average [and end-interval (subhour only)] values. SOLAVNEND.
- power (Btuh/ft2)===energy (Btu/ft2) for 1 hour.
| Name |
Type |
Variability |
Description/Comments |
| radBeamHrAv |
number |
Start of hour |
beam irradiance on tracking surface, hour energy = average power, from weather file |
| radDiffHrAv |
number |
Start of hour |
diffuse irradiance on horizontal surface, hour energy = average power, from weather file |
| radBeamShAv |
number |
Start of subhour |
.. current beam subhour average power, interpolated, Btuh/ft2 |
| radDiffShAv |
number |
Start of subhour |
.. current diffuse subhour power, interpolated by cgwthr.cpp, Btuh/ft2 |
other weather: weather file contains instantaneous values for END OF HOUR; program needs only end-interval values.
| Name |
Type |
Variability |
Description/Comments |
| tDbOHr |
TEMP |
Start of hour |
outdoor dry bulb temp at end of hour, from wthr file, deg F. |
| tDbOPvHr |
TEMP |
Start of hour |
.. previous hour (used to compute -HrAv and -Sh) |
| tDbOHrAv |
TEMP |
Start of hour |
.. average over hour (used re hourly masses, bin res files, $variable) |
| tDbOSh |
TEMP |
Start of subhour |
.. end subhour, interpolated (used re zone temp heat balance) |
| tDbOPvSh |
TEMP |
Start of subhour |
.. end previous subhr (used to compute -ShAv) |
| tDbOShAv |
TEMP |
Start of subhour |
.. average over subhour (used re subhourly masses) |
| tWbOHr |
TEMP |
Start of hour |
outdoor wet bulb temp at END OF hour, from wthr file wb depression, deg F. |
| tWbOPvHr |
TEMP |
Start of hour |
.. previous hour (used to compute -HrAv, -Sh) |
| tWbOHrAv |
TEMP |
Start of hour |
.. hour average (for $ variable) |
| tWbOSh |
TEMP |
Start of subhour |
.. end subhour, interpolated (used re zone temp heat balance) |
| tDpOHr |
TEMP |
Start of hour |
outdoor dew point temp at END OF hour, from wthr file |
| tDpOPvHr |
TEMP |
Start of hour |
.. previous hour (used to compute -HrAv) |
| tDpOHrAv |
TEMP |
Start of hour |
.. hour average |
| tDpOSh |
TEMP |
Start of subhour |
.. end subhour (derived from tDbOSh and wOSh) |
| tSkyHr |
TEMP |
Start of hour |
sky temperature, F |
| tSkyPvHr |
TEMP |
Start of hour |
.. previous hour (used to compute -Sh) |
| tSkySh |
TEMP |
Start of subhour |
.. end subhr, interpolated) |
| windSpeedHr |
number |
Start of hour |
- wind speed, mph, at end hour
- = Top.[windF][windf] * max( wthrfile.wndspd, Top.[windSpeedMin][windspeedmin]);
|
| windSpeedPvHr |
number |
Start of hour |
.. previous hour (used to compute -HrAv, -Sh) |
| windSpeedHrAv |
number |
Start of hour |
.. hour average (for $ variable) |
| windSpeedSh |
number |
Start of subhour |
.. end subhour, mph, interpolated: for $variable and .. |
| windSpeedSquaredSh |
number |
Start of subhour |
.. end subhour squared (re zone infiltration), mph^2 |
| windSpeedSqrtSh |
number |
Start of subhour |
.. end subhour sqrt (re outside surface convection), mph^.5 |
| windSpeedPt8Sh |
number |
Start of subhour |
.. end subhour ^.8 (re outside surface convection), mph^.8 |
| windDirDegHr |
number |
Start of hour |
wind direction at END HOUR from wthr file, degrees, 0=N, 90=E. (used for $variable) |
additional derived weather info
| Name |
Type |
Variability |
Description/Comments |
| wOHr |
HUMRAT_GZ |
Start of hour |
outdoor humidity ratio at end current hour, computed from tDbO and tWbO (used for $ variable) |
| wOPvHr |
HUMRAT_GZ |
Start of hour |
.. previous hour (used to compute -HrAv) |
| wOHrAv |
HUMRAT_GZ |
Start of hour |
.. hour average (for $ variable) |
| wOSh |
HUMRAT_GZ |
Start of subhour |
.. at end current subhour: used throughout zones and systems models in program |
| wOShChangeBase |
HUMRAT_GZ |
Start of subhour |
outdoor humidity ratio saved for tp_wOShChange detection |
| hOSh |
number |
Start of subhour |
outdoor enthalpy at end subhour. used at in AH::doEco, TOWERPLANT::towModel. 9-92. |
| airxOSh |
number |
Start of subhour |
air flow heat transfer @tDbOSh (vhc*60) (Btuh/cfm-F). |
| rhoMoistOSh |
number |
Start of subhour |
outdoor moist air density at end of subhour, lbm/ft3 |
| rhoDryOSh |
number |
Start of subhour |
outdoor dry air density at end of subhour, lbm/ft3 |
- TOP: runtime: iteration control flags
- each of the following is TRUE if the indicated class should be checKed for call-flagged or compute-flagged objects.
- used in cnztu.cpp:hvacIterSubhr; set anywhere individual object call- and compute- flags are set.
| Name |
Type |
Variability |
Description/Comments |
| wOShChange |
BOO |
Start of subhour |
TRUE iff non-negligible change in outdoor humidity ratio |
| iter |
number |
Start of subhour |
hvac terminal / air handler / plant iteration counter for cnztu.cpp:hvacIterSubhr. |
TOP: runtime: whole-building heating and cooling peaks
| Name |
Type |
Variability |
Description/Comments |
| qcPeak |
number |
Start of hour |
maximum cooling load for an hour for entire building. Negative (if not 0). |
| qcPeakH |
number |
Start of hour |
hour 1-24 of peak cooling load |
| qcPeakD |
number |
Start of hour |
day of month 1-31 of peak load |
| qcPeakM |
number |
Start of hour |
month 1-12 of peak load |
| qhPeak |
number |
Start of hour |
maximum heating load for entire building during an hour |
| qhPeakH |
number |
Start of hour |
hour 1-24 of peak heating load |
| qhPeakD |
number |
Start of hour |
day of month 1-31 of peak load |
| qhPeakM |
number |
Start of hour |
month 1-12 of peak load |
TOP: runtime: AIRNET solution
| Name |
Type |
Variability |
Description/Comments |
| airNetActive |
BOO |
Start of phase |
TRUE iff AirNet is active (calcs s/b done) |
| Name |
Type |
Variability |
Description/Comments |
| ck5aa5 |
number |
Start of run |
stuffed with 0x5aa5 from topCult for verifying initialization & matching versions |