ComponentGroup

class ComponentGroup(origin, **kwargs)

Bases: OpticalComponent

__init__(origin, **kwargs)

Initialize a component at a lab-frame origin.

Parameters:

• origin – Component origin in lab coordinates.

• **kwargs – Optional display metadata such as name, label, render_obj, and render_comp_vec.

property bbox

Return cached axis-aligned bounding box in lab coordinates.

property bboxes

get_bboxes() → List[tuple]

get_bbox() → tuple

Compute axis-aligned bounding box in lab frame.

Returns:

Tuple (xmin, xmax, ymin, ymax, zmin, zmax) in lab coordinates.

render(ax, type: str, **kwargs)

Render the component boundary in 2D ("Z") or 3D ("3D").

interact(ray: Ray) → Tuple[float, List[Ray]] | Tuple[None, None]

Apply component interaction in local frame and return lab-frame rays.

Parameters:

ray – Input ray in lab coordinates.

Returns:

Tuple (t, rays) where t is the hit distance and rays contains the truncated incoming segment plus newly generated outgoing rays in lab coordinates. Returns (None, None) when no interaction occurs.

add_rays(rays)

add_component(component)

add_components(components)

add_monitor(monitor)

add_monitors(monitors)

add_refpoint(point)