Align2D Class¶

class plask.geometry.Align2D¶

Container with its items located according to specified alignment.

Container in which every item is located according to its alignment specification. Items in this container can overlap with each other so, although their order matches, you can create any arrangement you wish.

Example

To create a trapezoid of the height 2µm and lower and upper bases of 4µm and 3µm, respectively, you can issue the following commands:

>>> trapezoid = plask.geometry.Align2D()
>>> trapezoid.append(plask.geometry.Rectangle(4, 2, 'GaAs'), 0, 0)
>>> trapezoid.append(plask.geometry.Triangle((0, 2), (-1, 2), 'air'),
                     bottom=0, right=4)

The triangle now overlaps a part of the rectangle.

Methods¶

`append`(...)	Add new object to the container with provided alignment.
`contains`(...)	Test if the geometry object contains a point.
`get_leafs`([path])	Get list of the geometry tree leafs.
`get_leafs_bboxes`([path])	Calculate bounding boxes of all the geometry tree leafs.
`get_leafs_positions`([path])	Calculate positions of all the geometry tree leafs.
`get_leafs_translations`([path])	Get list of `Translation` objects holding all the geometry tree leafs.
`get_matching_objects`(cond)	Get list of the geometry tree objects matching condition.
`get_material`(...)	Get material at the given point.
`get_object_bboxes`(object[, path])	Calculate bounding boxes of all instances of specified object.
`get_object_positions`(object[, path])	Calculate positions of all instances of the specified object.
`get_paths`(...)	Get subtree containing paths to all leafs covering the specified point.
`get_role_objects`(role)	Get list of the geometry tree objects that have the specified role.
`get_roles`(...)	Get roles of objects at specified point.
`has_role`(...)	Test if the specified point has a given role.
`index`(item[, path])	Return index of the given item.Args: object: Object which lower edge should lie at height 0.
`insert`(...)	Insert new object to the container at specified position with provided alignment.
`modify_objects`(callable)	Modify all objects in the geometry tree.
`move_item`(path, **alignments)	Move item existing in the container, setting its position according to the new aligners.
`object_contains`(...)	Test if the specified geometry object contains a point.
`validate`()	Check if the object is complete and ready for calculations.

Attributes¶

`bbox`	Minimal rectangle which contains all points of the geometry object (in local coordinates).
`dims`	Number of object's dimensions (int, 2 or 3).
`role`	Role of the object.
`roles`	List of all the roles of the object.
`steps`	Step info for mesh generation for non-uniform objects.

Descriptions¶

Method Details¶

Align2D.append(item, translation=plask.vec(0, 0))¶

Align2D.append(item, **alignments)

Align2D.append(item, c0, c1)

Add new object to the container with provided alignment.

Parameters:

item (geometry object) – Item to add.
translation (plask.vec) – Two-dimensional vector specifying the position of the item origin.
c0 (float) – Horizontal component of the vector specifying the position of the item origin.
c1 (float) – Vertical component of the vector specifying the position of the item origin.
alignments (dict) – Alignment specifications. The keys in this dictionary can be left, right, top, bottom, #center, and #` where # is an axis name. The corresponding values are positions of a given edge/center/origin of the item. Exactly one alignment for each axis must be given.

Align2D.contains(c0, c1)¶

Align2D.contains(point)

Test if the geometry object contains a point.

Parameters:

point (plask.vector) – Vector with local coordinates of the tested point.
c0 (float) – Horizontal local coordinate of the tested point.
c1 (float) – Vertical local coordinate of the tested point.

Returns:

True if the geometry object contains the given point.

Return type:

bool

Align2D.get_leafs(path=None)¶

Get list of the geometry tree leafs.

This method returns all the geometry tree leafs located under this geometry object. By leaf we understand a proper geometry object, in contrast to any container or transformation.

Parameters:: path – Path that can be used to select only some leafs.
Returns:: List of translations of the leafs.
Return type:: sequence

All these methods are guaranteed to return their sequences in the same order: get_leafs(), get_leafs_bboxes(), get_leafs_positions(), get_leafs_translations().

Align2D.get_leafs_bboxes(path=None)¶

Calculate bounding boxes of all the geometry tree leafs.

This method computes the bounding boxes of all the geometry tree leafs located under this geometry object. By leaf we understand a proper geometry object, in contrast to any container or transformation.

The bounding boxes are computed in the local coordinates of this object.

Parameters:: path – Path that can be used to select only some leafs.
Returns:: List of vectors containing the position of the leafs.
Return type:: sequence

All these methods are guaranteed to return their sequences in the same order: get_leafs(), get_leafs_bboxes(), get_leafs_positions(), get_leafs_translations().

