Program Outputs[LINK]

As noted earlier, there are three output parameters and they are automatically saved in the CalcSoilSurfTemp.out file. The basic concept and description of three output parameters are as follows.

Annual Average Soil Surface Temperature

This is the annual average value of soil surface temperature.

Amplitude of Soil Surface Temperature

This is the difference between the maximum and minimum soil surface temperature of the whole year divided by two.

Phase Constant of Soil Surface Temperature

This is the time elapsed from the beginning of the year at which the soil surface temperature reaches the minimum value in the year.

These values are placed in the ZoneEarthTube object numeric fields (12, 13, 14) of similar names. The ZoneEarthTube IDD definition with these fields highlighted is included:

ZoneEarthtube,
  \min-fields 22
  \memo  Earth Tube is specified as a design level which is modified by a Schedule fraction, temperature difference and wind speed:
  \memo  Earthtube = Edesign * Fschedule * (A + B*|(Tzone-Todb)| + C*WindSpd + D * WindSpd**2)
  A1, \field Zone Name
  \required-field
  \type object-list
  \object-list ZoneNames
  A2, \field Schedule Name
  \required-field
  \type object-list
  \object-list ScheduleNames
  N1, \field Design Flow Rate
  \required-field
  \units m3/s
  \note  "Edesign" in Equation
  \type real
  \minimum 0
  N2, \field Minimum Zone Temperature when Cooling
  \required-field
  \note this is the indoor temperature below which the earth tube is shut off
  \units C
  \type real
  \minimum -100
  \maximum 100
  N3, \field Maximum Zone Temperature when Heating
  \required-field
  \note this is the indoor temperature above which the earth tube is shut off
  \units C
  \type real
  \minimum -100
  \maximum 100
  N4, \field Delta Temperature
  \required-field
  \note This is the temperature difference between indoor and outdoor below which the earth tube is shut off
  \units deltaC
  \type real
  \minimum 0
  A3, \field Earthtube Type
  \required-field
  \type choice
  \key Natural
  \key Intake
  \key Exhaust
  \default Natural
  N5, \field Fan Pressure Rise
  \required-field
  \note pressure rise across the fan
  \type real
  \units Pa
  \minimum 0
  \default 0
  N6, \field Fan Total Efficiency
  \required-field
  \type real
  \minimum> 0
  \default 1
  N7, \field Pipe Radius
  \required-field
  \units m
  \type real
  \minimum> 0
  \default 1
  N8, \field Pipe Thickness
  \required-field
  \units m
  \type real
  \minimum> 0
  \default 0.2
  N9, \field Pipe Length
  \required-field
  \units m
  \type real
  \minimum> 0
  \default 15
  N10, \field Pipe Thermal Conductivity
  \required-field
  \units W/m-K
  \type real
  \minimum> 0
  \default 200
  N11, \field Pipe Depth Under Ground Surface
  \required-field
  \units m
  \type real
  \minimum> 0
  \default 3
  A4, \field Soil Condition
  \required-field
  \type choice
  \key HeavyAndSaturated
  \key HeavyAndDamp
  \key HeavyAndDry
  \key LightAndDry
  \default HeavyAndDamp
  N12, \field Average Soil Surface Temperature
  \required-field
  \units C
  \type real
  \default 0
  N13, \field Amplitude of Soil Surface Temperature
  \required-field
  \units C
  \type real
  \minimum 0
  \default 0
  N14, \field Phase Constant of Soil Surface Temperature
  \required-field
  \units days
  \type real
  \minimum 0
  \default 0
  N15, \field Constant Term Flow Coefficient
  \required-field
  \note  "A" in Equation
  \type real
  \default 1
  N16, \field Temperature Term Flow Coefficient
  \required-field
  \note  "B" in Equation
  \type real
  \default 0
  N17, \field Velocity Term Flow Coefficient
  \required-field
  \note  "C" in Equation
  \type real
  \default 0
  N18; \field Velocity Squared Term Flow Coefficient
  \required-field
  \note  "D" in Equation
  \type real
  \default 0