fibomat.shapes.spot module¶
Provides the Spot class.
- class fibomat.shapes.spot.Spot(position: Optional[Union[fibomat.linalg.vectors.vector.Vector, Iterable[float]]] = None, *, description: Optional[str] = None)[source]¶
Bases:
fibomat.linalg.transformables.transformable_base.TransformableBase[fibomat.linalg.vectors.vector.Vector,float,fibomat.linalg.boundingboxes.boundingbox.BoundingBox],abc.ABC0-dim spot.
- __init__(position: Optional[Union[fibomat.linalg.vectors.vector.Vector, Iterable[float]]] = None, *, description: Optional[str] = None)[source]¶
- Args:
position (VectorLike, optional): position of the spot, default to (0, 0) description (str, optional): description
- property position: fibomat.linalg.vectors.vector.Vector¶
Position of the spot. Same as
center- Access:
get
- Returns:
Vector
- 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