Weather Models

buildingmodel.models.climate.ground_temperature(climate_data, ground_diffusivity=8e-07, depth=0.5)[source]

Calculate the ground temperature using the air temperature

Uses the Kusuda model

Typical values of thermal diffusivity for various types of soils can be found in : Andújar Márquez, J. M., Martínez Bohórquez, M. Á., & Gómez Melgar, S. (2016). Ground thermal diffusivity calculation by direct soil temperature measurement. Application to very low enthalpy geothermal energy systems. Sensors, 16(3), 306.

Parameters:

  • climate_data (Dataframe) – a Dataframe containing air temperature

  • ground_diffusivity (float) – the thermal diffusivity of the soil in m²/s

  • depth (float) – the depth at which the ground temperature is to be estimated in meters

Returns:

DataFrame containing ground temperature

Return type:

Dataframe

buildingmodel.models.climate.run_models(climate_data, metadata, parameters)[source]

Runs all climate models

Parameters:

climate_data (DataFrame) – a Dataframe containing EPW climate data loaded by

:param buildingmodel.io.climate.load_data():

Returns:

DataFrame containing all necessary climate data

Return type:

Dataframe

buildingmodel.models.climate.sky_temperature(climate_data)[source]

Calculate the sky temperature using the air temperature, dew point temperature and sky cover

Based on EnergyPlus model.

Parameters:

  • climate_data (Dataframe) – a Dataframe containing dew point temperature, air temperature and opaque sky cover

  • data

  • latitude (float)

  • longitude (float)

Returns:

DataFrame containing sky temperature

Return type:

Dataframe

buildingmodel.models.climate.sun_position(climate_data, latitude, longitude)[source]

Calculate the height and azimuth of the sun for an array of time steps at a given latitude and longitude

Based on astronomy computations provided by the ephem package Uses the ephem.Observer and ephem.Sun classes.

Parameters:

  • climate_data (Dataframe) – a Dataframe with a DateTimeIndex for which the sun position is to be calculated

  • latitude (float)

  • longitude (float)

Returns:

DataFrame containing sun_height and sun_azimuth

Return type:

Dataframe