get_star_coupler_extended_contour

awg_designer.all.get_star_coupler_extended_contour(apertures_in, apertures_out, trans_in, trans_out, radius_in, radius_out, aperture_extension=(0, 0), extension_angles=(0, 0), layers_in=None, layers_out=None)

Get a free propagation region contour shape which fits the slab area.

The slab area is defined by the points of each aperture, on a given layer, with an extra number of virtual apertures assuming apertures mounted along a circle.

This contour shape can be used for drawing a slab area, where the drawing needs to match the apertures but extend along the aperture circle.

Parameters:
apertures_in: list

list of single aperture cells on the input side

apertures_out: list

list of single aperture cells on the output side

trans_in: list

list of Transformations for each aperture in aperture_in

trans_out: list

list of Transformations for each aperture in aperture_out

radius_in: float

radius of the aperture circle on the input side

radius_out: float

radius of the aperture circle on the output side

aperture_extension: list of two floats

the length of the extension on the sides of each aperture to make sure that there are no acute angles when entering the contour. The first number is for the apertures on the input side, the second for the apertures on the output side. Default is [0.0, 0.0].

extension_angles: list of two floats

the angle(s) along the aperture circles to extend the contour shape along the aperture circles. default is [0.0, 0.0]

layers_in: list[Layer]

Layers of the aperture to take into account for the contour on the input side. Assuming the aperture_trace_template is a i3.WindowWaveguideTemplate, the correct windows are chosen and the points are derived from this. If no layers are specified, the core_layer of the aperture_trace_template will be used for drawing the contour.

layers_out: list[Layer]

Layers of the aperture to take into account for the contour on the output side. Assuming the aperture_trace_template is a i3.WindowWaveguideTemplate, the correct windows are chosen and the points are derived from this. If no layers are specified, the core_layer of the aperture_trace_template will be used for drawing the contour.

Returns:
contour: i3.Shape

The shape of the contour around the slab area.