py-pilecore 0.5.0__py3-none-any.whl → 0.6.0__py3-none-any.whl

pypilecore/viewers/viewer_cpt_group_results.py

@@ -0,0 +1,75 @@
+from __future__ import annotations  # noqa: F404
+
+from typing import Any
+
+from IPython.display import DisplayHandle, display
+from ipywidgets import widgets
+
+from pypilecore.results.cases_multi_cpt_results import CasesMultiCPTBearingResults
+from pypilecore.results.result_definitions import CPTGroupResultDefinitions
+from pypilecore.viewers.interactive_figures import FigureCPTGroupResultsVersusPtls
+
+
+class ViewerCptGroupResults:
+    """
+    Viewer for the CPT group results of the bearing capacity calculations.
+
+    It offers the following layout:
+        - Dropdown widgets:
+            - Result: to select the result to show.
+        - Figure CPT group results vs. pile tip level:
+            - X axis: result values
+            - Y axis: pile tip level w.r.t. NAP
+            - Each trace represents a different case.
+    """
+
+    def __init__(self, cases_multi_results: CasesMultiCPTBearingResults) -> None:
+        """Initialize the viewer.
+
+        Parameters
+        ----------
+        cases_multi_results : CasesMultiCPTBearingResults
+            The results of the bearing capacity calculations.
+
+        Raises
+        ------
+        TypeError
+            If 'cases_multi_results' are not of type 'CasesMultiCPTBearingResults'.
+        """
+        # Initialize figure CPT group resuls vs. pile tip level
+        self._figure_plts = FigureCPTGroupResultsVersusPtls(
+            cases_multi_results=cases_multi_results
+        )
+
+        # Set up control widgets
+        self._result_dropdown = widgets.Dropdown(
+            description="Result:",
+            value=CPTGroupResultDefinitions.R_c_d_net.name,
+            options=CPTGroupResultDefinitions.natsorted_names(),
+        )
+
+        # Update plot for initial selection of control widgets
+        self._update_result(None)
+
+        # Set up callbacks
+        self._result_dropdown.observe(self._update_result, "value")
+
+        # Set up layout
+        self._control_widgets = widgets.HBox(
+            [
+                self._result_dropdown,
+            ]
+        )
+        self._layout = widgets.VBox([self._control_widgets, self._figure_plts.figure])
+
+    def _update_result(self, change: Any) -> None:
+        """Private method to update the figure when the result name is changed in the result dropdown."""
+
+        # Update the figure
+        self._figure_plts.show_result(
+            result_name=self._result_dropdown.value,
+        )
+
+    def display(self) -> DisplayHandle | None:
+        """Display the figure."""
+        return display(self._layout)

pypilecore/viewers/viewer_cpt_results.py

@@ -0,0 +1,87 @@
+from __future__ import annotations  # noqa: F404
+
+from typing import Any
+
+from IPython.display import DisplayHandle, display
+from ipywidgets import widgets
+
+from pypilecore.results.cases_multi_cpt_results import CasesMultiCPTBearingResults
+from pypilecore.results.result_definitions import CPTResultDefinitions
+from pypilecore.viewers.interactive_figures import FigureCPTResultsVersusPtls
+
+
+class ViewerCptResults:
+    """
+    Viewer for the CPT results of the bearing capacity calculations.
+
+    It offers the following layout:
+        - Dropdown widgets:
+            - Case: to select the case to show.
+            - Result: to select the result to show.
+        - Figure CPT results vs. pile tip level:
+            - X axis: result values
+            - Y axis: pile tip level w.r.t. NAP
+            - Each trace represents a different CPT.
+    """
+
+    def __init__(self, cases_multi_results: CasesMultiCPTBearingResults) -> None:
+        """Initialize the viewer.
+
+        Parameters
+        ----------
+        cases_multi_results : CasesMultiCPTBearingResults
+            The results of the bearing capacity calculations.
+
+        Raises
+        ------
+        TypeError
+            If 'cases_multi_results' are not of type 'CasesMultiCPTBearingResults'.
+        """
+
+        # Initialize figure CPT resuls vs. pile tip level
+        self._figure_plts = FigureCPTResultsVersusPtls(
+            cases_multi_results=cases_multi_results
+        )
+
+        # Set up control widgets
+        self._case_dropdown = widgets.Dropdown(
+            description="Case:",
+            value=self._figure_plts.cases[0],
+            options=self._figure_plts.cases,
+        )
+        self._result_dropdown = widgets.Dropdown(
+            description="Result:",
+            value=CPTResultDefinitions.R_c_d_net.name,
+            options=CPTResultDefinitions.natsorted_names(),
+        )
+
+        # Update plot for initial selection of control widgets
+        self._update_case_and_result(None)
+
+        # Set up callbacks
+        self._case_dropdown.observe(self._update_case_and_result, "value")
+        self._result_dropdown.observe(self._update_case_and_result, "value")
+
+        # Set up layout
+        self._control_widgets = widgets.HBox(
+            [
+                self._case_dropdown,
+                self._result_dropdown,
+            ]
+        )
+        self._layout = widgets.VBox(
+            [self._control_widgets, self._figure_plts.figure]
+        )  # , width=800)
+
+    def _update_case_and_result(self, change: Any) -> None:
+        """Private method to update the figure when the case or result name are changed in the control widgets."""
+
+        # Update the figure
+        self._figure_plts.show_case_and_result(
+            case_name=self._case_dropdown.value,
+            result_name=self._result_dropdown.value,
+        )
+
+    def display(self) -> DisplayHandle | None:
+        """Display the figure."""
+        return display(self._layout)

