Layout

All UBC ubcpdk.cells are conveniently combined into the ubcpdk.components module.

import gdsfactory as gf

from ubcpdk import PDK, cells

PDK.activate()

2026-02-10 11:42:31.718 | WARNING  | doroutes.pcells:<module>:25 - Cannot determine output type ((D)KCell type)from annotation <class 'kfactory.kcell.DKCell'>. Trying to continue but likely this will fail.

2026-02-10 11:42:31.722 | WARNING  | doroutes.pcells:<module>:48 - Cannot determine output type ((D)KCell type)from annotation <class 'kfactory.kcell.DKCell'>. Trying to continue but likely this will fail.

2026-02-10 11:42:31.724 | WARNING  | doroutes.pcells:<module>:110 - Cannot determine output type ((D)KCell type)from annotation <class 'kfactory.kcell.DKCell'>. Trying to continue but likely this will fail.

2026-02-10 11:42:31.725 | WARNING  | doroutes.pcells:<module>:149 - Cannot determine output type ((D)KCell type)from annotation <class 'kfactory.kcell.DKCell'>. Trying to continue but likely this will fail.

2026-02-10 11:42:31.727 | WARNING  | doroutes.pcells:<module>:168 - Cannot determine output type ((D)KCell type)from annotation <class 'kfactory.kcell.DKCell'>. Trying to continue but likely this will fail.

2026-02-10 11:42:31.728 | WARNING  | doroutes.pcells:<module>:210 - Cannot determine output type ((D)KCell type)from annotation <class 'kfactory.kcell.DKCell'>. Trying to continue but likely this will fail.

2026-02-10 11:42:31.729 | WARNING  | doroutes.pcells:<module>:244 - Cannot determine output type ((D)KCell type)from annotation <class 'kfactory.kcell.DKCell'>. Trying to continue but likely this will fail.

2026-02-10 11:42:31.731 | WARNING  | doroutes.pcells:<module>:269 - Cannot determine output type ((D)KCell type)from annotation <class 'kfactory.kcell.DKCell'>. Trying to continue but likely this will fail.

2026-02-10 11:42:31.732 | WARNING  | doroutes.pcells:<module>:294 - Cannot determine output type ((D)KCell type)from annotation <class 'kfactory.kcell.DKCell'>. Trying to continue but likely this will fail.

Fixed Component cells

Most ubcpdk components are imported from GDS files as fixed cells.

c = cells.ebeam_crossing4()
c.plot()

c = cells.ebeam_swg_edgecoupler()
c.plot()

c = cells.ebeam_bdc_te1550()
c.plot()

c = cells.ebeam_adiabatic_te1550()
c.plot()

c = cells.ebeam_y_adiabatic()
c.plot()

c = cells.ebeam_y_1550()
c.plot()

Parametric Component PCells

You can also define cells adapted from gdsfactory generic pdk.

c = cells.straight(length=2)
c.plot()

c = cells.bend_euler(radius=5)
c.plot()

c = cells.spiral()
c.plot()

c = cells.ring_single_heater()
c.plot()

Components with grating couplers

To test your devices you can add grating couplers. Both for single fibers and for fiber arrays.

splitter = cells.ebeam_y_1550()
mzi = gf.components.mzi(splitter=splitter)
mzi.plot()

component_fiber_array = cells.add_fiber_array(component=mzi, fanout_length=5)
component_fiber_array.plot()

c = cells.ring_single_heater()
c = cells.add_fiber_array_pads_rf(c)
c.plot()

c = cells.mzi_heater()
c = cells.add_fiber_array_pads_rf(c)
c.plot()

3D rendering

scene = c.to_3d()
scene.show()

Die assembly

from functools import partial

import gdsfactory as gf

from ubcpdk.tech import LAYER

size = (440, 470)
add_gc = cells.add_fiber_array


@gf.cell
def EBeam_JoaquinMatres_1() -> gf.Component:
    """Add DBR cavities."""
    e = [add_gc(cells.straight())]
    e += [add_gc(cells.mzi(delta_length=dl)) for dl in [9.32, 93.19]]
    e += [
        add_gc(cells.ring_single(radius=12, gap=gap, length_x=coupling_length))
        for gap in [0.2]
        for coupling_length in [2.5, 4.5, 6.5]
    ]

    c = gf.Component()
    _ = c << gf.pack(e, max_size=size, spacing=2)[0]
    _ = c << gf.components.rectangle(size=size, layer=LAYER.FLOORPLAN)
    return c


c = EBeam_JoaquinMatres_1()
c.show()  # show in klayout
c.plot()  # plot in notebook

