fibomat.pattern module¶

Provides the Pattern class.

class fibomat.pattern.Pattern(dim_shape: fibomat.shapes.dim_shape.DimShape, mill: fibomat.mill.mill.MillBase, raster_style: fibomat.raster_styles.rasterstyle.RasterStyle, *, description: Optional[str] = None, **kwargs)[source]¶

Bases: fibomat.linalg.transformables.dim_transformable.DimTransformable, Generic[fibomat.pattern.DimTransformableT]

Class is used to collect a shape with a length unit, mill settings and optional settings.

__init__(dim_shape: fibomat.shapes.dim_shape.DimShape, mill: fibomat.mill.mill.MillBase, raster_style: fibomat.raster_styles.rasterstyle.RasterStyle, *, description: Optional[str] = None, **kwargs)[source]¶

Args:

dim_shape (Tuple[ShapeType, units.LengthUnit]):: tuple of a shape type and its length unit. ShapeType can be any transformable, e.g. a layout.Group or shapes.Line, …

mill (Mill): mill object **kwargs: additional args

property dim_shape: fibomat.shapes.dim_shape.DimShape¶

Dimensioned shape of the pattern.

Access:: get
Returns:: DimShape

property mill: fibomat.mill.mill.MillBase¶

Mill of the pattern.

Access:: get
Returns:: MillBase

property raster_style: fibomat.raster_styles.rasterstyle.RasterStyle¶

Raster style of the pattern.

Access:: get
Returns:: RasterStyle

property kwargs: Dict¶

Additional passed arguments.

Access:: get
Returns:: Dict

property bounding_box: fibomat.linalg.boundingboxes.dim_boundingbox.DimBoundingBox¶

BoundingBox: bounding box of transformable

Access:: get

property center: fibomat.linalg.vectors.dim_vector.DimVector¶

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.center will 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.center of the object will be used. The same applies for the case that origin == ‘origin’ with the Transformable.origin property. 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.center of the object will be used. The same applies for the case that origin == ‘origin’ with the Transformable.origin property. 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

with_changed_description(new_descr: str) → fibomat.describable.T¶

Clones the object and set the description to new_descr.

Args:: new_descr: new description
Returns:: Describable

fibomat.describable module fibomat.rasterizedpattern module