# 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
```

## 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 TemperatureThis is the annual average value of soil surface temperature.

Amplitude of Soil Surface TemperatureThis is the difference between the maximum and minimum soil surface temperature of the whole year divided by two.

Phase Constant of Soil Surface TemperatureThis 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:

Documentation content copyright © 1996-2020 The Board of Trustees of the University of Illinois and the Regents of the University of California through the Ernest Orlando Lawrence Berkeley National Laboratory. All rights reserved. EnergyPlus is a trademark of the US Department of Energy.

This documentation is made available under the EnergyPlus Open Source License v1.0.