API Reference site

site

Passive-House Style Monthly Climate Data

Source: honeybee_ph/site.py


Climate_MonthlyValueSet

A set of 12 monthly climate values (temperature, radiation, etc.).

Inherits from: _base._Base

Attributes

AttributeTypeDescription
values

Properties

PropertyTypeDescription
valuesList[float]

Climate_MonthlyTempCollection

Collection of monthly temperature data sets.

Inherits from: _base._Base

Attributes

AttributeTypeDescription
air_tempsMonthly air temperatures in degrees C.
dewpointsMonthly dewpoint temperatures in degrees C.
sky_tempsMonthly sky temperatures in degrees C.
ground_tempsMonthly ground temperatures in degrees C.

Climate_MonthlyRadiationCollection

Collection of monthly solar radiation data by orientation.

Inherits from: _base._Base

Attributes

AttributeTypeDescription
northMonthly north-facing radiation in kWh/m2.
eastMonthly east-facing radiation in kWh/m2.
southMonthly south-facing radiation in kWh/m2.
westMonthly west-facing radiation in kWh/m2.
globMonthly global horizontal radiation in kWh/m2.

Climate_PeakLoadValueSet

A set of peak load climate data for a single design condition.

Inherits from: _base._Base

Attributes

AttributeTypeDescription
tempDesign temperature in degrees C.
rad_northNorth-facing radiation in W/m2.
rad_eastEast-facing radiation in W/m2.
rad_southSouth-facing radiation in W/m2.
rad_westWest-facing radiation in W/m2.
rad_globalGlobal horizontal radiation in W/m2.
dewpointDewpoint temperature in degrees C.
sky_tempSky temperature in degrees C.
ground_tempGround temperature in degrees C.

Climate_PeakLoadCollection

Collection of peak heating and cooling load design conditions.

Inherits from: _base._Base

Attributes

AttributeTypeDescription
heat_load_1Primary heating design condition.
heat_load_2Secondary heating design condition.
cooling_load_1Primary cooling design condition.
cooling_load_2Secondary cooling design condition.

Climate_Ground

Ground thermal properties for foundation heat loss calculations.

Inherits from: _base._Base

Attributes

AttributeTypeDescription
ground_thermal_conductivityintThermal conductivity in W/(mK). Default: 2.
ground_heat_capacityintSpecific heat capacity in J/(kgK). Default: 1000.
ground_densityintDensity in kg/m3. Default: 2000.
depth_groundwaterintDepth to groundwater table in meters. Default: 3.
flow_rate_groundwaterfloatGroundwater flow rate in m/day. Default: 0.05.

Climate

Complete climate dataset for PH energy modeling.

Inherits from: _base._Base

Attributes

AttributeTypeDescription
display_name
station_elevationWeather station elevation in meters.
summer_daily_temperature_swingDaily temperature swing in K. Default: 8.0.
average_wind_speedAverage wind speed in m/s. Default: 4.0.
groundClimate_GroundGround thermal properties.
monthly_tempsMonthly temperature data.
monthly_radiationMonthly radiation data.
peak_loadsPeak load design conditions.

Location

Geographic location data for the building site.

Inherits from: _base._Base

Attributes

AttributeTypeDescription
latitudeSite latitude in decimal degrees. Default: 40.6.
longitudeSite longitude in decimal degrees. Default: -73.8.
site_elevationSite elevation in meters above sea level.
climate_zoneASHRAE climate zone number. Default: 1.
hours_from_UTCTime zone offset from UTC in hours. Default: -4.

PHPPCodes

PHPP climate library reference codes.

Inherits from: _base._Base

Attributes

AttributeTypeDescription
country_codePHPP country code string. Default: “US-United States of America”.
region_codePHPP region code string. Default: “New York”.
dataset_namePHPP dataset identifier. Default: “US0055c-New York”.

Site

Complete site data combining location, climate, and PHPP library codes.

Inherits from: _base._Base

Attributes

AttributeTypeDescription
locationGeographic location data.
climateClimate dataset for energy modeling.
phpp_library_codesPHPP climate library reference codes.