In order to use the CalcSoilSurfTemp program, a weather
data file is used. The entire year of weather data is used to
calculate parameters of the soil surface temperature.
The CalcSoilSurfTemp program is simple and requires only
two input fields: soil condition and soil surface condition.
First, the user will see the four following options in the
screen for the selection of the soil condition:
HEAVY AND SATURATED
HEAVY AND DAMP
HEAVY AND DRY
LIGHT AND DRY
Among them, the user should select the number corresponding
to the particular soil condition. This determines the thermal
diffusivity and thermal conductivity of the surrounding
soil.
After the selection of soil condition, the user should also
select the number corresponding to the condition of the ground
surface above the earth tube from the eight following
options:
BARE AND WET
BARE AND MOIST
BARE AND ARID
BARE AND DRY
COVERED AND WET
COVERED AND MOIST
COVERED AND ARID
COVERED AND DRY
This determines the absorption coefficient and the fraction
of evaporation rate of the ground surface.
Note that both soil condition and soil surface condition
are the average of the year - not a particular time period
within the year.
From this information and an analysis of the weather data,
the CalcSoilSurfTemp program calculates the annual average
soil surface temperature, the amplitude of soil surface
temperature, and the phase constant of soil surface
temperature. The user must then add these parameters as input
parameter into earth tube model in EnergyPlus.
Program Inputs[LINK]
In order to use the CalcSoilSurfTemp program, a weather data file is used. The entire year of weather data is used to calculate parameters of the soil surface temperature.
The CalcSoilSurfTemp program is simple and requires only two input fields: soil condition and soil surface condition. First, the user will see the four following options in the screen for the selection of the soil condition:
HEAVY AND SATURATED
HEAVY AND DAMP
HEAVY AND DRY
LIGHT AND DRY
Among them, the user should select the number corresponding to the particular soil condition. This determines the thermal diffusivity and thermal conductivity of the surrounding soil.
After the selection of soil condition, the user should also select the number corresponding to the condition of the ground surface above the earth tube from the eight following options:
BARE AND WET
BARE AND MOIST
BARE AND ARID
BARE AND DRY
COVERED AND WET
COVERED AND MOIST
COVERED AND ARID
COVERED AND DRY
This determines the absorption coefficient and the fraction of evaporation rate of the ground surface.
Note that both soil condition and soil surface condition are the average of the year - not a particular time period within the year.
From this information and an analysis of the weather data, the CalcSoilSurfTemp program calculates the annual average soil surface temperature, the amplitude of soil surface temperature, and the phase constant of soil surface temperature. The user must then add these parameters as input parameter into earth tube model in EnergyPlus.
Documentation content copyright © 1996-2026 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.