honeybee_plus.surfacetype module

Honeybee surface types (e.g. wall, roof, etc.).

class honeybee_plus.surfacetype.AirWall[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Air wall.

Virtual wall to define zones inside a space. AirWalls don’t exist in reality.

radiance_material = void glass generic_glass 0 0 4 1.0885814378404746 1.0885814378404746 1.0885814378404746 1.52

Default Radiance material.

typeId = 4

Surface type id.

class honeybee_plus.surfacetype.Ceiling[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Ceiling.

radiance_material = void plastic generic_ceiling 0 0 5 0.8 0.8 0.8 0.0 0.0

Default Radiance material.

typeId = 3

Surface type id.

class honeybee_plus.surfacetype.Context[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Context surfaces.

radiance_material = void plastic generic_shading 0 0 5 0.35 0.35 0.35 0.0 0.0

Default Radiance material.

typeId = 6

Surface type id.

class honeybee_plus.surfacetype.ExposedFloor[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Exposed Floor.

Part of the floor/slab the is cantilevered.

radiance_material = void plastic generic_floor 0 0 5 0.2 0.2 0.2 0.0 0.0

Default Radiance material.

typeId = 2.75

Surface type id.

class honeybee_plus.surfacetype.Floor[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Floor.

radiance_material = void plastic generic_floor 0 0 5 0.2 0.2 0.2 0.0 0.0

Default Radiance material.

typeId = 2.0

Surface type id.

class honeybee_plus.surfacetype.Roof[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Roof.

radiance_material = void plastic generic_roof 0 0 5 0.8 0.8 0.8 0.0 0.0

Default Radiance material.

typeId = 1.0

Surface type id.

class honeybee_plus.surfacetype.SlabOnGrade[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Slab on Grade.

Any floor that is touching the ground. z=0

radiance_material = void plastic generic_floor 0 0 5 0.2 0.2 0.2 0.0 0.0

Default Radiance material.

typeId = 2.5

Surface type id.

class honeybee_plus.surfacetype.SurfaceTypeBase[source]

Bases: object

Base class for surface types.

ToString()[source]

Overwrite .NET ToString method.

energyPlusConstruction = None

Default EnergyPlus Construction.

isSurfaceType()[source]

Return True for surface types.

radiance_material = None

Default Radiance material.

typeId = -1

Surface type id.

class honeybee_plus.surfacetype.SurfaceTypes[source]

Bases: object

Collection of surface types.

0.0: Wall, 0.5: UndergroundWall, 1.0: Roof, 1.5: UndergroundCeiling, 2.0: Floor, 2.25: UndergroundSlab, 2.5: SlabOnGrade, 2.75: ExposedFloor, 3.0: Ceiling, 4.0: AirWall, 5.0: Window, 6.0: Context

classmethod by_normal_angle_and_points(normal_angle, points=[])[source]

Get surface type based on surface normal angle to Z axis.

Parameters
  • normal_angle – Angle between surface normal and z axis in degrees.

  • points – List of surface points. If not provided the base type will be returned.

Returns

Surface type as SurfaceTypeBase object.

static get_base_type_by_normal_angle(angle_to_z_axis, maximum_roof_angle=30)[source]

Get based type of the surface.

This method does calculte base methods as wall,roof and floor

Parameters

angle_to_z_axis – Angle between surface normal and z_axis in degrees.

Returns

Wall, 1: Roof, 2: Floor

Return type

An integer between 0-2 0

classmethod get_type_by_key(key)[source]

Return type based on key value.

Parameters

key – 0.0: Wall, 0.5: UndergroundWall, 1.0: Roof, 1.5: UndergroundCeiling, 2.0: Floor, 2.25: UndergroundSlab, 2.5: SlabOnGrade, 2.75: ExposedFloor, 3.0: Ceiling, 4.0: AirWall, 5.0: Window, 6.0: Context

Usage:

srf_type = SurfaceTypes.get_type_by_key(6)

static is_surface_on_ground(pts)[source]

Check if this surface is on the ground.

static is_surface_underground(pts)[source]

Check if this surface is underground.

re_evaluate_surface_type(base_surface_type, pts)[source]

Re-evaluate base type for special types.

class honeybee_plus.surfacetype.UndergroundCeiling[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Underground Ceiling.

radiance_material = void plastic generic_wall 0 0 5 0.5 0.5 0.5 0.0 0.0

Default Radiance material.

typeId = 1.5

Surface type id.

class honeybee_plus.surfacetype.UndergroundSlab[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Underground slab.

Any floor that is located under ground (z < 0)

radiance_material = void plastic generic_floor 0 0 5 0.2 0.2 0.2 0.0 0.0

Default Radiance material.

typeId = 2.25

Surface type id.

class honeybee_plus.surfacetype.UndergroundWall[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Underground wall.

radiance_material = void plastic generic_wall 0 0 5 0.5 0.5 0.5 0.0 0.0

Default Radiance material.

typeId = 0.5

Surface type id.

class honeybee_plus.surfacetype.Wall[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Wall.

radiance_material = void plastic generic_wall 0 0 5 0.5 0.5 0.5 0.0 0.0

Default Radiance material.

typeId = 0.0

Surface type id.

class honeybee_plus.surfacetype.Window[source]

Bases: honeybee_plus.surfacetype.SurfaceTypeBase

Window surfaces.

radiance_material = void glass generic_glass 0 0 4 0.6540474888954341 0.6540474888954341 0.6540474888954341 1.52

Default Radiance material.

typeId = 5

Surface type id.