modelUndisturbedSoilTemperature
Information
This model provides a prescribed temperature boundary condition for buried objects, where the temperature is computed per the ASCE (1996) equation:
where:
Ts,z = ground temperature at depth z,
τ = annual period length (constant 365.25 days),
α = soil thermal diffusivity (assumed constant throughout the year),
t = time,
Tms = mean annual surface temperature,
As = temperature amplitude throughout the year (max - min),
tlag = phase lag of the surface temperature sinusoid
Corrections
Without correction, this model assumes that the surface temperature (depth = 0) is
equal to the air temperature, which is acceptable for most design calculations.
For more accurate calculation, this model provides methods to compensate for
the convective thermal resistance and the impact of surface cover.
The convective thermal resistance can be modeled as a virtual equivalent soil layer
by setting the flag useCon to true and specifying the
heat transfer coefficient hSur.
This correction would result in a larger delay and dampening of the
resulting sinusoid.
The impact of surface cover on soil temperature can be modeled using
n-factors by setting the flag useNFac to true and
specifying the thawing and freezing n-factors at the surface.
More information about n-factors correction can be found in the documentation
for
Buildings.BoundaryConditions.GroundTemperature.BaseClasses.surfaceTemperature.
Since n-factors incorporate the effect of surface convection,
both corrections would typically not be applied simultaneously.
References
ASCE (1996). Cold Regions Utilities Monograph. D.W. Smith, Technical Editor.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Units.SI.Length | dep | Depth | |
| Boolean | useNFac | false | = true, use n-factors to correct climatic constants |
| Real | nFacTha | 1 | Thawing n-factor (TAir > 0degC) |
| Real | nFacFre | 1 | Freezing n-factor (TAir <= 0degC) |
| Boolean | useCon | false | = true, includes convection between air and surface coupling |
| Real | hSur | 25 | Surface convective heat transfer coefficient |
| Buildings.HeatTransfer.Data.Soil.Generic | soiDat | Soil thermal properties | |
| ClimaticConstants.Generic | cliCon | Surface temperature climatic conditions |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Units.SI.Temperature | T | Undisturbed soil temperature at depth dep |
Revisions
-
March 17, 2021, by Baptiste Ravache:
First implementation.