tidy3d.Box

class Box

Bases: SimplePlaneIntersection, Centered

Rectangular prism.

Also base class for Simulation, Monitor, and Source.

Parameters:

• center (Optional[tuple[Union[float, autograd.tracer.Box], Union[float, autograd.tracer.Box], Union[float, autograd.tracer.Box]]] = None) – [units = um]. Center of object in x, y, and z.

• size (tuple[Union[NonNegativeFloat, autograd.tracer.Box], Union[NonNegativeFloat, autograd.tracer.Box], Union[NonNegativeFloat, autograd.tracer.Box]]) – [units = um]. Size in x, y, and z directions.

Example

>>> b = Box(center=(1,2,3), size=(2,2,2))

Attributes

bounds	Returns bounding box min and max coordinates.
geometry	Box representation of self (used for subclasses of Box).
zero_dims	A list of axes along which the Box is zero-sized.
size
center

Methods

from_bounds(rmin, rmax, **kwargs)	Constructs a Box from minimum and maximum coordinate bounds
inside(x, y, z)	For input arrays x, y, z of arbitrary but identical shape, return an array with the same shape which is True for every point in zip(x, y, z) that is inside the volume of the Geometry, and False otherwise.
intersections_plane([x, y, z, cleanup, ...])	Returns shapely geometry at plane specified by one non None value of x,y,z.
intersections_with(other[, cleanup, quad_segs])	Returns list of shapely geometries representing the intersections of the geometry with this 2D box.
padded_copy([x, y, z])	Created a padded copy of a Box instance.
slightly_enlarged_copy()	Box size slightly enlarged around machine precision.
surfaces(size, center, **kwargs)	Returns a list of 6 Box instances corresponding to each surface of a 3D volume.
surfaces_with_exclusion(size, center, **kwargs)	Returns a list of 6 Box instances corresponding to each surface of a 3D volume.

size

classmethod from_bounds(rmin, rmax, **kwargs)

Constructs a Box from minimum and maximum coordinate bounds

Parameters:

• rmin (tuple[float, float, float]) – (x, y, z) coordinate of the minimum values.

• rmax (tuple[float, float, float]) – (x, y, z) coordinate of the maximum values.

Example

>>> b = Box.from_bounds(rmin=(-1, -2, -3), rmax=(3, 2, 1))

classmethod surfaces(size, center, **kwargs)

Returns a list of 6 Box instances corresponding to each surface of a 3D volume. The output surfaces are stored in the order [x-, x+, y-, y+, z-, z+], where x, y, and z denote which axis is perpendicular to that surface, while “-” and “+” denote the direction of the normal vector of that surface. If a name is provided, each output surface’s name will be that of the provided name appended with the above symbols. E.g., if the provided name is “box”, the x+ surfaces’s name will be “box_x+”.

Parameters:

• size (tuple[float, float, float]) – Size of object in x, y, and z directions.

• center (tuple[float, float, float]) – Center of object in x, y, and z.

Example

>>> b = Box.surfaces(size=(1, 2, 3), center=(3, 2, 1))

classmethod surfaces_with_exclusion(size, center, **kwargs)

Returns a list of 6 Box instances corresponding to each surface of a 3D volume. The output surfaces are stored in the order [x-, x+, y-, y+, z-, z+], where x, y, and z denote which axis is perpendicular to that surface, while “-” and “+” denote the direction of the normal vector of that surface. If a name is provided, each output surface’s name will be that of the provided name appended with the above symbols. E.g., if the provided name is “box”, the x+ surfaces’s name will be “box_x+”. If kwargs contains an exclude_surfaces parameter, the returned list of surfaces will not include the excluded surfaces. Otherwise, the behavior is identical to that of surfaces().

Parameters:

• size (tuple[float, float, float]) – Size of object in x, y, and z directions.

• center (tuple[float, float, float]) – Center of object in x, y, and z.

Example

>>> b = Box.surfaces_with_exclusion(
...     size=(1, 2, 3), center=(3, 2, 1), exclude_surfaces=["x-"]
... )

intersections_plane(x=None, y=None, z=None, cleanup=True, quad_segs=None)

Returns shapely geometry at plane specified by one non None value of x,y,z.

Parameters:

• x (float = None) – Position of plane in x direction, only one of x,y,z can be specified to define plane.

• y (float = None) – Position of plane in y direction, only one of x,y,z can be specified to define plane.

• z (float = None) – Position of plane in z direction, only one of x,y,z can be specified to define plane.

• cleanup (bool = True) – If True, removes extremely small features from each polygon’s boundary.

• quad_segs (Optional[int] = None) – Number of segments used to discretize circular shapes. Not used for Box geometry.

Returns:

List of 2D shapes that intersect plane. For more details refer to Shapely’s Documentation.

Return type:

list[shapely.geometry.base.BaseGeometry]

inside(x, y, z)

For input arrays x, y, z of arbitrary but identical shape, return an array with the same shape which is True for every point in zip(x, y, z) that is inside the volume of the Geometry, and False otherwise.

Parameters:

• x (np.ndarray[float]) – Array of point positions in x direction.

• y (np.ndarray[float]) – Array of point positions in y direction.

• z (np.ndarray[float]) – Array of point positions in z direction.

Returns:

True for every point that is inside the geometry.

Return type:

np.ndarray[bool]

intersections_with(other, cleanup=True, quad_segs=None)

Returns list of shapely geometries representing the intersections of the geometry with this 2D box.

Parameters:

• other (Shapely) – Geometry to intersect with.

• cleanup (bool = True) – If True, removes extremely small features from each polygon’s boundary.

• quad_segs (Optional[int] = None) – Number of segments used to discretize circular shapes. If None, uses high-quality visualization settings.

Returns:

List of 2D shapes that intersect this 2D box. For more details refer to Shapely’s Documentation.

Return type:

list[shapely.geometry.base.BaseGeometry]

slightly_enlarged_copy()

Box size slightly enlarged around machine precision.

padded_copy(x=None, y=None, z=None)

Created a padded copy of a Box instance.

Parameters:

• x (Optional[tuple[pydantic.NonNegativeFloat, pydantic.NonNegativeFloat]] = None) – Padding sizes at the left and right boundaries of the box along x-axis.

• y (Optional[tuple[pydantic.NonNegativeFloat, pydantic.NonNegativeFloat]] = None) – Padding sizes at the left and right boundaries of the box along y-axis.

• z (Optional[tuple[pydantic.NonNegativeFloat, pydantic.NonNegativeFloat]] = None) – Padding sizes at the left and right boundaries of the box along z-axis.

Returns:

Padded instance of Box.

Return type:

Box

property bounds

Returns bounding box min and max coordinates.

Returns:

Min and max bounds packaged as (minx, miny, minz), (maxx, maxy, maxz).

Return type:

tuple[float, float, float], tuple[float, float float]

property geometry

Box representation of self (used for subclasses of Box).

Returns:

Instance of Box representing self’s geometry.

Return type:

Box

property zero_dims

A list of axes along which the Box is zero-sized.