from __future__ import annotations
import warnings
from functools import partial
import numpy as np
import gdsfactory as gf
from gdsfactory.component import Component
from gdsfactory.components.compass import compass
from gdsfactory.components.via import via1, via2, viac
from gdsfactory.components.wire import wire_corner45
from gdsfactory.typings import (
ComponentFactory,
ComponentSpec,
Float2,
Floats,
LayerSpec,
LayerSpecs,
)
[docs]
@gf.cell
def via_stack(
size=(11.0, 11.0),
layers: tuple[LayerSpec | None, ...] = ("M1", "M2", "MTOP"),
layer_offsets: Floats | None = None,
vias: tuple[ComponentSpec | None, ...] | None = (via1, via2, None),
layer_port: LayerSpec | None = None,
correct_size: bool = True,
slot_horizontal: bool = False,
slot_vertical: bool = False,
) -> Component:
"""Rectangular via array stack.
You can use it to connect different metal layers or metals to silicon.
You can use the naming convention via_stack_layerSource_layerDestination
contains 4 ports (e1, e2, e3, e4)
also know as Via array
http://www.vlsi-expert.com/2017/12/vias.html
spacing = via.info['spacing']
enclosure = via.info['enclosure']
Args:
size: of the layers.
layers: layers on which to draw rectangles.
layer_offsets: Optional offsets for each layer with respect to size.
positive grows, negative shrinks the size.
vias: vias to use to fill the rectangles.
layer_port: if None assumes port is on the last layer.
correct_size: if True, if the specified dimensions are too small it increases
them to the minimum possible to fit a via.
slot_horizontal: if True, then vias are horizontal.
slot_vertical: if True, then vias are vertical.
"""
width_m, height_m = size
a = width_m / 2
b = height_m / 2
layers = layers or []
layer_offsets = layer_offsets or [0] * len(layers)
elements = {len(layers), len(layer_offsets), len(vias)}
if len(elements) > 1:
warnings.warn(
f"Got {len(layers)} layers, {len(layer_offsets)} layer_offsets, {len(vias)} vias",
stacklevel=3,
)
if layers:
layer_port = layer_port or layers[-1]
c = Component()
c.height = height_m
c.info["size"] = tuple(size)
c.info["xsize"] = size[0]
c.info["ysize"] = size[1]
if layer_port:
c.info["layer"] = layer_port
for layer, offset in zip(layers, layer_offsets):
size_m = (width_m + 2 * offset, height_m + 2 * offset)
if layer and layer == layer_port:
ref = c << compass(size=size_m, layer=layer, port_type="electrical")
c.add_ports(ref.ports)
elif layer is not None:
ref = c << compass(size=size_m, layer=layer, port_type="electrical")
vias = vias or []
for via, offset in zip(vias, layer_offsets):
if via is not None:
width, height = size
width += 2 * offset
height += 2 * offset
_via = gf.get_component(via)
w, h = _via.info["xsize"], _via.info["ysize"]
enclosure = _via.info["enclosure"]
pitch_x, pitch_y = _via.info["xspacing"], _via.info["yspacing"]
if slot_horizontal:
width = size[0] - 2 * enclosure
via = gf.get_component(via, size=(width, h))
nb_vias_x = 1
nb_vias_y = abs(height - h - 2 * enclosure) / pitch_y + 1
elif slot_vertical:
height = size[1] - 2 * enclosure
via = gf.get_component(via, size=(w, height))
nb_vias_x = abs(width - w - 2 * enclosure) / pitch_x + 1
nb_vias_y = 1
else:
via = _via
nb_vias_x = abs(width - w - 2 * enclosure) / pitch_x + 1
nb_vias_y = abs(height - h - 2 * enclosure) / pitch_y + 1
min_width = w + enclosure
min_height = h + enclosure
if (
min_width > width
and correct_size
or min_width <= width
and min_height > height
and correct_size
):
warnings.warn(
f"Changing size from ({width}, {height}) to ({min_width}, {min_height}) to fit a via!",
stacklevel=3,
)
width = max(min_width, width)
height = max(min_height, height)
elif min_width > width or min_height > height:
raise ValueError(f"size {size} is too small to fit a {(w, h)} um via")
nb_vias_x = int(np.floor(nb_vias_x)) or 1
nb_vias_y = int(np.floor(nb_vias_y)) or 1
ref = c.add_array(
via, columns=nb_vias_x, rows=nb_vias_y, spacing=(pitch_x, pitch_y)
)
if ref.xsize + enclosure > width or ref.ysize + enclosure > height:
warnings.warn(
f"size = {size} for layer {layer} violates min enclosure"
f" {enclosure} for via {via.name!r}",
stacklevel=3,
)
a = width / 2
b = height / 2
cw = (width - (nb_vias_x - 1) * pitch_x - w) / 2
ch = (height - (nb_vias_y - 1) * pitch_y - h) / 2
x0 = -a + cw + w / 2
y0 = -b + ch + h / 2
ref.move((x0, y0))
return c
[docs]
@gf.cell
def via_stack_corner45(
width: float = 10,
layers: tuple[LayerSpec | None, ...] = ("M1", "M2", "MTOP"),
layer_offsets: Floats | None = None,
vias: tuple[ComponentSpec | None, ...] | None = (via1, via2, None),
layer_port: LayerSpec | None = None,
correct_size: bool = True,
) -> Component:
"""Rectangular via array stack at a 45 degree angle.
spacing = via.info['spacing']
enclosure = via.info['enclosure']
Args:
width: of the corner45.
layers: layers on which to draw rectangles.
layer_offsets: Optional offsets for each layer with respect to size.
positive grows, negative shrinks the size.
vias: vias to use to fill the rectangles.
layer_port: if None assumes port is on the last layer.
correct_size: if True, if the specified dimensions are too small it increases
them to the minimum possible to fit a via.
"""
height = width
layers = layers or []
layer_offsets = layer_offsets or [0] * len(layers)
elements = {len(layers), len(layer_offsets), len(vias)}
if len(elements) > 1:
warnings.warn(
f"Got {len(layers)} layers, {len(layer_offsets)} layer_offsets, {len(vias)} vias",
stacklevel=3,
)
if layers:
layer_port = layer_port or layers[-1]
c = Component()
if layer_port:
c.info["layer"] = layer_port
for layer, offset in zip(layers, layer_offsets):
if layer and layer == layer_port:
ref = c << wire_corner45(
width=width + 2 * offset, layer=layer, with_corner90_ports=False
)
c.add_ports(ref.ports)
elif layer is not None:
ref = c << wire_corner45(
width=width + 2 * offset, layer=layer, with_corner90_ports=False
)
width_corner = width
width, height = ref.size
xmin = ref.xmin
ymin = ref.ymin
vias = vias or []
for via, offset in zip(vias, layer_offsets):
if via is not None:
width45 = (
2 * (width_corner + 2 * offset) * np.cos(np.deg2rad(45))
) # Width in the x direction
_via = gf.get_component(via)
w, h = _via.info["xsize"], _via.info["ysize"]
enclosure = _via.info["enclosure"]
pitch_x, pitch_y = _via.info["xspacing"], _via.info["yspacing"]
via = _via
min_width = w + enclosure
min_height = h + enclosure
if (
min_width > width45
and correct_size
or min_width <= width45
and min_height > height
and correct_size
):
warnings.warn(
f"Changing size from ({width}, {height}) to ({min_width}, {min_height}) to fit a via!",
stacklevel=3,
)
width45 = max(min_width, width45)
height = max(min_height, height)
elif min_width > width45 or min_height > height:
raise ValueError(
f"{min_width=} > {width=} or {min_height=} > {height=}"
)
# Keep placing rows until we cover the whole height
y_covered = enclosure
while y_covered + enclosure < height:
y = ymin + y_covered + h / 2 # Position of the via
# x offset from the edge of the metal to make sure enclosure is fulfilled
xoff_enc = 2 * enclosure * np.cos(np.deg2rad(45))
xoff = (y_covered + h) * np.tan(np.deg2rad(45)) + xoff_enc
xpos0 = xmin + xoff
# Calculate the number of vias that fit in a given width
if (y_covered + h) < (height - width45):
# The x width is width45
xwidth = width45
else:
# The x width is decreasing
xwidth = (height - (y_covered + h)) * np.tan(np.deg2rad(45))
if min_width <= xwidth:
vias_per_row = (
xwidth - 2 * xoff_enc - 2 * h * np.tan(np.deg2rad(45))
) / (pitch_x) + 1
# Place the vias at the given x, y
for i in range(int(vias_per_row)):
ref = c << via
ref.center = (xpos0 + pitch_x * i + w / 2, y)
y_covered = y_covered + h + pitch_y
c = c.flatten()
return c
[docs]
@gf.cell
def via_stack_corner45_extended(
corner: ComponentSpec = via_stack_corner45,
via_stack: ComponentSpec = via_stack,
width: float = 3,
length: float = 10,
) -> Component:
"""Rectangular via array stack at a 45 degree angle.
Args:
corner: corner component.
straight: straight component.
width: of the corner45.
length: of the straight.
"""
c = gf.Component()
corner = c << gf.get_component(corner, width=width / np.sqrt(2))
s = gf.get_component(via_stack, size=(length, width))
sr = c << s
sl = c << s
sr.connect("e1", corner.ports["e1"])
sl.connect("e1", corner.ports["e2"])
return c
[docs]
@gf.cell
def via_stack_from_rules(
size: Float2 = (1.2, 1.2),
layers: LayerSpecs = ("M1", "M2", "MTOP"),
layer_offsets: tuple[float, ...] | None = None,
vias: tuple[ComponentSpec | None, ...] | None = (via1, via2),
via_min_size: tuple[Float2, ...] = ((0.2, 0.2), (0.2, 0.2)),
via_min_gap: tuple[Float2, ...] = ((0.1, 0.1), (0.1, 0.1)),
via_min_enclosure: Float2 = (0.15, 0.25),
layer_port: LayerSpec | None = None,
) -> Component:
"""Rectangular via array stack, with optimized dimension for vias.
Uses inclusion, minimum width, and minimum spacing rules to place the maximum number of individual vias,
each with maximum via area.
Args:
size: of the layers, len(size).
layers: layers on which to draw rectangles.
layer_offsets: Optional offsets for each layer with respect to size.
positive grows, negative shrinks the size.
vias: list of base via components to modify.
via_min_size: via minimum x, y dimensions.
via_min_gap: via minimum x, y distances.
via_min_enclosure: via minimum inclusion into connecting layers.
layer_port: if None assumes port is on the last layer.
"""
width, height = size
a = width / 2
b = height / 2
layers = layers or []
if layers:
layer_port = layer_port or layers[-1]
c = Component()
c.height = height
c.info["xsize"] = size[0]
c.info["ysize"] = size[1]
c.info["layer"] = layer_port
layer_offsets = layer_offsets or [0] * len(layers)
for layer, offset in zip(layers, layer_offsets):
size = (width + 2 * offset, height + 2 * offset)
if layer and layer == layer_port:
ref = c << compass(size=size, layer=layer, port_type="electrical")
c.add_ports(ref.ports)
elif layer:
ref = c << compass(size=size, layer=layer, port_type="electrical")
vias = vias or []
for current_via, min_size, min_gap, min_enclosure in zip(
vias, via_min_size, via_min_gap, via_min_enclosure
):
if current_via is not None:
# Optimize via
via = gf.get_component(
optimized_via(current_via, size, min_size, min_gap, min_enclosure)
)
w, h = via.info["size"]
g = via.info["enclosure"]
pitch_x, pitch_y = via.info["spacing"]
nb_vias_x = (width - w - 2 * g) / pitch_x + 1
nb_vias_y = (height - h - 2 * g) / pitch_y + 1
nb_vias_x = int(np.floor(nb_vias_x)) or 1
nb_vias_y = int(np.floor(nb_vias_y)) or 1
ref = c.add_array(
via, columns=nb_vias_x, rows=nb_vias_y, spacing=(pitch_x, pitch_y)
)
cw = (width - (nb_vias_x - 1) * pitch_x - w) / 2
ch = (height - (nb_vias_y - 1) * pitch_y - h) / 2
x0 = -a + cw + w / 2
y0 = -b + ch + h / 2
ref.move((x0, y0))
return c
def optimized_via(
base_via: ComponentSpec = "VIAC",
size: tuple[float, float] = (11.0, 11.0),
min_via_size: tuple[float, float] = (0.3, 0.3),
min_via_gap: tuple[float, float] = (0.1, 0.1),
min_via_enclosure: float = 0.2,
) -> ComponentFactory:
"""Given a target total inclusion size, returns an optimized dimension for the via.
Uses inclusion, minimum width, and minimum spacing rules to place the maximum number of individual vias, with maximum via area.
Arguments:
base_via: to modify.
size: of the target enclosing medium.
min_via_size: minimum size the vias can take.
min_via_gap: minimum distance between vias.
min_via_enclosure: minimum distance between edge of enclosing medium and nearest via edge.
"""
via_size = [0, 0]
for dim in [0, 1]:
via_area = size[dim] - 2 * min_via_enclosure + min_via_gap[dim]
num_vias = int(via_area / (min_via_size[dim] + min_via_gap[dim]))
try:
via_size[dim] = float(via_area / num_vias) - min_via_gap[dim]
except ZeroDivisionError as e:
raise RuntimeError(
"Cannot fit vias with specified minimum dimensions in provided space."
) from e
return partial(
base_via,
size=via_size,
gap=min_via_gap,
spacing=None,
enclosure=min_via_enclosure,
)
via_stack_m1_m3 = partial(
via_stack,
layers=("M1", "M2", "MTOP"),
vias=(via1, via2, None),
)
via_stack_m2_m3 = partial(
via_stack,
layers=("M2", "MTOP"),
vias=(via2, None),
)
via_stack_slab_m3 = partial(
via_stack,
layers=("SLAB90", "M1", "M2", "MTOP"),
vias=(viac, via1, via2, None),
)
via_stack_slab_m2 = partial(
via_stack,
layers=("SLAB90", "M1", "M2"),
vias=(viac, via1, None),
)
via_stack_npp_m1 = partial(
via_stack,
layers=("WG", "NPP", "M1"),
vias=(None, None, viac),
)
via_stack_slab_npp_m3 = partial(
via_stack,
layers=("SLAB90", "NPP", "M1"),
vias=(None, None, viac),
)
via_stack_heater_m2 = partial(via_stack, layers=("HEATER", "M2"), vias=(None, via1))
via_stack_heater_mtop = via_stack_heater_m3 = partial(
via_stack, layers=("HEATER", "M2", "MTOP"), vias=(None, via1, via2)
)
if __name__ == "__main__":
# c = via_stack()
# c = gf.pack([via_stack_slab_m3, via_stack_heater_mtop])[0]
# c = via_stack_slab_m3(size=(100, 10), slot_vertical=True)
# c = via_stack_from_rules()
c = via_stack_corner45()
# c = via_stack_corner45_extended()
c.show(show_ports=True)