citydpc 0.1.22__py3-none-any.whl

citydpc/__init__.py

@@ -0,0 +1,33 @@
+from citydpc.dataset import Dataset
+
+from citydpc.logger import logger
+from . import config
+
+from typing import List, Type, Optional
+
+
+def configure_warnings(
+    warn_always: bool = None,
+    suppress_warnings: Optional[List[Type[Warning]]] = None,
+):
+    """Configure the warning behavior of the library.
+
+    Parameters
+    ----------
+    warn_always : bool, optional
+        If True, the library will always show warnings for each occurrence.
+        If False, it will only show one warning per category (default is False)
+    """
+    if warn_always is not None:
+        config.WARN_ONCE_PER_CATEGORY = not warn_always
+        logger.info(
+            "Configured warnings: "
+            + f"{'always' if warn_always else 'once per category'}"
+        )
+
+    if suppress_warnings is not None:
+        config.SUPPRESSED_WARNING_CATEGORIES = set(suppress_warnings)
+        logger.info(
+            "Configured suppressed warnings: "
+            + f"{', '.join([w.__name__ for w in suppress_warnings])}"
+        )

citydpc/config.py

@@ -0,0 +1,8 @@
+
+from typing import Set, Type
+
+# only show one warning per category
+WARN_ONCE_PER_CATEGORY = False
+
+# Suppress specific warning categories
+SUPPRESSED_WARNING_CATEGORIES: Set[Type[Warning]] = set()

citydpc/core/input/__init__.py

@@ -0,0 +1,22 @@
+from citydpc.logger import logger
+CALC_ROOF_VOLUME_ON_IMPORT = False
+CHECK_IF_SURFACES_ARE_PLANAR = True
+FIX_GROUNDSURFACE_OUTLIERS = False
+
+
+def set_roof_volume_calculation(value: bool) -> None:
+    global CALC_ROOF_VOLUME_ON_IMPORT
+    logger.info("Setting roof volume calculation to: %s", value)
+    CALC_ROOF_VOLUME_ON_IMPORT = value
+
+
+def set_check_if_surfaces_are_planar(value: bool) -> None:
+    global CHECK_IF_SURFACES_ARE_PLANAR
+    logger.info("Setting check if surfaces are planar to: %s", value)
+    CHECK_IF_SURFACES_ARE_PLANAR = value
+
+
+def set_fix_groundsurface_outliers(value: bool) -> None:
+    global FIX_GROUNDSURFACE_OUTLIERS
+    logger.info("Setting fix ground surface outliers to: %s", value)
+    FIX_GROUNDSURFACE_OUTLIERS = value