hvx 0.5.0__py3-none-any.whl

hvx/__init__.py

@@ -0,0 +1,27 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+"""
+HVX — indoor environmental quality (IEQ) analytics for buildings.
+
+Subpackages
+-----------
+``hvx.core``         data model (Portfolio / Building / Floor / Room), IFC & Brick semantics
+``hvx.standards``    EN 16798-1, TAIL, BR18 assessments
+``hvx.simulations``  ventilation, occupancy, correlations, scenarios, recommendations
+``hvx.reporting``    portfolio reports (HTML / JSON / CSV)
+``hvx.live``         live data sources (Home Assistant, HTTP, in-memory) and rolling monitoring
+``hvx.connectors``   file loaders (CSV)
+``hvx.app``          FastAPI backend and Streamlit UI (optional extras)
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("hvx")
+except PackageNotFoundError:  # running from a source checkout
+    __version__ = "0.0.0+local"
+
+__all__ = ["__version__"]

hvx/__main__.py

@@ -0,0 +1,7 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+from hvx.cli import cli
+
+if __name__ == "__main__":
+    cli()

hvx/app/__init__.py

@@ -0,0 +1,7 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+"""
+Streamlit application package for interactive portfolio management.
+"""
+

hvx/app/analysis_runner.py

@@ -0,0 +1,102 @@
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+from __future__ import annotations
+
+from typing import Dict, Iterable, Optional
+
+import pandas as pd
+
+from hvx.core import (
+    Room,
+    Building,
+    generate_occupancy_mask,
+    get_opening_profile_for_building_type,
+)
+from hvx.core.utils.calendar import get_holiday_dates
+from hvx.standards.en16798.analysis import EN16798Calculator, VentilationType as ENVentilationType
+
+
+def _room_dataframe(room: Room) -> Optional[pd.DataFrame]:
+    if not room.timeseries_data:
+        return None
+    df = pd.DataFrame(room.timeseries_data)
+    if room.timestamps and len(room.timestamps) == len(df.index):
+        idx = pd.to_datetime(room.timestamps, errors="coerce")
+        df.index = idx
+        df = df[~df.index.isna()]
+    elif "timestamp" in df.columns:
+        idx = pd.to_datetime(df["timestamp"], errors="coerce")
+        df = df.drop(columns=["timestamp"])
+        df.index = idx
+        df = df[~df.index.isna()]
+    else:
+        df.index = pd.RangeIndex(len(df))
+    if df.empty:
+        return None
+    return df
+
+
+def run_en16798_for_room(
+    room: Room,
+    season: str = "heating",
+    building: Optional[Building] = None,
+) -> Optional[Dict]:
+    df = _room_dataframe(room)
+    if df is None:
+        return None
+
+    occupancy_mask: Optional[pd.Series] = None
+    if isinstance(df.index, pd.DatetimeIndex):
+        building_type = getattr(building, "building_type", None)
+        profile = get_opening_profile_for_building_type(
+            building_type.lower() if isinstance(building_type, str) else building_type
+        )
+        holiday_dates = get_holiday_dates(getattr(building, "country", None))
+        occupancy_mask = generate_occupancy_mask(df.index, profile, holiday_dates=holiday_dates)
+        df = df[occupancy_mask]
+
+    if df.empty:
+        return None
+
+    temperature = df["temperature"] if "temperature" in df else None
+    co2 = df["co2"] if "co2" in df else None
+    humidity = df["humidity"] if "humidity" in df else None
+
+    ventilation_type = ENVentilationType.MECHANICAL
+    if room.ventilation_type:
+        try:
+            ventilation_type = ENVentilationType(room.ventilation_type.value)
+        except ValueError:
+            ventilation_type = ENVentilationType.MECHANICAL
+
+    results = EN16798Calculator.assess_timeseries_compliance(
+        temperature=temperature,
+        co2=co2,
+        humidity=humidity,
+        season=season,
+        ventilation_type=ventilation_type,
+    )
+    return results
+
+
+def run_en16798_for_rooms(
+    rooms: Iterable[Room],
+    season: str = "heating",
+    buildings: Optional[Dict[str, Building]] = None,
+) -> Dict[str, Dict]:
+    summaries: Dict[str, Dict] = {}
+    for room in rooms:
+        building_obj = None
+        if buildings:
+            if room.building_id and room.building_id in buildings:
+                building_obj = buildings.get(room.building_id)
+            else:
+                for parent_id in room.parent_ids:
+                    if parent_id in buildings:
+                        building_obj = buildings[parent_id]
+                        break
+        result = run_en16798_for_room(room, season=season, building=building_obj)
+        if result:
+            summaries[room.id] = result
+    return summaries