feat: add chamfer tool

doc/changelog.d/1495.added.md

@@ -0,0 +1 @@
+add chamfer tool

pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
 ]
 
 dependencies = [
-    "ansys-api-geometry==0.4.11",
+    "ansys-api-geometry==0.4.12",
     "ansys-tools-path>=0.3,<1",
     "ansys-tools-visualization-interface>=0.2.6,<1",
     "beartype>=0.11.0,<0.20",

src/ansys/geometry/core/designer/body.py

@@ -1206,11 +1206,15 @@ def reset_tessellation_cache(func):  # noqa: N805
 
         @wraps(func)
         def wrapper(self: "Body", *args, **kwargs):
-            self._template._tessellation = None
+            self._reset_tessellation_cache()
             return func(self, *args, **kwargs)
 
         return wrapper
 
+    def _reset_tessellation_cache(self):  # noqa: N805
+        """Reset the cached tessellation for a body."""
+        self._template._tessellation = None
+
     @property
     def id(self) -> str:  # noqa: D102
         return self._id

src/ansys/geometry/core/designer/edge.py

@@ -100,6 +100,11 @@ def _grpc_id(self) -> EntityIdentifier:
         """Entity ID of this edge on the server side."""
         return EntityIdentifier(id=self._id)
 
+    @property
+    def body(self) -> "Body":
+        """Body of the edge."""
+        return self._body
+
     @property
     def is_reversed(self) -> bool:
         """Flag indicating if the edge is reversed."""

src/ansys/geometry/core/modeler.py

@@ -42,6 +42,7 @@
 from ansys.geometry.core.misc.options import ImportOptions
 from ansys.geometry.core.tools.measurement_tools import MeasurementTools
 from ansys.geometry.core.tools.prepare_tools import PrepareTools
+from ansys.geometry.core.tools.pull_tools import PullTools
 from ansys.geometry.core.tools.repair_tools import RepairTools
 from ansys.geometry.core.typing import Real
 
@@ -128,6 +129,7 @@ def __init__(
             self._repair_tools = RepairTools(self._grpc_client)
             self._prepare_tools = PrepareTools(self._grpc_client)
             self._measurement_tools = MeasurementTools(self._grpc_client)
+        self._pull_tools = PullTools(self._grpc_client)
 
         # Maintaining references to all designs within the modeler workspace
         self._designs: dict[str, "Design"] = {}
@@ -497,3 +499,8 @@ def prepare_tools(self) -> PrepareTools:
     def measurement_tools(self) -> MeasurementTools:
         """Access to measurement tools."""
         return self._measurement_tools
+
+    @property
+    def pull_tools(self) -> PullTools:
+        """Access to pull tools."""
+        return self._pull_tools

src/ansys/geometry/core/tools/__init__.py

@@ -28,5 +28,6 @@
     ExtraEdgeProblemAreas,
     InexactEdgeProblemAreas,
 )
+from ansys.geometry.core.tools.pull_tools import PullTools
 from ansys.geometry.core.tools.repair_tool_message import RepairToolMessage
 from ansys.geometry.core.tools.repair_tools import RepairTools

src/ansys/geometry/core/tools/pull_tools.py

@@ -0,0 +1,74 @@
+# Copyright (C) 2023 - 2024 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+"""Provides tools for pulling geometry."""
+
+from typing import TYPE_CHECKING, Union
+
+from ansys.api.geometry.v0.commands_pb2 import ChamferRequest
+from ansys.api.geometry.v0.commands_pb2_grpc import CommandsStub
+from ansys.geometry.core.connection import GrpcClient
+from ansys.geometry.core.errors import protect_grpc
+from ansys.geometry.core.misc.checks import min_backend_version
+from ansys.geometry.core.typing import Real
+
+if TYPE_CHECKING:  # pragma: no cover
+    from ansys.geometry.core.designer.edge import Edge
+    from ansys.geometry.core.designer.face import Face
+
+
+class PullTools:
+    """Pull tools for PyAnsys Geometry.
+
+    Parameters
+    ----------
+    grpc_client : GrpcClient
+        gRPC client to use for the measurement tools.
+    """
+
+    @protect_grpc
+    def __init__(self, grpc_client: GrpcClient):
+        """Initialize pull tools class."""
+        self._grpc_client = grpc_client
+        self._commands_stub = CommandsStub(self._grpc_client.channel)
+
+    @protect_grpc
+    @min_backend_version(25, 1, 0)
+    def chamfer(self, edge_or_face: Union["Edge", "Face"], distance: Real) -> bool:
+        """Create a chamfer on an edge, or adjust the chamfer of a face.
+
+        Parameters
+        ----------
+        edge_or_face : Edge | Face
+            Edge or face to act on.
+        distance : Real
+            Chamfer distance.
+
+        Returns
+        -------
+        bool
+            Success of chamfer command.
+        """
+        edge_or_face.body._reset_tessellation_cache()
+
+        result = self._commands_stub.Chamfer(ChamferRequest(id=edge_or_face.id, distance=distance))
+
+        return result.success

tests/integration/test_pull_tools.py

@@ -0,0 +1,50 @@
+# Copyright (C) 2023 - 2024 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+""" "Testing of repair tools."""
+
+from pint import Quantity
+import pytest
+
+from ansys.geometry.core.math.point import Point2D
+from ansys.geometry.core.misc import UNITS
+from ansys.geometry.core.modeler import Modeler
+from ansys.geometry.core.sketch.sketch import Sketch
+
+
+def test_chamfer(modeler: Modeler):
+    """Test chamfer on edge and face."""
+    design = modeler.create_design("chamfer")
+
+    body = design.extrude_sketch("box", Sketch().box(Point2D([0, 0]), 1, 1), 1)
+    assert len(body.faces) == 6
+    assert len(body.edges) == 12
+    assert body.volume.m == pytest.approx(Quantity(1, UNITS.m**3).m, rel=1e-6, abs=1e-8)
+
+    modeler.pull_tools.chamfer(body.edges[0], 0.1)
+    assert len(body.faces) == 7
+    assert len(body.edges) == 15
+    assert body.volume.m == pytest.approx(Quantity(0.995, UNITS.m**3).m, rel=1e-6, abs=1e-8)
+
+    modeler.pull_tools.chamfer(body.faces[-1], 0.5)
+    assert len(body.faces) == 7
+    assert len(body.edges) == 15
+    assert body.volume.m == pytest.approx(Quantity(0.875, UNITS.m**3).m, rel=1e-6, abs=1e-8)