engeom 0.2.10__cp38-abi3-macosx_11_0_arm64.whl → 0.2.12__cp38-abi3-macosx_11_0_arm64.whl

engeom/geom2.pyi

@@ -138,6 +138,22 @@ class Vector2(Iterable[float]):
         """
         ...
 
+    def with_x(self, x: float) -> Vector2:
+        """
+        Return a new vector with the same y component as this vector, but with the x component set to the given value.
+        :param x: the new x component of the vector.
+        :return: a new vector with the same y component as this vector, but with the x component set to the given value.
+        """
+        ...
+
+    def with_y(self, y: float) -> Vector2:
+        """
+        Return a new vector with the same x component as this vector, but with the y component set to the given value.
+        :param y: the new y component of the vector.
+        :return: a new vector with the same x component as this vector, but with the y component set to the given value.
+        """
+        ...
+
 
 class Point2(Iterable[float]):
     """
@@ -243,6 +259,22 @@ class Point2(Iterable[float]):
         """
         ...
 
+    def with_x(self, x: float) -> Point2:
+        """
+        Return a new point with the same y component as this point, but with the x component set to the given value.
+        :param x: the new x component of the point.
+        :return: a new point with the same y component as this point, but with the x component set to the given value.
+        """
+        ...
+
+    def with_y(self, y: float) -> Point2:
+        """
+        Return a new point with the same x component as this point, but with the y component set to the given value.
+        :param y: the new y component of the point.
+        :return: a new point with the same x component as this point, but with the y component set to the given value.
+        """
+        ...
+
 
 class SurfacePoint2:
     """
@@ -950,6 +982,43 @@ class Circle2:
         """
         ...
 
+    @staticmethod
+    def fitting(points: NDArray[float], guess: Circle2 | None = None, sigma: float | None = None) -> Circle2:
+        """
+        Fit a circle to a set of points using an unconstrained Levenberg-Marquardt minimization of the sum of
+        squared errors between the points and the boundary of the circle.
+
+        The initial guess is used to provide a starting point for the optimization. If no guess is provided, the
+        unit circle will be used.
+
+        The sigma parameter is used to weight the points in the optimization. If no sigma is provided, all points
+        will be weighted equally, otherwise points beyond `sigma` standard deviations from the mean will be
+        assigned a weight of 0.0.
+        :param points: the points to fit the circle to.
+        :param guess: an optional initial guess for the circle. If None, the unit circle will be used.
+        :param sigma: an optional standard deviation to use for weighting the points. If None, all points will be
+        weighted equally.
+        :return: a new `Circle2` object representing the fitted circle.
+        """
+        ...
+
+    @staticmethod
+    def ransac(points: NDArray[float], tol: float, iterations: int | None = None, min_r: float | None = None,
+               max_r: float | None = None) -> Circle2:
+        """
+        Fit a circle to a set of points using the RANSAC algorithm. The algorithm will randomly sample points from the
+        input set and fit a circle to them, then check how many points are within the given tolerance of the fitted
+        circle. The best fitting circle will be returned.
+
+        :param points: the points to fit the circle to.
+        :param tol: the tolerance for the RANSAC algorithm.
+        :param iterations: the number of iterations to run. If None, a default value of 500 will be used.
+        :param min_r: the minimum radius of the circle. If None, no minimum will be enforced.
+        :param max_r: the maximum radius of the circle. If None, no maximum will be enforced.
+        :return: a new `Circle2` object representing the fitted circle.
+        """
+        ...
+
 
 class Arc2:
     """
@@ -1148,3 +1217,11 @@ class Aabb2:
         :return: a new AABB object with the shrunk bounds.
         """
         ...
+
+    def merged(self, other: Aabb2) -> Aabb2:
+        """
+        Merge this AABB with another AABB and return a new AABB.
+        :param other: the other AABB to merge with.
+        :return: a new AABB object that is the result of merging this AABB with the other AABB.
+        """
+        ...

engeom/geom3.pyi

@@ -150,6 +150,33 @@ class Vector3(Iterable[float]):
         """
         ...
 
