VEGeometry

class iesve.VEGeometry

Bases: object

static centre_to_origin() → None

Centres the model on the grid origin (0,0).

static get_building_orientation() → float

Get building orientation

static get_construction() → str

Gets the construction ID of the opening.

Returns:

Construction ID. empty if none found

Return type:

str

static get_wwr() → float

Get the model’s window-to-wall ratio

static reduce_ext_windows(max_wwr: float) → None

Reduce external windows so that the max window-to-wall ratio is not exceeded

Parameters:

max_wwr (float) – Max window-to-wall ratio

static remove_doors(flag: int, opening_area: float) → None

Remove doors from the model.

Parameters:

• flag (int) – 0 = all, 1 = internal, 2 = external

• opening_area (float) – Opening area threshold, all doors with an area below this threshold are removed. If 0.0, removes all doors

static remove_holes(flag: int, opening_area: float) → None

Remove doors from the model.

Parameters:

• flag (int) – 0 = all, 1 = internal, 2 = external

• opening_area (float) – Opening area threshold, all holes with an area below this threshold are removed. If 0.0, removes all holes

static remove_openings_below_area_threshold(area_threshold: float) → None

Remove openings below the provided threshold area for the selected body. Use iesve.VEBody.select() to select a body

Parameters:

area_threshold (float) – Area threshold in square metres

static set_body_opening_type(opening_type: str) → None

Change opening type for selected body’s openings. Use iesve.VEBody.select() to select a body

Parameters:

opening_type (str) – Opening type. Valid entries are ‘door’, ‘window’ and ‘hole’

static set_building_orientation(orientation: float) → None

Set building orientation

Parameters:

orientation (float) – Orientation from north in degrees

static set_colour(colour_index: int) → None

Set colour of the selected body

Parameters:

colour_index (int) – Index of the colour to set.

Possible colour index values:

int	colour
0	BLUE
1	GREEN
2	RED
3	YELLOW
4	PURPLE
5	ORANGE
6	CYAN
7	LIGHT GREY
48	WHITE
56	BLACK

static set_percent_doors(percent_doors: int) → None

Set percent doors for the selected body. Use iesve.VEBody.select() to select a body

Parameters:

percent_doors (int) – Percent doors to set

static set_percent_glazing(percent_glazing: int) → None

Set percent glazing of external surfaces for the selected body. Use iesve.VEBody.select() to select a body

Parameters:

percent_doors (int) – Percent glazing to set

static set_percent_holes(percent_holes: int) → None

Set percent holes for the selected body. Use iesve.VEBody.select() to select a body.

Parameters:

percent_holes (int) – Percent holes to set

static set_percent_wall_glazing(percent_glazing: int) → None

Set percent glazing of walls for the selected body. Use iesve.VEBody.select() to select a body.

Parameters:

percent_glazing (int) – Percent glazing to set.

get_id() → str

Gets the opening ID

get_macroflo_id() → str

Gets the macroflo opening ID

get_properties() → dict

Gets a dictionary of opening properties. Possible keys are:

• aps_handle

• area

• aspect_ratio

• height

• index

• macroflo_type

• perimeter

• sill_height

• type

• width

Note that values for width and height are only accurate for rectangular openings and horizontal rotations

move_opening(x_distance: float, y_distance: float) → None

Move an associated opening