2026-02-10 11:42:36.735 | WARNING  | kfactory.kcell:show:3958 - Could not connect to klive server

def EBeam_JoaquinMatres_2() -> gf.Component:
    """spirals for extracting straight waveguide loss"""

    e = [
        cells.add_fiber_array(component=cells.spiral(n_loops=8, length=length))
        for length in [0, 100, 200]
    ]

    c = gf.Component()
    _ = c << gf.pack(e, max_size=size, spacing=2)[0]
    _ = c << gf.components.rectangle(size=size, layer=LAYER.FLOORPLAN)
    return c


c = EBeam_JoaquinMatres_2()
c.show()  # show in klayout
c.plot()  # plot in notebook

2026-02-10 11:42:37.097 | WARNING  | kfactory.kcell:show:3958 - Could not connect to klive server

def EBeam_JoaquinMatres_3() -> gf.Component:
    """Contains mirror cavities and structures inside a resonator."""
    e = []
    e += [add_gc(cells.ebeam_crossing4())]
    e += [add_gc(cells.ebeam_adiabatic_te1550())]
    e += [add_gc(cells.ebeam_bdc_te1550())]
    e += [add_gc(cells.ebeam_y_1550())]
    e += [add_gc(cells.straight(), component_name=f"straight_{i}") for i in range(2)]
    c = gf.Component()
    _ = c << gf.pack(e, max_size=size, spacing=2)[0]
    _ = c << gf.components.rectangle(size=size, layer=LAYER.FLOORPLAN)
    return c


c = EBeam_JoaquinMatres_3()
c.show()  # show in klayout
c.plot()  # plot in notebook

2026-02-10 11:42:37.443 | ERROR    | kfactory.kcell:name:687 - Name conflict in kfactory.kcell::name at line 687
Renaming Unnamed_349 (cell_index=349) to straight_L10_CSstrip_WNone_N2_with_gc would cause it to be named the same as:
 - straight_L10_CSstrip_WNone_N2_with_gc (cell_index=130), function_name=None, basename=None

2026-02-10 11:42:37.470 | ERROR    | kfactory.kcell:name:687 - Name conflict in kfactory.kcell::name at line 687
Renaming Unnamed_351 (cell_index=351) to straight_L10_CSstrip_WNone_N2_with_gc would cause it to be named the same as:
 - straight_L10_CSstrip_WNone_N2_with_gc (cell_index=349), function_name=None, basename=None
 - straight_L10_CSstrip_WNone_N2_with_gc (cell_index=130), function_name=None, basename=None

2026-02-10 11:42:37.519 | WARNING  | kfactory.kcell:show:3958 - Could not connect to klive server

def EBeam_JoaquinMatres_4() -> gf.Component:
    """MZI interferometers."""
    mzi = partial(gf.components.mzi, splitter=cells.ebeam_y_1550)
    mzis = [mzi(delta_length=delta_length) for delta_length in [10, 40]]
    mzis_gc = [cells.add_fiber_array(mzi, fanout_length=5) for mzi in mzis]

    mzis = [cells.mzi_heater(delta_length=delta_length) for delta_length in [40]]
    mzis_heater_gc = [
        cells.add_fiber_array_pads_rf(mzi, orientation=90) for mzi in mzis
    ]

    e = mzis_gc + mzis_heater_gc
    c = gf.Component()
    _ = c << gf.pack(e, max_size=size, spacing=2)[0]
    _ = c << gf.components.rectangle(size=size, layer=LAYER.FLOORPLAN)
    return c


c = EBeam_JoaquinMatres_4()
c.show()  # show in klayout
c.plot()  # plot in notebook

2026-02-10 11:42:37.752 | WARNING  | kfactory.kcell:show:3958 - Could not connect to klive server

def EBeam_JoaquinMatres_5() -> gf.Component:
    """Ring resonators."""

    rings = []
    for length_x in [4, 6]:
        ring = cells.ring_single_heater(length_x=length_x)
        ring_gc = cells.add_fiber_array_pads_rf(ring, pad_yspacing=10)
        rings.append(ring_gc)

    c = gf.Component()
    _ = c << gf.pack(rings, max_size=size, spacing=2)[0]
    _ = c << gf.components.rectangle(size=size, layer=LAYER.FLOORPLAN)
    return c


c = EBeam_JoaquinMatres_5()
c.show()  # show in klayout
c.plot()  # plot in notebook

2026-02-10 11:42:38.026 | WARNING  | kfactory.kcell:show:3958 - Could not connect to klive server