+    def with_x(self, x: float) -> Vector3:
+        """
+        Return a new vector with the same y and z components as this vector, but with the x component set to the
+        specified value.
+        :param x: the new x component of the vector.
+        :return: a new vector with the specified x component.
+        """
+        ...
+
+    def with_y(self, y: float) -> Vector3:
+        """
+        Return a new vector with the same x and z components as this vector, but with the y component set to the
+        specified value.
+        :param y: the new y component of the vector.
+        :return: a new vector with the specified y component.
+        """
+        ...
+
+    def with_z(self, z: float) -> Vector3:
+        """
+        Return a new vector with the same x and y components as this vector, but with the z component set to the
+        specified value.
+        :param z: the new z component of the vector.
+        :return: a new vector with the specified z component.
+        """
+        ...
+
 
 class Point3(Iterable[float]):
     """
@@ -267,6 +294,33 @@ class Point3(Iterable[float]):
         """
         ...
 
+    def with_x(self, x: float) -> Point3:
+        """
+        Return a new point with the same y and z coordinates as this point, but with the x coordinate set to the
+        specified value.
+        :param x: the new x coordinate of the point.
+        :return: a new point with the specified x coordinate.
+        """
+        ...
+
+    def with_y(self, y: float) -> Point3:
+        """
+        Return a new point with the same x and z coordinates as this point, but with the y coordinate set to the
+        specified value.
+        :param y: the new y coordinate of the point.
+        :return: a new point with the specified y coordinate.
+        """
+        ...
+
+    def with_z(self, z: float) -> Point3:
+        """
+        Return a new point with the same x and y coordinates as this point, but with the z coordinate set to the
+        specified value.
+        :param z: the new z coordinate of the point.
+        :return: a new point with the specified z coordinate.
+        """
+        ...
+
 
 class SurfacePoint3:
     """
@@ -461,6 +515,29 @@ class Iso3:
         """
         ...
 
+    @staticmethod
+    def from_xyzwpr(x: float, y: float, z: float, w: float, p: float, r: float) -> Iso3:
+        """
+        Create an isometry from the specified translation and rotation angles in yaw, pitch, and roll format, following
+        the convention typically used in robotics. The angles are specified in degrees.
+        :param x:
+        :param y:
+        :param z:
+        :param w:
+        :param p:
+        :param r:
+        :return:
+        """
+        ...
+
+    def to_xyzwpr(self) -> List[float]:
+        """
+        Convert the isometry to a list of translation and rotation angles in yaw, pitch, and roll format, following the
+        convention typically used in robotics. The angles are returned in degrees.
+        :return: a list of 6 floats representing the translation and rotation angles.
+        """
+        ...
+
     def __matmul__(self, other: Transformable3) -> Transformable3:
         """
         Multiply another object by the isometry, transforming it and returning a new object of the same type.
@@ -537,6 +614,14 @@ class Iso3:
         """
         ...
 
+    @property
+    def origin(self) -> Point3:
+        """
+        Get the origin of the isometry as a Point3 object.
+        :return: a Point3 object representing the origin of the isometry.
+        """
+        ...
+
     def translation(self) -> Iso3:
         """
         Return the translation component of the isometry as a separate isometry.
@@ -1157,14 +1242,14 @@ class Mesh:
         ...
 
     @staticmethod
-    def create_box(width: float, height: float, depth: float) -> Mesh:
+    def create_box(length: float, width: float, height: float) -> Mesh:
         """
-        Creates a box with the corner at the origin and the specified width, height, and depth all positive.
+        Creates a box with the center at the origin and the specified length, width, and height
 
-        :param width:
-        :param height:
-        :param depth:
-        :return:
+        :param length: the size of the box along the X-axis
+        :param width: the size of the box along the Y-axis
+        :param height: the size of the box along the Z-axis
+        :return: a new `Mesh` object representing the box
         """
         ...
 
@@ -1172,14 +1257,92 @@ class Mesh:
     def create_cylinder(radius: float, height: float, steps: int) -> Mesh:
         """
         Creates a cylinder with a radius and height. The cylinder will be centered at the origin and oriented along the
