py-pilecore 1.0.4__tar.gz → 1.1.1__tar.gz

{py_pilecore-1.0.4/src/py_pilecore.egg-info → py_pilecore-1.1.1}/PKG-INFO

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

{py_pilecore-1.0.4 → py_pilecore-1.1.1}/pyproject.toml

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

{py_pilecore-1.0.4 → py_pilecore-1.1.1/src/py_pilecore.egg-info}/PKG-INFO

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

{py_pilecore-1.0.4 → py_pilecore-1.1.1}/src/pypilecore/_version.py

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

{py_pilecore-1.0.4 → py_pilecore-1.1.1}/src/pypilecore/common/piles/main.py

@@ -145,6 +145,8 @@ def create_basic_pile(
     height_base :
         The height [m] of the base component, by default None.
         Required if base dimensions are provided.
+        Note: When standard is CUR236, `height_base` should be None, making the
+        shaft dimensions equal to the base dimensions.
     core_secondary_dimension :
         The largest dimension [m] of the rectangular core component's cross-section, by default None.
         Required for rectangular piles.

{py_pilecore-1.0.4 → py_pilecore-1.1.1}/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,
@@ -102,6 +105,21 @@ def create_multi_cpt_payload(
             - Literal["surface"] (default).
                 In this case, the soil_properties.service_level
                 property is used.
+    top_of_tension_zone_nap:
+        The level [w.r.t. NAP] of the top of the tension zone from which the uplift capacity
+        (tension) is calculated. If None, the top of the tension zone is set to the `pile_head_level_nap`.
+        Note that PileCore will automatically apply the remarks regarding L;a in CUR236 6.1.1. if
+        this standard is selected.
+    individual_top_of_tension_zone_nap:
+        A dictionary, mapping specific CPTs (using the `CPTData.alias`` as keys) to `top_of_tension_zone_nap`
+        (as values). This will overrule the general `top_of_tension_zone_nap` setting for these specific
+        CPTs only.
+        Example: {"S03": 1.5}
+    individual_ocr:
+        A dictionary, mapping specific CPTs (using the `CPTData.alias`` as keys) to Over-Consolidation-Ratio [-]
+        of the foundation layer (as values). This will overrule the general `ocr` setting for
+        these specific CPTs only.
+        Example: {"S03": 1.5}
     excavation_depth_nap:
         Soil excavation depth after the CPT was taken. Unit: [m] w.r.t. NAP.
     excavation_param_t:
@@ -111,6 +129,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 +258,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: