Green City Library Help

Ground

Symbol

GroundICON.png

Use

The component enables the user to calculate the soil temperature in a specific depth depending on the following soil parameters:

  • DayOfYear: 0 .. 365/366 - simulated time during the year in days (+1d in case of a leap year)

  • LeapYear: true/false - current year is a leap year

  • cGround: specific heat capacity of soil

  • lambdaGround: thermal conductivity of soil

  • rhoGround: density of soil

  • GeoGradiant: geothermal gradiant

  • alphaAirGround: heat transmission coefficient between soil and air

  • TAmbientAverage: average annual air temperature

  • TAmbientMax: maximum average monthly air temperature

  • MaxMonth: 1 .. 12 - January = 1 .. December = 12 - month of year with maximum average monthly air temperature

More details about the theoretical background of the model provides the Model Background.

Parameters and Connectors

The ground component actually has only one parameter, i.e., the average ground depth for which the ground temperature has to be calculated.

GroundParameterDialog.png

However, most of the model's required parameters defines the Environment model and transfers the data via the ▶EnvironmentConditions bus.

EnvironmentParameterDialog_Ground.png

The model has only two interfaces:

  • EnvironmentConditions: bus connector to the Environment model

  • TGround: soil temperature output

Model Background

This model calculates the average soil temperature depending on a simple sine function which takes into account the currently simulated season as well as some location-specific soil temperatures:

Model_Background_Equation.png

This results in characteristic curves for different months regarding different depths of soil:

Ground_Temperature_Background.png
26 September 2025