# This code is part of KQCircuits
# Copyright (C) 2021 IQM Finland Oy
#
# This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public
# License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later
# version.
#
# This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
# warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along with this program. If not, see
# https://www.gnu.org/licenses/gpl-3.0.html.
#
# The software distribution should follow IQM trademark policy for open-source software
# (meetiqm.com/iqm-open-source-trademark-policy). IQM welcomes contributions to the code.
# Please see our contribution agreements for individuals (meetiqm.com/iqm-individual-contributor-license-agreement)
# and organizations (meetiqm.com/iqm-organization-contributor-license-agreement).
from kqcircuits.pya_resolver import pya
from kqcircuits.util.parameters import Param, pdt
from kqcircuits.elements.element import Element
[docs]
class FingerCapacitorTaper(Element):
    """The PCell declaration for a tapered finger capacitor.
    Two ports with reference points. Ground plane gap is automatically adjusted to maintain the a/b ratio.
    .. MARKERS_FOR_PNG 2.76,0 10,16 3.6,-30 11.3,0,71.3,0
    """
    finger_number = Param(pdt.TypeInt, "Number of fingers", 5)
    finger_width = Param(pdt.TypeDouble, "Width of a finger", 5, unit="μm")
    finger_gap = Param(pdt.TypeDouble, "Gap between the fingers", 3, unit="μm")
    finger_length = Param(pdt.TypeDouble, "Length of the fingers", 20, unit="μm")
    taper_length = Param(pdt.TypeDouble, "Length of the taper", 60, unit="μm")
    corner_r = Param(pdt.TypeDouble, "Corner radius", 2, unit="μm")
[docs]
    def can_create_from_shape_impl(self):
        return self.shape.is_path() 
[docs]
    def build(self):
        # shorthand
        n = self.finger_number
        w = self.finger_width
        l = self.finger_length
        g = self.finger_gap
        t = self.taper_length
        total_width = float(n) * (w + g) - g
        a = self.a
        b = self.b
        region_ground = pya.Region(
            pya.DPolygon(
                [
                    pya.DPoint((l + g) / 2, total_width * (b / a) + total_width / 2),
                    pya.DPoint((l + g) / 2 + t, b + a / 2),
                    pya.DPoint((l + g) / 2 + t, -b - a / 2),
                    pya.DPoint((l + g) / 2, -total_width * (b / a) - total_width / 2),
                    pya.DPoint(-(l + g) / 2, -total_width * (b / a) - total_width / 2),
                    pya.DPoint(-(l + g) / 2 - t, -b - a / 2),
                    pya.DPoint(-(l + g) / 2 - t, b + a / 2),
                    pya.DPoint(-(l + g) / 2, total_width * (b / a) + total_width / 2),
                ]
            ).to_itype(self.layout.dbu)
        )
        region_taper_right = pya.Region(
            pya.DPolygon(
                [
                    pya.DPoint((l + g) / 2, total_width / 2),
                    pya.DPoint((l + g) / 2 + t, a / 2),
                    pya.DPoint((l + g) / 2 + t, -a / 2),
                    pya.DPoint((l + g) / 2, -total_width / 2),
                ]
            ).to_itype(self.layout.dbu)
        )
        region_taper_left = region_taper_right.transformed(pya.Trans().M90)
        polys_fingers = []
        poly_finger = pya.DPolygon(
            [pya.DPoint(l / 2, w), pya.DPoint(l / 2, 0), pya.DPoint(-l / 2, 0), pya.DPoint(-l / 2, w)]
        )
        for i in range(0, n):
            trans = (
                pya.DTrans(pya.DVector(g / 2, i * (g + w) - total_width / 2))
                if i % 2
                else pya.DTrans(pya.DVector(-g / 2, i * (g + w) - total_width / 2))
            )
            polys_fingers.append(trans * poly_finger)
        region_fingers = pya.Region([poly.to_itype(self.layout.dbu) for poly in polys_fingers])
        region_etch = region_taper_left + region_taper_right + region_fingers
        region_etch.round_corners(self.corner_r / self.layout.dbu, self.corner_r / self.layout.dbu, self.n)
        region_taper_right_small = pya.Region(
            pya.DPolygon(
                [
                    pya.DPoint(
                        (l + g) / 2 + self.corner_r, (total_width / 2 - a / 2) * (t - 2 * self.corner_r) / t + a / 2
                    ),
                    pya.DPoint((l + g) / 2 + t, a / 2),
                    pya.DPoint((l + g) / 2 + t, -a / 2),
                    pya.DPoint(
                        (l + g) / 2 + self.corner_r, -(total_width / 2 - a / 2) * (t - 2 * self.corner_r) / t - a / 2
                    ),
                ]
            ).to_itype(self.layout.dbu)
        )
        region_taper_left_small = region_taper_right_small.transformed(pya.Trans().M90)
        region = (region_ground - region_etch) - region_taper_right_small - region_taper_left_small
        self.cell.shapes(self.get_layer("base_metal_gap_wo_grid")).insert(region)
        # protection
        region_protection = region_ground.size(0, self.margin / self.layout.dbu, 2)
        self.add_protection(region_protection)
        # ports
        port_a = pya.DPoint(-(l + g) / 2 - t, 0)
        self.add_port("a", port_a, pya.DVector(-1, 0))
        port_b = pya.DPoint((l + g) / 2 + t, 0)
        self.add_port("b", port_b, pya.DVector(1, 0)) 
 
        # adds annotation based on refpoints calculated above