Align2D.get_leafs_positions(path=None)¶

Calculate positions of all the geometry tree leafs.

This method computes position of all the geometry tree leafs located under this geometry object. By leaf we understand a proper geometry object, in contrast to any container or transformation.

The position are computed in the local coordinates of this object.

Parameters:: path – Path that can be used to select only some leafs.
Returns:: List of vectors containing the position of the leafs.
Return type:: sequence

All these methods are guaranteed to return their sequences in the same order: get_leafs(), get_leafs_bboxes(), get_leafs_positions(), get_leafs_translations().

Align2D.get_leafs_translations(path=None)¶

Get list of Translation objects holding all the geometry tree leafs.

This method computes the Translation objects of all the geometry tree leafs located under this geometry object. By leaf we understand a proper geometry object, in contrast to any container or transformation.

The translations are computed in the local coordinates of this object.

Parameters:: path – Path that can be used to select only some leafs.
Returns:: List of translations of the leafs.
Return type:: sequence

All these methods are guaranteed to return their sequences in the same order: get_leafs(), get_leafs_bboxes(), get_leafs_positions(), get_leafs_translations().

Align2D.get_matching_objects(cond)¶

Get list of the geometry tree objects matching condition.

This method returns all the objects in the geometry tree that match the specified condition.

Parameters:: cond – Python callable that accepts a geometry object and returns Boolean indicating whether the object should be returned by this method or not.
Returns:: List of objects matching your condition.
Return type:: sequence

Align2D.get_material(c0, c1)¶

Align2D.get_material(point)

Get material at the given point.

This method returns a material object with the material at the given point if this point is located within the geometry object self. Otherwise the method returns None.

Parameters:

point (plask.vector) – Vector with local coordinates of the tested point.
c0 (float) – Horizontal local coordinate of the tested point.
c1 (float) – Vertical local coordinate of the tested point.

Returns:

Material at the specified point or None.

Align2D.get_object_bboxes(object, path=None)¶

Calculate bounding boxes of all instances of specified object.

The bounding boxes are computed in the local coordinates of self.

Parameters:

object – Object to test.
path – Path specifying a particular object instance.

Returns:

List of bounding boxes of the instances of the object.

Return type:

sequence

All these methods are guaranteed to return their sequences in the same order, provided they are called with the same arguments: get_object_bboxes(), get_object_positions()

Align2D.get_object_positions(object, path=None)¶

Calculate positions of all instances of the specified object.

The position are computed in the local coordinates of self.

Parameters:

object – Object to test.
path – Path specifying a particular object instance.

Returns:

List of vectors containing the position of the instances of the object.

Return type:

sequence

All these methods are guaranteed to return their sequences in the same order, provided they are called with the same arguments: get_object_bboxes(), get_object_positions()

Align2D.get_paths(c0, c1, all=False)¶

Align2D.get_paths(point, all=False)

Get subtree containing paths to all leafs covering the specified point.

Parameters:

point (plask.vector) – Vector with local coordinates of the tested point.
c0 (float) – Horizontal local coordinate of the tested point.
c1 (float) – Vertical local coordinate of the tested point.
all (bool) – If True then all the leafs intersecting the point are considered. Otherwise, only the path to the topmost (i.e. visible) object is returned.

Returns:

Subtree with the path to the specified point.

Attribute Details¶

Align2D.bbox = <property object>¶: Minimal rectangle which contains all points of the geometry object (in local coordinates).

See also

plask.geometry.Box2D

Align2D.dims = <property object>¶: Number of object’s dimensions (int, 2 or 3).

Align2D.role = <property object>¶: Role of the object. Valid only if the object has only one role.

Align2D.roles = <property object>¶: List of all the roles of the object.

Align2D.steps = <property object>¶

Step info for mesh generation for non-uniform objects.

This parameter is considered only for the non-uniform leafs in the geometry tree. It has two attributes that can be changed:

`num`	Maximum number of the mesh steps in each direction the object is divided into.
`dist`	Minimum step size.

The exact meaning of these attributes depend on the mesh generator, however in general they indicate how densely should the non-uniform object be subdivided.

It is possible to assign simply an integer number to this parameter, in which case it changes its num attribute.

PLaSK User Manual

PLaSK User Manual

Page Contents

Align2D Class¶

Methods¶

Attributes¶

Descriptions¶

Method Details¶

Attribute Details¶

PLaSK User Manual

Quick search

PLaSK User Manual

Page Contents

Align2D Class¶

Methods¶

Attributes¶

Descriptions¶

Method Details¶

Attribute Details¶