-        Z-axis. The bottom of the cylinder will be at Z = 0 and the top will be at Z = height. The cylinder will be
-        created with a number of steps around the circumference, which will determine the number of vertices used to
-        create the cylinder. The number of steps should be at least 3. The first set of vertices will be at X = radius,
-        Y = 0.
-        :param radius:
-        :param height:
-        :param steps:
-        :return:
+        Y-axis.
+
+        :param radius: the radius of the cylinder
+        :param height: the size of the cylinder along the Y-axis
+        :param steps: the number of subdivisions to create vertices around the cylinder. The more steps the smoother the
+        cylinder will be.
+        :return: a new `Mesh` object representing the cylinder
+        """
+        ...
+
+    @staticmethod
+    def create_sphere(radius: float, n_theta: int, n_phi: int) -> Mesh:
+        """
+        Creates a sphere with a radius. The sphere will be centered at the origin. The step counts `n_theta` and `n_phi`
+        will determine the smoothness of the sphere in the radial (n_theta) and polar (n_phi) directions. The poles
+        will be located at Y=+radius and Y=-radius, and the equator will lie in the XZ plane.
+
+        :param radius: the radius of the sphere
+        :param n_theta: the number of subdivisions to create vertices around the sphere in the theta direction
+        :param n_phi: the number of subdivisions to create vertices around the sphere in the phi direction
+        :return: a new `Mesh` object representing the sphere
+        """
+        ...
+
+    @staticmethod
+    def create_cone(radius: float, height: float, steps: int) -> Mesh:
+        """
+        Creates a cone with a radius and height. The cone will be centered at the origin and oriented so that the
+        point of the cone is located at Y=height/2 and the base is located at Y=-height/2.
+
+        :param radius: the radius of the base of the cone
+        :param height: the size of the cone along the Y-axis
+        :param steps: the number of subdivisions to create vertices around the cone. The more steps the smoother the
+        cone will be.
+        :return: a new `Mesh` object representing the cone
+        """
+        ...
+
+    @staticmethod
+    def create_capsule(p0: Point3, p1: Point3, radius: float, n_theta: int, n_phi: int) -> Mesh:
+        """
+        Creates a capsule shape between two points with a specified radius. The capsule will be centered between the two
+        points and oriented along the line connecting them. The step counts `n_theta` and `n_phi` will determine the
+        smoothness of the sphere in the radial (n_theta) and polar (n_phi) directions.
+
+        :param p0: the first point of the capsule
+        :param p1: the second point of the capsule
+        :param radius: the radius of the capsule
+        :param n_theta: the number of subdivisions to create vertices around the sphere in the theta direction
+        :param n_phi: the number of subdivisions to create vertices around the sphere in the phi direction
+        :return: a new `Mesh` object representing the capsule
+        """
+        ...
+
+    @staticmethod
+    def create_cylinder_between(p0: Point3, p1: Point3, radius: float, steps: int) -> Mesh:
+        """
+        Creates a cylinder between two points with a specified radius. The cylinder will be centered between the two
+        points and oriented along the line connecting them.
+
+        :param p0: the first point of the cylinder
+        :param p1: the second point of the cylinder
+        :param radius: the radius of the cylinder
+        :param steps: the number of subdivisions to create vertices around the cylinder. The more steps the smoother the
+        cylinder will be.
+        :return: a new `Mesh` object representing the cylinder
+        """
+        ...
+
+    @staticmethod
+    def create_rect_beam_between(p0: Point3, p1: Point3, width: float, height: float,
+                                 up: Vector3 | None = None) -> Mesh:
+        """
+        Create a rectangular cross-sectioned prism between two points with a specified width and height. The prism will
+        be centered between the two points and oriented along the line connecting them. The up vector's projection onto
+        the line connecting the two end points will determine the direction of the height of the prism. If None, the
+        height will be aligned with the projection of the Z-axis.
+
+        If the up vector is parallel to the line connecting the two points, an error will be thrown.
+
+        :param p0: the first point of the prism
+        :param p1: the second point of the prism
+        :param width: the width of the prism
+        :param height: the height of the prism
+        :param up: the up vector to use for the height direction. If None, the Z-axis will be used
+        :return: a new `Mesh` object representing the prism
         """
         ...
 
@@ -1304,6 +1467,7 @@ class MeshCollisionSet:
         """
         ...
 
