climate

Functions to estimate the soil temperature.

compute_soil_temperature(ta, alpha=0.015168539325842695, depth=1.0)[source]

Computes the annual soil temperature according to the model in:

Robinson, Darren. “Climate as a pre-design tool.” BS2003: Eighth International IBPSA (2003).

The default value of thermal diffusivity in m²/day is taken as the default CitySim value, which is the value for clay foundi in (Arya, 2001).

Parameters:
  • ta (Array) – Array containing the hourly air temperature in °C over a whole year.

  • alpha (float, optional) – Thermal diffusivity of the soil (m²/day). The default is 0.015168539325842695.

  • depth (float, optional) – Depth at which the temperature is computed (m). The default is 1.

Returns:

soil_temp – Hourly soil temperature at the specified depth for a whole year. The temperature remains constant within a single day

Return type:

Array