adds docstrings

This commit is contained in:
Dogukan Karatas
2025-01-14 10:28:59 +01:00
parent 7c9058172f
commit fe6c18e97b
2 changed files with 13 additions and 19 deletions
+4 -16
View File
@@ -14,7 +14,7 @@ from specklepy.objects.models.units import (
@dataclass(kw_only=True)
class Plane(Base, ITransformable, IHasUnits, speckle_type="Objects.Geometry.Plane"):
"""
A 3-dimensional Plane consisting of an origin Point, and 3 Vectors as its X, Y and Z axis.
a plane consisting of an origin Point, and 3 Vectors as its X, Y and Z axis.
"""
origin: Point
@@ -34,7 +34,7 @@ class Plane(Base, ITransformable, IHasUnits, speckle_type="Objects.Geometry.Plan
def to_list(self) -> List[float]:
"""
Returns the values of this Plane as a list of numbers
returns the values of this Plane as a list of numbers
"""
result = []
result.extend(self.origin.to_list())
@@ -47,13 +47,7 @@ class Plane(Base, ITransformable, IHasUnits, speckle_type="Objects.Geometry.Plan
@classmethod
def from_list(cls, coords: List[float]) -> "Plane":
"""
Creates a new Plane based on a list of values and the unit they're drawn in.
Args:
coords: The list of values representing this plane
Returns:
A new Plane with the provided values
creates a new Plane based on a list of values
"""
units = get_units_from_encoding(int(coords[-1]))
@@ -69,13 +63,7 @@ class Plane(Base, ITransformable, IHasUnits, speckle_type="Objects.Geometry.Plan
def transform_to(self, transform) -> Tuple[bool, Base]:
"""
Transform this plane using the given transform
Args:
transform: The transform to apply
Returns:
Tuple of (success, transformed plane)
transform this plane using the given transform
"""
_, transformed_origin = self.origin.transform_to(transform)
_, transformed_normal = self.normal.transform_to(transform)
+9 -3
View File
@@ -20,7 +20,9 @@ class Transform(Base, speckle_type="Objects.Other.Transform"):
self.units = units
def convert_to_units(self, new_units):
"""Converts this transform to different units"""
"""
converts this transform to different units
"""
if not new_units or not self.units:
return self.to_array()
@@ -47,11 +49,15 @@ class Transform(Base, speckle_type="Objects.Other.Transform"):
@staticmethod
def create_matrix(values):
"""Creates a matrix from an array of values"""
"""
creates a matrix from an array of values
"""
if len(values) != 16:
raise ValueError("Matrix requires exactly 16 values")
return [float(v) for v in values]
def to_array(self):
"""Returns the transform matrix as an array"""
"""
returns the transform matrix as an array
"""
return self.matrix.copy()