main
John Lauer ECAS vs MLCC: a study of moving the buck to polymer capacitors, with its section card 531f515
#!/usr/bin/env python3
"""Capacitor models for the ECAS exploration: C at the real DC bias, ESR and ESL, per part.

Murata parts come from the SimSurfing curves in ../research/murata (measured, 25 degC):
  C(bias)  from the C-DC bias curve at the rail voltage the part sits on,
  ESR      from the R(f) curve at 500 kHz (the switching frequency),
  ESL      from |Z| at 30 MHz, well above self-resonance, where |Z| ~ 2 pi f L.
Non-Murata parts use their datasheet numbers (named in `src`).
"""
import json, math, os

HERE = os.path.dirname(os.path.abspath(__file__))
MUR = os.path.join(HERE, "..", "research", "murata")


def _interp(x, xs, ys):
    if x <= xs[0]:
        return ys[0]
    for i in range(1, len(xs)):
        if x <= xs[i]:
            t = (x - xs[i - 1]) / (xs[i] - xs[i - 1])
            return ys[i - 1] + t * (ys[i] - ys[i - 1])
    return ys[-1]


def _loginterp(f, fs, ys):
    lf = [math.log10(v) for v in fs]
    return _interp(math.log10(f), lf, ys)


def murata(pn, c_nom_uF, bias_V):
    d = json.load(open(os.path.join(MUR, pn + ".json")))
    b = d["c_dcbias_capchange"]
    if bias_V > b["x"][-1]:
        raise ValueError(f"{pn}: {bias_V} V is beyond its curve ({b['x'][-1]} V)")
    c = c_nom_uF * (1 + _interp(bias_V, b["x"], b["y"]) / 100)
    fs = [v * 1e6 for v in d["z"]["x"]]          # SimSurfing's axis is MHz despite the "Hz" label
    esr = _loginterp(5e5, fs, d["r"]["y"])
    z30, r30 = _loginterp(3e7, fs, d["z"]["y"]), _loginterp(3e7, fs, d["r"]["y"])
    esl = math.sqrt(max(z30 ** 2 - r30 ** 2, 0)) / (2 * math.pi * 3e7)
    return {"C": c * 1e-6, "ESR": esr, "ESL": esl, "src": f"Murata SimSurfing {pn} at {bias_V:g} V"}


# name -> (function(bias) -> model, footprint, height mm, unit price @100 USD, description)
def lib():
    L = {}

    def add(key, fn, fp, h, price, desc, mpn):
        L[key] = {"model": fn, "fp": fp, "h": h, "price100": price, "desc": desc, "mpn": mpn}

    # ---- as built ----
    add("alu47", lambda v: {"C": 47e-6, "ESR": 0.30, "ESL": 3e-9,
                            "src": "Panasonic EEE-FK1V470P: |Z| 0.36 ohm max @100 kHz (Panasonic product page); 0.30 typ used"},
        "CP_Elec_6.3x5.8", 5.8, 0.263, "47 uF 35 V aluminium electrolytic (FK, case D)", "EEE-FK1V470P")
    add("x7r10_1206", lambda v: murata("GRM31CR71E106KA12", 10, v), "C_1206", 1.6, 0.509,
        "10 uF 25 V X7R 1206 (Yageo CC1206KKX7R8BB106; Murata GRM31CR71E106KA12 curve)", "CC1206KKX7R8BB106")
    add("x5r22_0805", lambda v: murata("GRM21BR61A226ME44", 22, v), "C_0805", 1.25, 0.081,
        "22 uF 10 V X5R 0805 (Samsung CL21A226MPQNNNE; Murata GRM21BR61A226ME44 curve)", "CL21A226MPQNNNE")
    add("c100n", lambda v: {"C": 0.08e-6, "ESR": 0.03, "ESL": 0.5e-9, "src": "100 nF 0603 X7R, ~20% bias loss"},
        "C_0603", 0.8, 0.01, "100 nF 50 V X7R 0603", "0603B104J500CT")
    # ---- ECAS (Murata polymer aluminium) ----
    add("ecas33_25", lambda v: murata("ECASD41E336M040KA0", 33, v), "CP_Tantalum_Case-D_EIA-7343-31", 2.0, 1.06,
        "33 uF 25 V polymer aluminium, 40 mOhm max (Murata ECAS D-case)", "ECASD41E336M040KA0")
    add("ecas150_10", lambda v: murata("ECASD61A157M010KA0", 150, v), "CP_Tantalum_Case-D_EIA-7343-31", 3.1, 1.29,
        "150 uF 10 V polymer aluminium, 10 mOhm max (Murata ECAS D-case)", "ECASD61A157M010KA0")
    add("ecas100_16", lambda v: murata("ECASD61C107M012KA0", 100, v), "CP_Tantalum_Case-D_EIA-7343-31", 3.1, 1.28,
        "100 uF 16 V polymer aluminium, 12 mOhm max (Murata ECAS D-case)", "ECASD61C107M012KA0")
    # ---- other technologies ----
    add("poscap100", lambda v: {"C": 100e-6, "ESR": 0.035, "ESL": 1.5e-9,
                                "src": "Panasonic 6TPE100MAZB: ESR 35 mOhm @100 kHz (DigiKey parametrics), no DC-bias loss"},
        "CP_Tantalum_Case-B_EIA-3528-21", 2.0, 0.582, "100 uF 6.3 V polymer tantalum POSCAP, 3528", "6TPE100MAZB")
    add("t520_100", lambda v: {"C": 100e-6, "ESR": 0.070, "ESL": 1.5e-9,
                               "src": "KEMET T520B107M006ATE070: ESR 70 mOhm @100 kHz (DigiKey parametrics), no DC-bias loss"},
        "CP_Tantalum_Case-B_EIA-3528-21", 2.0, 0.44, "100 uF 6.3 V polymer tantalum KO-CAP, 3528", "T520B107M006ATE070")
    add("x5r47_0805", lambda v: murata("GRM21BR61A476ME15", 47, v), "C_0805", 1.25, 0.243,
        "47 uF 10 V X5R 0805 (Murata GRM21BR61A476ME15)", "GRM21BR61A476ME15")
    add("x5r22_25_0805", lambda v: murata("GRM21BR61E226ME44", 22, v), "C_0805", 1.25, 0.141,
        "22 uF 25 V X5R 0805 (Murata GRM21BR61E226ME44)", "GRM21BR61E226ME44K")
    add("x5r10_25_0603", lambda v: murata("GRM188R61E106MA73", 10, v), "C_0603", 0.8, 0.099,
        "10 uF 25 V X5R 0603 (Murata GRM188R61E106MA73)", "GRM188R61E106MA73D")
    add("r_damp", lambda v: {"R": 0.22, "src": "0.22 ohm 0603 series damping resistor (optimum of results/damping_sweep.json)"}, "R_0603", 0.5, 0.01,
        "0.22 ohm 0603 thick film", "")
    return L


if __name__ == "__main__":
    for k, p in lib().items():
        if k == "r_damp":
            continue
        for v in (5, 12, 16):
            try:
                m = p["model"](v)
            except ValueError:
                continue
            print(f"{k:14s} @{v:2d} V  C={m['C']*1e6:7.2f} uF  ESR={m['ESR']*1e3:6.1f} mOhm  ESL={m['ESL']*1e9:5.2f} nH")