py-pilecore 1.0.4__py3-none-any.whl → 1.1.0__py3-none-any.whl

{py_pilecore-1.0.4.dist-info → py_pilecore-1.1.0.dist-info}/METADATA

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

{py_pilecore-1.0.4.dist-info → py_pilecore-1.1.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
-py_pilecore-1.0.4.dist-info/licenses/LICENSE,sha256=3OCAZXffN0Bettjeya8uF_ZYegyvvCfH1WUt6CrHb_0,1061
+py_pilecore-1.1.0.dist-info/licenses/LICENSE,sha256=3OCAZXffN0Bettjeya8uF_ZYegyvvCfH1WUt6CrHb_0,1061
 pypilecore/__init__.py,sha256=oJvwYShj_7FyNVlUgQda4tTdYyLIi5H1asdiS_uYt9M,162
-pypilecore/_version.py,sha256=jnzhNYs6bqTiyDu0QEsVMOEnDNnEsaMyuGkSRaAqPJ8,175
+pypilecore/_version.py,sha256=PyJLtz0HZcv4-hyOrJwfzhKhc_UHNEdFjzKgtq-wJ70,175
 pypilecore/api.py,sha256=U41P6_N5ihwIv91kayrI7cs_KTo2M5HfJGqO6K6aJVE,9959
 pypilecore/exceptions.py,sha256=-MZOfsxyHLCI0k1-wZFfVsMxc1lya5buuhLks5rxlCo,89
 pypilecore/plot_utils.py,sha256=rK5_067-4-x7LzZgt_t6ahcGrZInxNrqHqsy0RzCnq8,954
@@ -21,7 +21,7 @@ pypilecore/input/__init__.py,sha256=Gyqsp6zqc8AYnIp17SfqbBNjDaUkRgAam8x2r0XibwM,
 pypilecore/input/grouper_properties.py,sha256=mCJ590bS-tDKUgxJW_LIzIEtoMrYAQiE48rJb6QwNsY,11168
 pypilecore/input/multi_cpt.py,sha256=QKhEWzNVnPe7C8OSSSj1z3XNgQ7Z5RG7J9SnK9gM4rE,18598
 pypilecore/input/soil_properties.py,sha256=Uh6rFUZUPMzFyQI9yon9PMMwOn8lAUZVa_XHx3AC-5Y,10142
-pypilecore/input/tension.py,sha256=wbVAs3maYbUDzarq_DOQSR00QYVDh4Mkbaxb-hz4E08,11921
+pypilecore/input/tension.py,sha256=eIUVjweEN1JHodkRURVSFunDJSmAoVzObOaIja8PSWo,14239
 pypilecore/results/__init__.py,sha256=UCMRRVNZxHTtTD4yTrJ-vpHy-Pga8vvxRu45d8pu5DM,844
 pypilecore/results/cases_multi_cpt_results.py,sha256=meCqFDBCGiSwgmwSzvTLxF5Z0HYkKK-LKrvDp5rAUy8,10253
 pypilecore/results/grouper_result.py,sha256=35Yx8VsIT1hridIZLhgcrqBtxszWvaUljBDroFhzCdg,31006
@@ -43,7 +43,7 @@ pypilecore/viewers/interactive_figures/figure_cpt_group_results_versus_ptls.py,s
 pypilecore/viewers/interactive_figures/figure_cpt_results_plan_view.py,sha256=6je5ALYihQ_9bMbT_rinByCgHfQ61dWB6zzDhiL_iCQ,9380
 pypilecore/viewers/interactive_figures/figure_cpt_results_versus_ptls.py,sha256=Kaaw1HT4d-fA5DJzvBHbE3yg-I-fWzxhE8gUxfPWahU,6046
 pypilecore/viewers/interactive_figures/utils.py,sha256=B2X8hbbmJqjm8E2VrS2EoX5F1yQ5qOQnQUG_vbsseT8,1692
-py_pilecore-1.0.4.dist-info/METADATA,sha256=0iaVPSY9tdplCUQgkIqiYzahxvr6G2OlJUJkNCXC7fM,5970
-py_pilecore-1.0.4.dist-info/WHEEL,sha256=wXxTzcEDnjrTwFYjLPcsW_7_XihufBwmpiBeiXNBGEA,91
-py_pilecore-1.0.4.dist-info/top_level.txt,sha256=7BKIWZuSkbQtJ0ho5P1JvcaEbHzqADCcBuOduZmIaiI,11
-py_pilecore-1.0.4.dist-info/RECORD,,
+py_pilecore-1.1.0.dist-info/METADATA,sha256=8gP0-JdMQtKKA1eHFHoJojXIGrc6uqUiqXJAeTXZIUQ,5970
+py_pilecore-1.1.0.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+py_pilecore-1.1.0.dist-info/top_level.txt,sha256=7BKIWZuSkbQtJ0ho5P1JvcaEbHzqADCcBuOduZmIaiI,11
+py_pilecore-1.1.0.dist-info/RECORD,,

{py_pilecore-1.0.4.dist-info → py_pilecore-1.1.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.1.0)
+Generator: setuptools (80.3.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pypilecore/_version.py

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

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: