feat: vertex references

doc/changelog.d/2083.added.md

@@ -0,0 +1 @@
+Vertex references

src/ansys/geometry/core/_grpc/_services/base/bodies.py

@@ -119,6 +119,11 @@ def get_edges(self, **kwargs) -> dict:
         """Get the edges of a body."""
         pass
 
+    @abstractmethod
+    def get_vertices(self, **kwargs) -> dict:
+        """Get the vertices of a body."""
+        pass
+
     @abstractmethod
     def get_volume(self, **kwargs) -> dict:
         """Get the volume of a body."""

src/ansys/geometry/core/_grpc/_services/base/edges.py

@@ -69,6 +69,11 @@ def get_faces(self, **kwargs) -> dict:
         """Get the faces that are connected to the edge."""
         pass
 
+    @abstractmethod
+    def get_vertices(self, **kwargs) -> dict:
+        """Get the vertices that are connected to the edge."""
+        pass
+
     @abstractmethod
     def get_bounding_box(self, **kwargs) -> dict:
         """Get the bounding box of the edge."""

src/ansys/geometry/core/_grpc/_services/base/faces.py

@@ -59,6 +59,11 @@ def get_edges(self, **kwargs) -> dict:
         """Get the edges of a face."""
         pass
 
+    @abstractmethod
+    def get_vertices(self, **kwargs) -> dict:
+        """Get the vertices of a face."""
+        pass
+
     @abstractmethod
     def get_loops(self, **kwargs) -> dict:
         """Get the loops of a face."""

src/ansys/geometry/core/_grpc/_services/v0/bodies.py

@@ -383,6 +383,22 @@ def get_edges(self, **kwargs) -> dict:  # noqa: D102
             ]
         }
 
+    @protect_grpc
+    def get_vertices(self, **kwargs) -> dict:  # noqa: D102
+        # Call the gRPC service
+        resp = self.stub.GetVertices(request=build_grpc_id(kwargs["id"]))
+
+        # Return the response - formatted as a dictionary
+        return {
+            "vertices": [
+                {
+                    "id": vertex.id.id,
+                    "position": from_grpc_point_to_point3d(vertex.position),
+                }
+                for vertex in resp.vertices
+            ]
+        }
+
     @protect_grpc
     def get_volume(self, **kwargs) -> dict:  # noqa: D102
         # Call the gRPC service

src/ansys/geometry/core/_grpc/_services/v0/edges.py

@@ -138,6 +138,27 @@ def get_faces(self, **kwargs) -> dict:  # noqa: D102
             ],
         }
 
+    @protect_grpc
+    def get_vertices(self, **kwargs) -> dict:  # noqa: D102
+        from ansys.api.geometry.v0.edges_pb2 import GetVerticesRequest
+
+        # Create the request - assumes all inputs are valid and of proper type
+        request = GetVerticesRequest(edge=build_grpc_id(kwargs["id"]))
+
+        # Call the gRPC service
+        response = self.stub.GetVertices(request=request)
+
+        # Return the response - formatted as a dictionary
+        return {
+            "vertices": [
+                {
+                    "id": vertex.id.id,
+                    "position": from_grpc_point_to_point3d(vertex.position),
+                }
+                for vertex in response.vertices
+            ],
+        }
+
     @protect_grpc
     def get_bounding_box(self, **kwargs) -> dict:  # noqa: D102
         # Create the request - assumes all inputs are valid and of the proper type

src/ansys/geometry/core/_grpc/_services/v0/faces.py

@@ -114,6 +114,27 @@ def get_edges(self, **kwargs) -> dict:  # noqa: D102
             ]
         }
 
+    @protect_grpc
+    def get_vertices(self, **kwargs) -> dict:  # noqa: D102
+        # Create the request - assumes all inputs are valid and of the proper type
+        from ansys.api.geometry.v0.faces_pb2 import GetVerticesRequest
+
+        request = GetVerticesRequest(face_id=build_grpc_id(kwargs["id"]))
+
+        # Call the gRPC service
+        response = self.stub.GetVertices(request=request)
+
+        # Return the response - formatted as a dictionary
+        return {
+            "vertices": [
+                {
+                    "id": vertex.id.id,
+                    "position": from_grpc_point_to_point3d(vertex.position),
+                }
+                for vertex in response.vertices
+            ]
+        }
+
     @protect_grpc
     def get_loops(self, **kwargs) -> dict:  # noqa: D102
         # Create the request - assumes all inputs are valid and of the proper type

src/ansys/geometry/core/_grpc/_services/v0/named_selection.py

@@ -67,6 +67,7 @@ def get_named_selection(self, **kwargs):  # noqa: D102
             "beams": [beam.id.id for beam in response.beams],
             "design_points": [(dp.id, dp.points[0]) for dp in response.design_points],
             "components": [comp.id for comp in response.components],
+            "vertices": [vertex.id.id for vertex in response.vertices],
         }
 
     @protect_grpc
@@ -92,6 +93,7 @@ def create_named_selection(self, **kwargs):  # noqa: D102
             "beams": [beam.id.id for beam in response.beams],
             "design_points": [dp.id for dp in response.design_points],
             "components": [comp.id for comp in response.components],
+            "vertices": [vertex.id.id for vertex in response.vertices],
         }
 
     @protect_grpc

src/ansys/geometry/core/_grpc/_services/v1/bodies.py

@@ -112,6 +112,10 @@ def get_faces(self, **kwargs) -> dict:  # noqa: D102
     def get_edges(self, **kwargs) -> dict:  # noqa: D102
         raise NotImplementedError
 
+    @protect_grpc
+    def get_vertices(self, **kwargs) -> dict:  # noqa: D102
+        raise NotImplementedError
+
     @protect_grpc
     def get_volume(self, **kwargs) -> dict:  # noqa: D102
         raise NotImplementedError

src/ansys/geometry/core/_grpc/_services/v1/edges.py

@@ -71,6 +71,10 @@ def get_interval(self, **kwargs) -> dict:  # noqa: D102
     def get_faces(self, **kwargs) -> dict:  # noqa: D102
         return NotImplementedError
 
+    @protect_grpc
+    def get_vertices(self, **kwargs) -> dict:  # noqa: D102
+        return NotImplementedError
+
     @protect_grpc
     def get_bounding_box(self, **kwargs) -> dict:  # noqa: D102
         return NotImplementedError

src/ansys/geometry/core/_grpc/_services/v1/faces.py

@@ -63,6 +63,10 @@ def get_area(self, **kwargs) -> dict:  # noqa: D102
     def get_edges(self, **kwargs) -> dict:  # noqa: D102
         raise NotImplementedError
 
+    @protect_grpc
+    def get_vertices(self, **kwargs):  # noqa: D102
+        raise NotImplementedError
+
     @protect_grpc
     def get_loops(self, **kwargs) -> dict:  # noqa: D102
         raise NotImplementedError

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

@@ -52,6 +52,7 @@
 )
 from ansys.geometry.core.designer.edge import CurveType, Edge
 from ansys.geometry.core.designer.face import Face, SurfaceType
+from ansys.geometry.core.designer.vertex import Vertex
 from ansys.geometry.core.errors import protect_grpc
 from ansys.geometry.core.materials.material import Material
 from ansys.geometry.core.math.bbox import BoundingBox
@@ -239,6 +240,16 @@ def edges(self) -> list[Edge]:
         """
         return
 
+    @abstractmethod
+    def vertices(self) -> list[Vertex]:
+        """Get a list of all vertices within the body.
+
+        Returns
+        -------
+        list[Vertex]
+        """
+        return
+
     @abstractmethod
     def is_alive(self) -> bool:
         """Check if the body is still alive and has not been deleted."""
@@ -989,6 +1000,24 @@ def _get_edges_from_id(self, body: Union["Body", "MasterBody"]) -> list[Edge]:
             for edge_resp in response.get("edges")
         ]
 
+    @property
+    @min_backend_version(26, 1, 0)
+    def vertices(self) -> list[Vertex]:  # noqa: D102
+        return self._get_vertices_from_id(self)
+
+    def _get_vertices_from_id(self, body: Union["Body", "MasterBody"]) -> list[Vertex]:
+        """Retrieve vertices from a body ID."""
+        self._grpc_client.log.debug(f"Retrieving vertices for body {body.id} from server.")
+        response = self._grpc_client.services.bodies.get_vertices(id=body.id)
+
+        return [
+            Vertex(
+                vertex_resp.get("id"),
+                vertex_resp.get("position"),
+            )
+            for vertex_resp in response.get("vertices")
+        ]
+
     @property
     def is_alive(self) -> bool:  # noqa: D102
         return self._is_alive
@@ -1485,6 +1514,11 @@ def faces(self) -> list[Face]:  # noqa: D102
     def edges(self) -> list[Edge]:  # noqa: D102
         return self._template._get_edges_from_id(self)
 
+    @property
+    @ensure_design_is_active
+    def vertices(self) -> list[Vertex]:  # noqa: D102
+        return self._template._get_vertices_from_id(self)
+
     @property
     def _is_alive(self) -> bool:  # noqa: D102
         return self._template.is_alive

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

@@ -63,6 +63,7 @@
 from ansys.geometry.core.designer.face import Face
 from ansys.geometry.core.designer.part import MasterComponent, Part
 from ansys.geometry.core.designer.selection import NamedSelection
+from ansys.geometry.core.designer.vertex import Vertex
 from ansys.geometry.core.errors import protect_grpc
 from ansys.geometry.core.materials.material import Material
 from ansys.geometry.core.materials.property import MaterialProperty, MaterialPropertyType
@@ -608,6 +609,7 @@ def create_named_selection(
         beams: list[Beam] | None = None,
         design_points: list[DesignPoint] | None = None,
         components: list[Component] | None = None,
+        vertices: list[Vertex] | None = None,
     ) -> NamedSelection:
         """Create a named selection on the active Geometry server instance.
 
@@ -627,6 +629,8 @@ def create_named_selection(
             All design points to include in the named selection.
         components : list[Component], default: None
             All components to include in the named selection.
+        vertices : list[Vertex], default: None
+            All vertices to include in the named selection.
 
         Returns
         -------
@@ -640,10 +644,10 @@ def create_named_selection(
             one of the optional parameters must be provided.
         """
         # Verify that at least one entity is provided
-        if not any([bodies, faces, edges, beams, design_points, components]):
+        if not any([bodies, faces, edges, beams, design_points, components, vertices]):
             raise ValueError(
                 "At least one of the following must be provided: "
-                "bodies, faces, edges, beams, design_points, or components."
+                "bodies, faces, edges, beams, design_points, components, or vertices."
             )
 
         named_selection = NamedSelection(
@@ -656,6 +660,7 @@ def create_named_selection(
             beams=beams,
             design_points=design_points,
             components=components,
+            vertices=vertices,
         )
 
         self._named_selections[named_selection.name] = named_selection

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

@@ -38,6 +38,7 @@
 if TYPE_CHECKING:  # pragma: no cover
     from ansys.geometry.core.designer.body import Body
     from ansys.geometry.core.designer.face import Face
+    from ansys.geometry.core.designer.vertex import Vertex
 
 
 @unique
@@ -176,6 +177,24 @@ def faces(self) -> list["Face"]:
             for face_resp in response.get("faces")
         ]
 
+    @property
+    @ensure_design_is_active
+    @min_backend_version(26, 1, 0)
+    def vertices(self) -> list["Vertex"]:
+        """Vertices that define the edge."""
+        from ansys.geometry.core.designer.vertex import Vertex
+
+        self._grpc_client.log.debug("Requesting edge vertices from server.")
+        response = self._grpc_client.services.edges.get_vertices(id=self._id)
+
+        return [
+            Vertex(
+                vertex_resp.get("id"),
+                vertex_resp.get("position"),
+            )
+            for vertex_resp in response.get("vertices")
+        ]
+
     @property
     @ensure_design_is_active
     def start(self) -> Point3D:

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

@@ -33,6 +33,7 @@
 from ansys.api.geometry.v0.commands_pb2_grpc import CommandsStub
 from ansys.geometry.core.connection.client import GrpcClient
 from ansys.geometry.core.designer.edge import Edge
+from ansys.geometry.core.designer.vertex import Vertex
 from ansys.geometry.core.errors import GeometryRuntimeError, protect_grpc
 from ansys.geometry.core.math.bbox import BoundingBox
 from ansys.geometry.core.math.point import Point3D
@@ -263,6 +264,22 @@ def edges(self) -> list[Edge]:
             for edge in response.get("edges")
         ]
 
+    @property
+    @ensure_design_is_active
+    @min_backend_version(26, 1, 0)
+    def vertices(self) -> list[Vertex]:
+        """List of all vertices of the face."""
+        self._grpc_client.log.debug("Requesting face vertices from server.")
+        response = self._grpc_client.services.faces.get_vertices(id=self.id)
+
+        return [
+            Vertex(
+                vertex_resp.get("id"),
+                vertex_resp.get("position"),
+            )
+            for vertex_resp in response.get("vertices")
+        ]
+
     @property
     @ensure_design_is_active
     def loops(self) -> list[FaceLoop]: