From 40ea2fb584685f91b4d881f5583d2f61562c5491 Mon Sep 17 00:00:00 2001 From: Nicolas Mounet Date: Wed, 2 Dec 2020 12:12:19 +0100 Subject: [PATCH] Adding docstring for HingedWindow in models.py --- cara/models.py | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/cara/models.py b/cara/models.py index 6db48ddf..35ca79cf 100644 --- a/cara/models.py +++ b/cara/models.py @@ -253,11 +253,24 @@ class SlidingWindow(WindowOpening): @dataclass(frozen=True) class HingedWindow(WindowOpening): + """ + Top-hung or bottom-hung hinged window (with the hinge parallel to + horizontal plane). + """ #: Window width (m). window_width: float = None @property def discharge_coefficient(self) -> float: + """ + Simple model to compute discharge coefficient for top or bottom + hung hinged windows, in the absence of empirical test results + from manufacturers. + From an excel spreadsheet calculator (Richard Daniels, Crawford + Wright, Benjamin Jones - 2018) from the UK government - + see Section 8.3 of BB101 and Section 11.3 of + ESFA Output Specification Annex 2F on Ventilation opening areas. + """ window_ratio = self.window_width / self.window_height M = (0.06 if window_ratio < 0.5 else 0.048 if window_ratio < 1 else 0.04 if window_ratio < 2 else 0.038)