fibomat.shapes.polyline module¶
Provide the Polyline class.
- class fibomat.shapes.polyline.Polyline(points: List[Union[fibomat.linalg.vectors.vector.Vector, Iterable[float]]], description: Optional[str] = None, _closed: bool = False)[source]¶
Bases:
fibomat.linalg.transformables.transformable_base.TransformableBase[fibomat.linalg.vectors.vector.Vector,float,fibomat.linalg.boundingboxes.boundingbox.BoundingBox],abc.ABC- __init__(points: List[Union[fibomat.linalg.vectors.vector.Vector, Iterable[float]]], description: Optional[str] = None, _closed: bool = False)[source]¶
- Args:
points (VectorArrayLike): polyline points description (str, optional): description
- to_arc_spline() fibomat.shapes.arc_spline.ArcSpline[source]¶
Transform shape to ArcSpline.
- Returns:
ArcSpline
- property points: numpy.ndarray¶
Polyline points.
- Access:
get
- Returns:
np.ndarray
- property n_points: int¶
Number of points.
- Access:
get
- Returns:
int
- property bounding_box: fibomat.linalg.boundingboxes.boundingbox.BoundingBox¶
BoundingBox: bounding box of transformable- Access:
get
- property is_closed: bool¶
bool: True if shape is closes. This property should not be defined for 0-dim shapes
- Access:
get
- property center: fibomat.linalg.vectors.vector.Vector¶
center of the (geometric) object
- Access:
get
- Returns:
Any
- clone() fibomat.describable.T¶
Create a deepcopy of the object.
- Returns:
Describable
- property description: Optional[str]¶
Description str.
- Access:
get
- Returns:
Optional[str]
- mirrored(mirror_plane: fibomat.linalg.transformables.transformable_base.VectorT) fibomat.linalg.transformables.transformable_base.SelfT¶
Return a mirrored object mirrored about mirror_plane.
- Args:
mirror_plane (VectorLike): mirror plane to be used.
- Returns:
TransformableBase
- property pivot: fibomat.linalg.transformables.transformable_base.VectorT¶
Origin of the (geometric) object. If origin is set to None,
Transformable.centerwill be returned.Pivot must be set to a callable function without parameters.
transformable_obj = ... transformable_obj.pivot = lambda: return Vector(1, 2) print(transformable_obj.pivot) # will print Vector(1, 2)
- Access:
get/set
- Returns:
Vector
- rotated(theta: float, origin: Optional[Union[fibomat.linalg.transformables.transformable_base.VectorT, str]] = None) fibomat.linalg.transformables.transformable_base.SelfT¶
Return a rotated copy around origin with angle theta in math. positive direction (counterclockwise).
- Args:
theta (float): rotation angle in rad origin (Optional[Union[linalg.VectorLike, str]], optional):
origin of rotation. If not set, (0,0) is used as origin. If origin == ‘center’, the
Transformable.centerof the object will be used. The same applies for the case that origin == ‘origin’ with theTransformable.originproperty. Default to None.- Returns:
TransformableBase
- scaled(fac: float, origin: Optional[Union[fibomat.linalg.transformables.transformable_base.VectorT, str]] = None) fibomat.linalg.transformables.transformable_base.SelfT¶
Return a scale object homogeneously about origin with factor s.
- Args:
fac (float): rotation angle in rad origin (Optional[Union[linalg.VectorLike, str]], optional):
origin of rotation. If not set, (0,0) is used as origin. If origin == ‘center’, the
Transformable.centerof the object will be used. The same applies for the case that origin == ‘origin’ with theTransformable.originproperty. Default to None.- Returns:
TransformableBase
- transformed(transformations: fibomat.linalg.transformables.transformation_builder._TransformationBuilder[fibomat.linalg.transformables.transformable_base.VectorT]) fibomat.linalg.transformables.transformable_base.SelfT¶
- Return a transformed object. the transformation can be build by the following functions:
translate()rotate()scale()mirror()
E.g.
transformable_obj.transform(translate([1, 2]) | rotate(np.pi/3) | mirror([3,4])
- Args:
transformations (_TransformationBuilder): transformation
- Returns:
TransformableBase
- translated(trans_vec: fibomat.linalg.transformables.transformable_base.VectorT) fibomat.linalg.transformables.transformable_base.SelfT¶
Return a translated copy of the object by trans_vec.
- Args:
trans_vec (VectorLike): translation vector
- Returns:
TransformableBase
- translated_to(pos: fibomat.linalg.transformables.transformable_base.VectorT) fibomat.linalg.transformables.transformable_base.SelfT¶
Return a translated copy of the object so that self.pivot == pos
- Args:
pos: new position of object
- Returns:
TransformableBase