pypilecore/viewers/viewer_cpt_results_plan_view.py

@@ -0,0 +1,101 @@
+from __future__ import annotations  # noqa: F404
+
+from typing import Any
+
+from IPython.display import DisplayHandle, display
+from ipywidgets import widgets
+
+from pypilecore.results.cases_multi_cpt_results import CasesMultiCPTBearingResults
+from pypilecore.results.result_definitions import CPTResultDefinitions
+from pypilecore.viewers.interactive_figures.figure_cpt_results_plan_view import (
+    FigureCPTResultsPlanView,
+)
+
+
+class ViewerCptResultsPlanView:
+    """
+    Viewer for the CPT results of the bearing capacity calculations in
+    plan view for a fixed pile tip level (PTL).
+
+    It offers the following layout:
+        - Dropdown widgets:
+            - Case: to select the case to show.
+            - Result: to select the result to show.
+            - Pile tip level: to select the pile tip level to show.
+        - Figure CPT results vs. pile tip level:
+            - X axis: X coordinate.
+            - Y axis: Y coordinate.
+            - Each point represents a different CPT, but the same pile tip level.
+    """
+
+    def __init__(self, cases_multi_results: CasesMultiCPTBearingResults) -> None:
+        """Initialize the viewer.
+
+        Parameters
+        ----------
+        cases_multi_results : CasesMultiCPTBearingResults
+            The results of the bearing capacity calculations.
+
+        Raises
+        ------
+        TypeError
+            If 'cases_multi_results' are not of type 'CasesMultiCPTBearingResults'.
+        """
+
+        # Initialize figure CPT results in plan view
+        self._figure_plan_view = FigureCPTResultsPlanView(
+            cases_multi_results=cases_multi_results
+        )
+
+        # Set up control widgets
+        self._case_dropdown = widgets.Dropdown(
+            description="Case:",
+            value=self._figure_plan_view.cases[0],
+            options=self._figure_plan_view.cases,
+        )
+        self._result_dropdown = widgets.Dropdown(
+            description="Result:",
+            value=CPTResultDefinitions.R_c_d_net.name,
+            options=CPTResultDefinitions.natsorted_names(),
+        )
+        self._pile_tip_level_dropdown = widgets.Dropdown(
+            description="Pile tip level NAP:",
+            value=self._figure_plan_view.pile_tip_levels_nap[-1],
+            options=self._figure_plan_view.pile_tip_levels_nap,
+        )
+
+        # Update plot for initial selection of control widgets
+        self._update_case_result_and_ptl(None)
+
+        # Set up callbacks
+        self._case_dropdown.observe(self._update_case_result_and_ptl, "value")
+        self._result_dropdown.observe(self._update_case_result_and_ptl, "value")
+        self._pile_tip_level_dropdown.observe(self._update_case_result_and_ptl, "value")
+
+        # Set up layout
+        self._control_widgets = widgets.HBox(
+            [
+                self._case_dropdown,
+                self._result_dropdown,
+                self._pile_tip_level_dropdown,
+            ]
+        )
+        self._layout = widgets.VBox(
+            [self._control_widgets, self._figure_plan_view.figure]
+        )
+
+    def _update_case_result_and_ptl(self, change: Any) -> None:
+        """
+        Private method to update the figure when the case, result name or pile tip level
+        are changed in the control widgets.
+        """
+        # Update the figure
+        self._figure_plan_view.show_case_result_and_ptl(
+            case_name=self._case_dropdown.value,
+            result_name=self._result_dropdown.value,
+            pile_tip_level_nap=self._pile_tip_level_dropdown.value,
+        )
+
+    def display(self) -> DisplayHandle | None:
+        """Display the figure."""
+        return display(self._layout)