py-pilecore 1.0.3__tar.gz → 1.1.0__tar.gz

{py_pilecore-1.0.3/src/py_pilecore.egg-info → py_pilecore-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py-pilecore
-Version: 1.0.3
+Version: 1.1.0
 Summary: Public python SDK for the CEMS PileCore web-API.
 License: MIT License
         

{py_pilecore-1.0.3 → py_pilecore-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "py-pilecore"
-version = "1.0.3"
+version = "1.1.0"
 description = "Public python SDK for the CEMS PileCore web-API."
 requires-python = ">=3.11"
 dependencies = [

{py_pilecore-1.0.3 → py_pilecore-1.1.0/src/py_pilecore.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py-pilecore
-Version: 1.0.3
+Version: 1.1.0
 Summary: Public python SDK for the CEMS PileCore web-API.
 License: MIT License
         

{py_pilecore-1.0.3 → py_pilecore-1.1.0}/src/pypilecore/_version.py

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

{py_pilecore-1.0.3 → py_pilecore-1.1.0}/src/pypilecore/input/multi_cpt.py

@@ -14,7 +14,7 @@ def create_multi_cpt_payload(
     pile_tip_levels_nap: Sequence[float],
     cptdata_objects: List[CPTData],
     classify_tables: Dict[str, dict],
-    groundwater_level_nap: float,
+    groundwater_level_nap: float | None,
     pile: PileProperties,
     friction_range_strategy: Literal[
         "manual", "lower_bound", "settlement_driven"
@@ -94,6 +94,7 @@ def create_multi_cpt_payload(
 
     groundwater_level_nap:
         The groundwater level. Unit: [m] w.r.t. NAP.
+        If None, a value of 1 meter below the ground surface level is used.
     pile:
         A PileProperties object.
     friction_range_strategy:
@@ -161,6 +162,8 @@ def create_multi_cpt_payload(
                 In this case, the soil_properties.service_level property is used.
     excavation_depth_nap:
         Soil excavation depth after the CPT was taken. Unit: [m] w.r.t. NAP.
+        If None, a value equal to the ground surface level is used.
+        Default = None
     excavation_param_t:
         Excavation parameter depending on pile installation method and/or phasing.
             - Use 1.0 (default) for post-excavation installation with vibration (i.e. hammering).

{py_pilecore-1.0.3 → py_pilecore-1.1.0}/src/pypilecore/input/soil_properties.py

@@ -41,7 +41,7 @@ def get_cpt_depth(cpt: CPTData) -> NDArray:
 def create_soil_properties_payload(
     cptdata_objects: List[CPTData],
     classify_tables: Dict[str, dict],
-    groundwater_level_nap: float,
+    groundwater_level_nap: float | None,
     friction_range_strategy: Literal["manual", "lower_bound", "settlement_driven"],
     excavation_depth_nap: float | None = None,
     master_ocr: float | None = None,
@@ -95,6 +95,7 @@ def create_soil_properties_payload(
                 undrained shear strength [kPa]
     groundwater_level_nap:
         The groundwater level. Unit: [m] w.r.t. NAP.
+        If None, a value of 1 meter below the ground surface level is used.
     friction_range_strategy:
         Sets the method to determine the sleeve friction zones on the pile. The soil
         friction in the positive zone contributes to the bearing capacity, while the
@@ -102,6 +103,8 @@ def create_soil_properties_payload(
         "lower_bound" or "settlement_driven".
     excavation_depth_nap:
         Soil excavation depth after the CPT was taken. Unit: [m] w.r.t. NAP.
+        If None, a value equal to the ground surface level is used.
+        Default = None
     ocr:
         The Over-Consolidation-Ratio [-] of the foundation layer.
     individual_negative_friction_range_nap:

{py_pilecore-1.0.3 → py_pilecore-1.1.0}/src/pypilecore/input/tension.py

@@ -25,6 +25,9 @@ def create_multi_cpt_payload(
     top_of_tension_zone_nap: float | None = None,
     individual_top_of_tension_zone_nap: Mapping[Any, float] | None = None,
     excavation_param_t: float = 1.0,
+    excavation_stress_reduction_method: Literal["constant", "begemann"] = "constant",
+    excavation_width: float | None = None,
+    excavation_edge_distance: float | None = None,
     individual_ocr: Mapping[str, float] | None = None,
     overrule_xi: float | None = None,
     gamma_f_nk: float = 1.0,
@@ -111,6 +114,27 @@ def create_multi_cpt_payload(
               excavation method.
 
         See for more info NEN 9997-1+C2:2017 7.6.2.3.(10)(k)
+    excavation_stress_reduction_method:
+        Method used to calculate the stress reduction due to the excavation applied to the effective and total stresses.
+        Only used when `excavation_depth_nap` is different than `None`. It can be:
+            - "constant" (default): The stress reduction below the excavation is constant with depth. The stress reduction
+            is equal to the original effective stress (i.e. before the excavation) at the excavation depth.
+            - "begemann": The stress reduction below the excavation decreases with depth according to the Begemann method.
+            This method uses the elastic solution of a strip load acting on a semi-infinite homogeneous soil mass.
+            The load has a width equal to the excavation width and a magnitude equal to the original effective stress at
+            the excavation depth.
+        Regardless the method, the stress reduction applied above the excavation is equal to the original effective stress
+        at each corresponding depth.
+    excavation_width:
+        Width of the excavation [m]. Used to calculate the stress reduction due to the excavation if the Begemann method is selected.
+        In this case, it must be provided and it must be > 0.
+    excavation_edge_distance:
+        Distance from the pile centerline to the excavation edge [m]. Used to calculate the stress reduction due to the excavation if
+        the Begemann method is selected. In this case, it must be provided and it must be between 0.0 and 0.5 * excavation_width.
+
+        Note that:
+            - 0.0 means that the pile is located at the edge of the excavation.
+            - 0.5 * excavation_width means that the pile is at the center of the excavation.
     overrule_xi:
         Set a fixed value for xi in all calculations. Use with caution. This will
         overrule the calculation of xi-values based on the group-size, variation-
@@ -219,6 +243,16 @@ def create_multi_cpt_payload(
     # Add optional properties
     if excavation_depth_nap is not None:
         multi_cpt_payload["excavation_depth_nap"] = excavation_depth_nap
+    if excavation_stress_reduction_method == "constant":
+        multi_cpt_payload["excavation_settings"] = dict(
+            stress_reduction_method="constant"
+        )
+    else:
+        multi_cpt_payload["excavation_settings"] = dict(
+            stress_reductin_method="begemann",
+            excavation_width=excavation_width,
+            excavation_edge_distance=excavation_edge_distance,
+        )
     if overrule_xi is not None:
         multi_cpt_payload["overrule_xi"] = overrule_xi
     if pile_grid is not None: