py-pilecore 0.5.1__tar.gz → 0.7.0__tar.gz

{py_pilecore-0.5.1/src/py_pilecore.egg-info → py_pilecore-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: py-pilecore
-Version: 0.5.1
+Version: 0.7.0
 Summary: Public python SDK for the CEMS PileCore web-API.
 License: MIT License
         
@@ -37,10 +37,14 @@ Requires-Dist: matplotlib<4,>=3.8
 Requires-Dist: tqdm[notebook]<5,>4
 Requires-Dist: natsort<9,>8
 Requires-Dist: shapely<3,>=2
-Requires-Dist: scipy<2,>=1
+Requires-Dist: scipy<2,>=1.13
+Requires-Dist: ipywidgets<9,>=8
+Requires-Dist: dash<3,>=2.17
+Requires-Dist: plotly-geo<2,>=1.0.0
 Provides-Extra: test
 Requires-Dist: coveralls; extra == "test"
 Requires-Dist: pytest; extra == "test"
+Requires-Dist: openapi-core; extra == "test"
 Provides-Extra: docs
 Requires-Dist: Sphinx==6.1.3; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints==1.22; extra == "docs"
@@ -48,23 +52,16 @@ Requires-Dist: ipython==8.11.0; extra == "docs"
 Requires-Dist: asteroid-sphinx-theme==0.0.3; extra == "docs"
 Requires-Dist: sphinx_rtd_theme==1.2.0; extra == "docs"
 Provides-Extra: lint
-Requires-Dist: mypy==1.6.1; extra == "lint"
-Requires-Dist: mypy-extensions==1.0.0; extra == "lint"
-Requires-Dist: tomli==2.0.1; extra == "lint"
-Requires-Dist: typing_extensions==4.7.1; extra == "lint"
-Requires-Dist: black[jupyter]==23.10.1; extra == "lint"
-Requires-Dist: click==8.1.3; extra == "lint"
-Requires-Dist: packaging==23.2; extra == "lint"
-Requires-Dist: pathspec==0.11.1; extra == "lint"
-Requires-Dist: platformdirs==3.5.1; extra == "lint"
-Requires-Dist: tomli==2.0.1; extra == "lint"
-Requires-Dist: isort==5.12.0; extra == "lint"
+Requires-Dist: ansible-lint==6.22.1; extra == "lint"
+Requires-Dist: black==23.11.0; extra == "lint"
+Requires-Dist: cfn-lint==0.83.3; extra == "lint"
+Requires-Dist: cpplint==1.6.1; extra == "lint"
 Requires-Dist: flake8==6.0.0; extra == "lint"
-Requires-Dist: mccabe==0.7.0; extra == "lint"
-Requires-Dist: pycodestyle==2.10.0; extra == "lint"
-Requires-Dist: pyflakes==3.0.1; extra == "lint"
-Requires-Dist: pandas-stubs<3,>2; extra == "lint"
-Requires-Dist: types-tqdm<5,>4; extra == "lint"
+Requires-Dist: isort==5.12.0; extra == "lint"
+Requires-Dist: mypy==1.7.1; extra == "lint"
+Requires-Dist: sqlfluff==2.3.5; extra == "lint"
+Requires-Dist: yamllint==1.33.0; extra == "lint"
+Requires-Dist: yq==3.2.3; extra == "lint"
 
 # py-pilecore
 Public python SDK for the CEMS PileCore web-API
@@ -100,7 +97,7 @@ Go to `personal-access-tokens` and create a new user token.
 
 ## Environment
 
-We recommend developing in Python3.10 with a clean virtual environment (using `virtualenv` or `conda`), installing the requirements from the requirements.txt file:
+We recommend developing in Python3.11 with a clean virtual environment (using `virtualenv` or `conda`), installing the requirements from the requirements.txt file:
 
 Example using `virtualenv` and `pip` to install the dependencies in a new environment .env on Linux:
 
@@ -152,7 +149,7 @@ coverage run -m pytest
 
 ## Requirements
 
-Requirements are autogenerated by the `pip-compile` command with python 3.10
+Requirements are autogenerated by the `pip-compile` command with python 3.11
 
 Install pip-tools with:
 

{py_pilecore-0.5.1 → py_pilecore-0.7.0}/README.md

@@ -32,7 +32,7 @@ Go to `personal-access-tokens` and create a new user token.
 
 ## Environment
 
-We recommend developing in Python3.10 with a clean virtual environment (using `virtualenv` or `conda`), installing the requirements from the requirements.txt file:
+We recommend developing in Python3.11 with a clean virtual environment (using `virtualenv` or `conda`), installing the requirements from the requirements.txt file:
 
 Example using `virtualenv` and `pip` to install the dependencies in a new environment .env on Linux:
 
@@ -84,7 +84,7 @@ coverage run -m pytest
 
 ## Requirements
 
-Requirements are autogenerated by the `pip-compile` command with python 3.10
+Requirements are autogenerated by the `pip-compile` command with python 3.11
 
 Install pip-tools with:
 

{py_pilecore-0.5.1 → py_pilecore-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "py-pilecore"
-version = "0.5.1"
+version = "0.7.0"
 description = "Public python SDK for the CEMS PileCore web-API."
 requires-python = ">=3.9"
 dependencies = [
@@ -16,7 +16,10 @@ dependencies = [
     "tqdm[notebook]>4,<5",
     "natsort>8,<9",
     "shapely>=2,<3",
-    "scipy>=1, <2",
+    "scipy>=1.13, <2",
+    "ipywidgets>=8, <9",
+    "dash>=2.17, <3",
+    "plotly-geo>=1.0.0, <2",
 ]
 license = { file = "LICENSE" }
 readme = "README.md"
@@ -26,7 +29,7 @@ keywords = ["API", "PileCore", "CEMS", "CRUX"]
 repository = "https://github.com/cemsbv/py-pilecore"
 
 [project.optional-dependencies]
-test = ["coveralls", "pytest"]
+test = ["coveralls", "pytest", "openapi-core"]
 docs = [
     "Sphinx==6.1.3",
     "sphinx-autodoc-typehints==1.22",
@@ -34,26 +37,21 @@ docs = [
     "asteroid-sphinx-theme==0.0.3",
     "sphinx_rtd_theme==1.2.0",
 ]
-# lint dependencies from github super-linter v5
+# lint dependencies from github super-linter
 # See https://github.com/super-linter/super-linter/tree/main/dependencies/python
+# Get a file with the latest requirements by running bash: `./get-super-linter-requirements.sh`
+# ignoring because redundant: snakemake, snakefmt, pylint
 lint = [
-    "mypy==1.6.1",
-    "mypy-extensions==1.0.0",
-    "tomli==2.0.1",
-    "typing_extensions==4.7.1",
-    "black[jupyter]==23.10.1",
-    "click==8.1.3",
-    "packaging==23.2",
-    "pathspec==0.11.1",
-    "platformdirs==3.5.1",
-    "tomli==2.0.1,",
-    "isort==5.12.0",
+    "ansible-lint==6.22.1",
+    "black==23.11.0",
+    "cfn-lint==0.83.3",
+    "cpplint==1.6.1",
     "flake8==6.0.0",
-    "mccabe==0.7.0",
-    "pycodestyle==2.10.0",
-    "pyflakes==3.0.1",
-    'pandas-stubs>2,<3',
-    'types-tqdm>4,<5',
+    "isort==5.12.0",
+    "mypy==1.7.1",
+    "sqlfluff==2.3.5",
+    "yamllint==1.33.0",
+    "yq==3.2.3",
 ]
 
 [tool.isort]
@@ -95,5 +93,8 @@ module = [
     "scipy.*",
     "numpy.*",
     "pandas.*",
+    "IPython.*",
+    "plotly.*",
+    "ipywidgets.*",
 ]
 ignore_missing_imports = true

{py_pilecore-0.5.1 → py_pilecore-0.7.0/src/py_pilecore.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: py-pilecore
-Version: 0.5.1
+Version: 0.7.0
 Summary: Public python SDK for the CEMS PileCore web-API.
 License: MIT License
         
@@ -37,10 +37,14 @@ Requires-Dist: matplotlib<4,>=3.8
 Requires-Dist: tqdm[notebook]<5,>4
 Requires-Dist: natsort<9,>8
 Requires-Dist: shapely<3,>=2
-Requires-Dist: scipy<2,>=1
+Requires-Dist: scipy<2,>=1.13
+Requires-Dist: ipywidgets<9,>=8
+Requires-Dist: dash<3,>=2.17
+Requires-Dist: plotly-geo<2,>=1.0.0
 Provides-Extra: test
 Requires-Dist: coveralls; extra == "test"
 Requires-Dist: pytest; extra == "test"
+Requires-Dist: openapi-core; extra == "test"
 Provides-Extra: docs
 Requires-Dist: Sphinx==6.1.3; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints==1.22; extra == "docs"
@@ -48,23 +52,16 @@ Requires-Dist: ipython==8.11.0; extra == "docs"
 Requires-Dist: asteroid-sphinx-theme==0.0.3; extra == "docs"
 Requires-Dist: sphinx_rtd_theme==1.2.0; extra == "docs"
 Provides-Extra: lint
-Requires-Dist: mypy==1.6.1; extra == "lint"
-Requires-Dist: mypy-extensions==1.0.0; extra == "lint"
-Requires-Dist: tomli==2.0.1; extra == "lint"
-Requires-Dist: typing_extensions==4.7.1; extra == "lint"
-Requires-Dist: black[jupyter]==23.10.1; extra == "lint"
-Requires-Dist: click==8.1.3; extra == "lint"
-Requires-Dist: packaging==23.2; extra == "lint"
-Requires-Dist: pathspec==0.11.1; extra == "lint"
-Requires-Dist: platformdirs==3.5.1; extra == "lint"
-Requires-Dist: tomli==2.0.1; extra == "lint"
-Requires-Dist: isort==5.12.0; extra == "lint"
+Requires-Dist: ansible-lint==6.22.1; extra == "lint"
+Requires-Dist: black==23.11.0; extra == "lint"
+Requires-Dist: cfn-lint==0.83.3; extra == "lint"
+Requires-Dist: cpplint==1.6.1; extra == "lint"
 Requires-Dist: flake8==6.0.0; extra == "lint"
-Requires-Dist: mccabe==0.7.0; extra == "lint"
-Requires-Dist: pycodestyle==2.10.0; extra == "lint"
-Requires-Dist: pyflakes==3.0.1; extra == "lint"
-Requires-Dist: pandas-stubs<3,>2; extra == "lint"
-Requires-Dist: types-tqdm<5,>4; extra == "lint"
+Requires-Dist: isort==5.12.0; extra == "lint"
+Requires-Dist: mypy==1.7.1; extra == "lint"
+Requires-Dist: sqlfluff==2.3.5; extra == "lint"
+Requires-Dist: yamllint==1.33.0; extra == "lint"
+Requires-Dist: yq==3.2.3; extra == "lint"
 
 # py-pilecore
 Public python SDK for the CEMS PileCore web-API
@@ -100,7 +97,7 @@ Go to `personal-access-tokens` and create a new user token.
 
 ## Environment
 
-We recommend developing in Python3.10 with a clean virtual environment (using `virtualenv` or `conda`), installing the requirements from the requirements.txt file:
+We recommend developing in Python3.11 with a clean virtual environment (using `virtualenv` or `conda`), installing the requirements from the requirements.txt file:
 
 Example using `virtualenv` and `pip` to install the dependencies in a new environment .env on Linux:
 
@@ -152,7 +149,7 @@ coverage run -m pytest
 
 ## Requirements
 
-Requirements are autogenerated by the `pip-compile` command with python 3.10
+Requirements are autogenerated by the `pip-compile` command with python 3.11
 
 Install pip-tools with:
 

{py_pilecore-0.5.1 → py_pilecore-0.7.0}/src/py_pilecore.egg-info/SOURCES.txt

@@ -28,9 +28,20 @@ src/pypilecore/input/grouper_properties.py
 src/pypilecore/input/multi_cpt.py
 src/pypilecore/input/soil_properties.py
 src/pypilecore/results/__init__.py
+src/pypilecore/results/cases_multi_cpt_results.py
 src/pypilecore/results/grouper_result.py
 src/pypilecore/results/load_settlement.py
 src/pypilecore/results/multi_cpt_results.py
 src/pypilecore/results/post_processing.py
+src/pypilecore/results/result_definitions.py
 src/pypilecore/results/single_cpt_results.py
-src/pypilecore/results/soil_properties.py
+src/pypilecore/results/soil_properties.py
+src/pypilecore/viewers/__init__.py
+src/pypilecore/viewers/viewer_cpt_group_results.py
+src/pypilecore/viewers/viewer_cpt_results.py
+src/pypilecore/viewers/viewer_cpt_results_plan_view.py
+src/pypilecore/viewers/interactive_figures/__init__.py
+src/pypilecore/viewers/interactive_figures/figure_cpt_group_results_versus_ptls.py
+src/pypilecore/viewers/interactive_figures/figure_cpt_results_plan_view.py
+src/pypilecore/viewers/interactive_figures/figure_cpt_results_versus_ptls.py
+src/pypilecore/viewers/interactive_figures/utils.py

{py_pilecore-0.5.1 → py_pilecore-0.7.0}/src/py_pilecore.egg-info/requires.txt

@@ -6,7 +6,10 @@ matplotlib<4,>=3.8
 tqdm[notebook]<5,>4
 natsort<9,>8
 shapely<3,>=2
-scipy<2,>=1
+scipy<2,>=1.13
+ipywidgets<9,>=8
+dash<3,>=2.17
+plotly-geo<2,>=1.0.0
 
 [docs]
 Sphinx==6.1.3
@@ -16,23 +19,18 @@ asteroid-sphinx-theme==0.0.3
 sphinx_rtd_theme==1.2.0
 
 [lint]
-mypy==1.6.1
-mypy-extensions==1.0.0
-tomli==2.0.1
-typing_extensions==4.7.1
-black[jupyter]==23.10.1
-click==8.1.3
-packaging==23.2
-pathspec==0.11.1
-platformdirs==3.5.1
-isort==5.12.0
+ansible-lint==6.22.1
+black==23.11.0
+cfn-lint==0.83.3
+cpplint==1.6.1
 flake8==6.0.0
-mccabe==0.7.0
-pycodestyle==2.10.0
-pyflakes==3.0.1
-pandas-stubs<3,>2
-types-tqdm<5,>4
+isort==5.12.0
+mypy==1.7.1
+sqlfluff==2.3.5
+yamllint==1.33.0
+yq==3.2.3
 
 [test]
 coveralls
 pytest
+openapi-core

{py_pilecore-0.5.1 → py_pilecore-0.7.0}/src/pypilecore/_version.py

@@ -4,4 +4,4 @@ try:
     __version__ = version("py-pilecore")
 # during CI
 except PackageNotFoundError:
-    __version__ = "0.5.1"
+    __version__ = "0.7.0"

{py_pilecore-0.5.1 → py_pilecore-0.7.0}/src/pypilecore/input/grouper_properties.py

@@ -74,7 +74,8 @@ def create_grouper_payload(
     Parameters
     ----------
     cpt_results_dict:
-        Dictionary with key as CPT name and value a SingleCPTBearingResults class
+        Dictionary with key as CPT name and value a SingleCPTBearingResults class.
+        Should contain at least 2 entries.
     pile_load_uls
         ULS load in kN. Used to determine if a grouping configuration is valid.
     stiff_construction
@@ -131,12 +132,12 @@ def create_grouper_payload(
     ValueError:
         - if NaN values are present in negative friction, bottom or shaft bearing_capacity
 
-
         - if x or y coordinate is None
 
-
         - if pile tip levels don't macht for all SingleCPTBearingResults
 
+        - if less than 2 valid CPTs are provided
+
 
     Returns
     -------
@@ -212,6 +213,12 @@ def create_grouper_payload(
                 },
             }
         )
+
+    if not len(cpt_objects) >= 2:
+        raise ValueError(
+            "The PileCore grouper requires at least 2 CPTs with valid bearing capacity."
+        )
+
     payload["cpt_objects"] = cpt_objects
 
     # validate pile tip levels

{py_pilecore-0.5.1 → py_pilecore-0.7.0}/src/pypilecore/input/soil_properties.py

@@ -158,9 +158,19 @@ def create_soil_properties_payload(
             groundwater_level_nap=groundwater_level_nap
             if groundwater_level_nap is not None
             else cpt.delivered_vertical_position_offset - 1,
-            coordinates=dict(x=cpt.delivered_location.x, y=cpt.delivered_location.y),
         )
 
+        # Optionally add coordinates
+        if (
+            cpt.delivered_location is not None
+            and cpt.delivered_location.x is not None
+            and cpt.delivered_location.y is not None
+        ):
+            soil_properties["coordinates"] = {
+                "x": cpt.delivered_location.x,
+                "y": cpt.delivered_location.y,
+            }
+
         # Optionally add cpt-specific friction-range parameters
         if (
             individual_negative_friction_range_nap is not None

{py_pilecore-0.5.1 → py_pilecore-0.7.0}/src/pypilecore/results/__init__.py

@@ -1,9 +1,11 @@
+from pypilecore.results.cases_multi_cpt_results import CasesMultiCPTBearingResults
 from pypilecore.results.grouper_result import GrouperResults
 from pypilecore.results.multi_cpt_results import MultiCPTBearingResults
 from pypilecore.results.single_cpt_results import SingleCPTBearingResults
 from pypilecore.results.soil_properties import SoilProperties
 
 __all__ = [
+    "CasesMultiCPTBearingResults",
     "MultiCPTBearingResults",
     "SingleCPTBearingResults",
     "SoilProperties",

py_pilecore-0.7.0/src/pypilecore/results/cases_multi_cpt_results.py

@@ -0,0 +1,244 @@
+from __future__ import annotations  # noqa: F404
+
+from typing import Dict, Hashable, List
+
+import pandas as pd
+from natsort import natsorted
+from pygef.common import Location
+
+from pypilecore.results.multi_cpt_results import MultiCPTBearingResults
+from pypilecore.results.result_definitions import (
+    CPTGroupResultDefinitions,
+    CPTResultDefinitions,
+)
+
+
+class CasesMultiCPTBearingResults:
+    """
+    Container class for the results of multiple cases of MultiCPTBearingResults.
+    It expects that all MultiCPTBearingResults objects have the same pile tip levels and same test ids.
+    """
+
+    def __init__(
+        self,
+        results_per_case: Dict[Hashable, MultiCPTBearingResults],
+        cpt_locations: Dict[str, Location],
+    ) -> None:
+        """
+        Initialize the class with the results of multiple cases of MultiCPTBearingResults.
+
+        Parameters
+        ----------
+        results_per_case : Dict[Hashable, MultiCPTBearingResults]
+            A dictionary with the results of multiple cases of MultiCPTBearingResults.
+            The keys of the dictionary are the case names.
+            All MultiCPTBearingResults objects must have the same pile tip levels and same test ids.
+        cpt_locations : Dict[str, Location]
+            The mapping between `test_id` (key) and the `location` (value) of the cpt.
+            The keys must contain all the `test_id` (s) used in the MultiCPTBearingResults objects.
+
+        Raises
+        ------
+        TypeError
+            If `results_per_case` is not of the expected type.
+            If `cpt_locations` is not of the expected type.
+        ValueError
+            If `results_per_case` is an empty dictionary.
+            If not all MultiCPTBearingResults objects have the same pile tip levels and test ids.
+            If not all the `test_id` (s) used in the MultiCPTBearingResults objects are in the keys of `cpt_locations`.
+        """
+        # Validate results cases
+        _validate_results_per_case(results_per_case)
+
+        # Initialize private variables
+        self._cases = natsorted(list(results_per_case.keys()))
+        self._multicpt_bearing_results = [results_per_case[c] for c in self.cases]
+        self._test_ids = natsorted(
+            results_per_case[list(results_per_case.keys())[0]].cpt_results.test_ids
+        )
+        self._pile_tip_levels_nap = sorted(
+            list(
+                results_per_case[list(results_per_case.keys())[0]]
+                .cpt_results.to_pandas()
+                .pile_tip_level_nap.unique()
+            ),
+            reverse=True,
+        )
+        self._set_cpt_locations(cpt_locations)
+
+        # Create cpt_results_dataframe and cpt_group_results_dataframe
+        self._set_cpt_results_dataframe(results_per_case)
+        self._set_cpt_group_results_dataframe(results_per_case)
+
+    def _set_cpt_results_dataframe(
+        self, results_per_case: Dict[Hashable, MultiCPTBearingResults]
+    ) -> None:
+        """Private method to create and set the property `cpt_results_dataframe`."""
+        records = []
+        for case_name, case_results in results_per_case.items():
+            for result_definition in CPTResultDefinitions:
+                df = case_results.cpt_results.get_results_per_cpt(
+                    column_name=result_definition.name
+                )
+                for idx_row, row in df.iterrows():
+                    for test_id, result in row.items():
+                        records.append(
+                            dict(
+                                case_name=case_name,
+                                result_name=result_definition.name,
+                                test_id=test_id,
+                                x=self.cpt_locations[test_id].x,
+                                y=self.cpt_locations[test_id].y,
+                                pile_tip_level_nap=idx_row,
+                                result=result,
+                                result_unit=result_definition.value.unit,
+                            )
+                        )
+        self._cpt_results_dataframe = pd.DataFrame.from_records(records)
+
+    def _set_cpt_group_results_dataframe(
+        self, result_cases: Dict[Hashable, MultiCPTBearingResults]
+    ) -> None:
+        """Private method to create and set the property `cpt_group_results_dataframe`."""
+        records = []
+        for case_name, case_results in result_cases.items():
+            df = case_results.group_results_table.to_pandas()
+            for result_definition in CPTGroupResultDefinitions:
+                for _, row in df.iterrows():
+                    records.append(
+                        dict(
+                            case_name=case_name,
+                            result_name=result_definition.name,
+                            pile_tip_level_nap=row["pile_tip_level_nap"],
+                            result=row[result_definition.value.name],
+                            result_unit=result_definition.value.unit,
+                        )
+                    )
+        self._cpt_group_results_dataframe = pd.DataFrame.from_records(records)
+
+    def _set_cpt_locations(self, value: Dict[str, Location]) -> None:
+        """Private setter for `cpt_locations`."""
+        # Check data types
+        if not isinstance(value, dict):
+            raise TypeError(
+                f"Expected type 'List[CPTData]' for 'cpt_locations', but got {type(value)}"
+            )
+
+        if not all(isinstance(k, str) for k in value.keys()):
+            raise TypeError(
+                f"Expected type 'str' for keys of 'cpt_locations', but got {(type(k) for k in value.keys())}"
+            )
+
+        if not all(isinstance(v, Location) for v in value.values()):
+            raise TypeError(
+                f"Expected type 'Location' for values of 'cpt_locations', but got {(type(v) for v in value.values())}"
+            )
+
+        # Check that all the `test_id`s used in the MultiCPTBearingResults objects are in the keys.
+        if not all(test_id in value.keys() for test_id in self.test_ids):
+            missing_test_ids = [
+                test_id for test_id in self.test_ids if test_id not in value.keys()
+            ]
+            raise ValueError(
+                "Not all `test_id`s used in the MultiCPTBearingResults objects are in the keys of `cpt_locations`. "
+                + f"The following `test_id`s are missing: {missing_test_ids}"
+            )
+
+        self._cpt_locations = value
+
+    @property
+    def cases(self) -> List[Hashable]:
+        """The case names."""
+        return self._cases
+
+    @property
+    def multicpt_bearing_results(self) -> List[MultiCPTBearingResults]:
+        """The MultiCPTBearingResults objects."""
+        return self._multicpt_bearing_results
+
+    @property
+    def test_ids(self) -> List[str]:
+        """The test ids of all MultiCPTBearingResults objects."""
+        return self._test_ids
+
+    @property
+    def pile_tip_levels_nap(self) -> List[float]:
+        """The pile tip levels NAP of all MultiCPTBearingResults objects."""
+        return self._pile_tip_levels_nap
+
+    @property
+    def cpt_locations(self) -> Dict[str, Location]:
+        """The mapping between `test_id` (key) and the `location` (value) of the cpt."""
+        return self._cpt_locations
+
+    @property
+    def cpt_results_dataframe(self) -> pd.DataFrame:
+        """
+        The dataframe with all the CPT results.
+        Available columns: case_name, result_name, test_id, x, y, pile_tip_level_nap, result, result_unit.
+        """
+        return self._cpt_results_dataframe
+
+    @property
+    def cpt_group_results_dataframe(self) -> pd.DataFrame:
+        """
+        The dataframe with CPT group results.
+        Available columns: case_name, result_name, pile_tip_level_nap, result, result_unit.
+        """
+        return self._cpt_group_results_dataframe
+
+
+def _validate_results_per_case(
+    results_per_case: Dict[Hashable, MultiCPTBearingResults]
+) -> None:
+    """
+    Private method to validate the results_per_case dictionary.
+
+    Parameters
+    ----------
+    results_per_case : Dict[Hashable, MultiCPTBearingResults]
+        A dictionary with the results of multiple cases of MultiCPTBearingResults.
+        The keys of the dictionary are the case names.
+        All MultiCPTBearingResults objects must have the same pile tip levels and same test ids.
+
+    Raises
+    ------
+    TypeError
+        If `results_per_case` is not of the expected type.
+    ValueError
+        If `results_per_case` is an empty dictionary.
+        If not all MultiCPTBearingResults objects have the same pile tip levels and test ids.
+    """
+    if not isinstance(results_per_case, dict):
+        raise TypeError(
+            f"Expected type 'Dict[Hashable, MultiCPTBearingResults]' for 'results_per_case', but got {type(results_per_case)}"
+        )
+
+    if len(results_per_case) == 0:
+        raise ValueError("Empty dictionary 'results_per_case' is not allowed.")
+
+    for val in results_per_case.values():
+        if not isinstance(val, MultiCPTBearingResults):
+            raise TypeError(
+                f"Expected type 'MultiCPTBearingResults' for items in 'results_per_case', but got {type(val)}"
+            )
+
+    test_ids = results_per_case[list(results_per_case.keys())[0]].cpt_results.test_ids
+    pile_tip_levels_nap = list(
+        results_per_case[list(results_per_case.keys())[0]]
+        .cpt_results.to_pandas()
+        .pile_tip_level_nap.unique()
+    )
+    for results in results_per_case.values():
+        if results.cpt_results.test_ids != test_ids:
+            raise ValueError(
+                "All MultiCPTBearingResults objects must have the same test ids."
+            )
+
+        if (
+            list(results.cpt_results.to_pandas().pile_tip_level_nap.unique())
+            != pile_tip_levels_nap
+        ):
+            raise ValueError(
+                "All MultiCPTBearingResults objects must have the same pile tip levels."
+            )