+
 class CurveStation3:
     """
     A class representing a station along a curve in 3D space. The station is represented by a point on the curve, a
@@ -1578,6 +1742,15 @@ class Aabb3:
         """
         ...
 
+    def merged(self, other: Aabb3) -> Aabb3:
+        """
+        Merge this AABB with another AABB. The resulting AABB will be the smallest AABB that contains both AABBs.
+
+        :param other: the other AABB to merge with.
+        :return: a new AABB object representing the merged bounds.
+        """
+        ...
+
 
 class RayBundle3:
     """

{engeom-0.2.10.dist-info → engeom-0.2.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: engeom
-Version: 0.2.10
+Version: 0.2.12
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy

{engeom-0.2.10.dist-info → engeom-0.2.12.dist-info}/RECORD

@@ -1,8 +1,8 @@
-engeom-0.2.10.dist-info/METADATA,sha256=pspg1fX2bXgPBv5Ohzo6PabHa0gSDMki855BQddwTOo,495
-engeom-0.2.10.dist-info/WHEEL,sha256=KOb2uEsUFKFV_GOdT9ev2YJZGn1-e8xqWy3VUx4M6FQ,102
+engeom-0.2.12.dist-info/METADATA,sha256=oj_j8a0BXohXxgNPJ9iTWDa2cOEseTP6Kkq_pmad9Qk,495
+engeom-0.2.12.dist-info/WHEEL,sha256=KOb2uEsUFKFV_GOdT9ev2YJZGn1-e8xqWy3VUx4M6FQ,102
 engeom/raster3.pyi,sha256=sBXXYXcDBiDU_OFDQiwa7Q3GcwSiUc4CLy6nJ1MwFqM,790
-engeom/geom2.pyi,sha256=uMi4WD6-DtFx8H-RZsKIi-p1fN4p8SzOfBZmEuvNGDU,44357
-engeom/geom3.pyi,sha256=VYxc9kZQhfHNN13E1DpAzea9z6R6gvpKtxyL8Wm9oWU,69140
+engeom/geom2.pyi,sha256=Gg6Dw9yKOjc_1-sJiBPWDbGgQH5P5g6Ac80XRS-ziSQ,48330
+engeom/geom3.pyi,sha256=p6wiyIRMNFVBe6zgNGkDVqC1JRysq5OwwO654BPWoOI,76829
 engeom/geom3/__init__.py,sha256=l8B0iDhJ4YiRbslJLN791XWai2DWrpmZptnzIETMS9g,370
 engeom/geom2/__init__.py,sha256=JFpiLyROUh6vyakG-7JDSlCMCn4QB2MQ8bz3uVCaAIk,373
 engeom/plot.py,sha256=LTqqO-h1EJL6wanM0hB79s9ohWwaCIijMOHVplY3vmc,1079
@@ -21,5 +21,5 @@ engeom/engeom.pyi,sha256=BtUBtYZ_MX8Xk2x_FyzVxRXjJQIazQ1xscbCLO_Y3HA,1516
 engeom/sensor.pyi,sha256=a9y62FqhG-CFFHnJiC03PqBpFtxtfkH0zoDkk9LXWnU,1399
 engeom/metrology.pyi,sha256=9I5un86VB_2gmQBrVYhX8JzILTUADMLB9Em8ttJxrWg,4044
 engeom/align.pyi,sha256=QCSKrTLkCoaIubcrPU9J-wDZe1lRP0GbPgWZmonXjo0,997
-engeom/engeom.abi3.so,sha256=AUo6dtmxpTG-aw6385vW5HNhzwKIJbxJd6FXLExO3ug,2983744
-engeom-0.2.10.dist-info/RECORD,,
+engeom/engeom.abi3.so,sha256=CWsULIWo1ZV-Ux2V1q4w-f5oJdf2oswTO17T5NWutmk,3087152
+engeom-0.2.12.dist-info/RECORD,,