openjellybean 0.6.0__tar.gz

openjellybean-0.6.0/.gitignore

@@ -0,0 +1,22 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+
+# SPICE simulator output
+*.raw
+*.log
+*.dat
+*.fft
+*.net
+
+# Editors and OS
+.vscode/
+.idea/
+*.swp
+.DS_Store
+Thumbs.db
+
+# Local Claude Code settings
+.claude/settings.local.json

openjellybean-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 openjellybean contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

openjellybean-0.6.0/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.5
+Name: openjellybean
+Version: 0.6.0
+Summary: Generic, original 'jelly bean' SPICE models, packaged for use as a dependency
+Project-URL: Homepage, https://github.com/xdylanm/openjellybean
+Project-URL: Repository, https://github.com/xdylanm/openjellybean
+Author: xdylanm
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ltspice,models,netlist,ngspice,spice
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# openjellybean — MIT-licensed jelly-bean SPICE models
+
+One include file, `jellybean.lib`, with original models that behave like the
+everyday parts. Every model was written from scratch and its parameters fitted
+in ngspice to **typical** values from public datasheets — no manufacturer model
+file was copied or adapted — so the whole set is under the MIT license.
+
+Names end in `_OJ` so they never collide with vendor models.
+
+```spice
+.include jellybean.lib
+Q1  c b e  BC547B_OJ          ; BJT:      C B E  (SPICE order, not TO-92 pin order)
+M1  d g s  2N7000_OJ          ; VDMOS:    D G S  (body diode built in)
+J1  d g s  2N5457_OJ          ; JFET:     D G S  (SPICE order, not TO-92 pin order)
+D1  a k    1N4148_OJ          ; diode:    A K
+X1  a k    BZX79C5V1_OJ       ; zener:    A K
+X2  a k    ZENER_OJ params: VZ=8.2 IZT=5m RZ=10 NK=1   ; any voltage
+XU1 inp inn vcc vee out TL07X_OJ   ; op-amp: +IN -IN V+ V- OUT
+XU2 o1 n1 p1 vee p2 n2 o2 vcc TL072_OJ   ; complete dual: pins 1-8 in order
+XU3 o1 n1 p1 vcc p2 n2 o2 o3 n3 p3 vee p4 n4 o4 TL074_OJ   ; complete quad: pins 1-14 in order
+XU4 o1 n1 p1 gnd p2 n2 o2 vcc LM358_DUAL_OJ   ; complete dual: pins 1-8 in order
+XU5 o1 n1 p1 vcc p2 n2 o2 o3 n3 p3 gnd p4 n4 o4 LM324_QUAD_OJ   ; complete quad: pins 1-14 in order
+D2  a k   LED_RED_OJ            ; LED: A K (also LED_GREEN_OJ, LED_BLUE_OJ)
+XR1 a w b POT_OJ params: R=10k POS=0.25   ; pot: A WIPER B; POS 0 = at A, 1 = at B
+```
+
+## Contents and verified behaviour (ngspice 47, 27 °C)
+
+| Model | Stand-in for | Target (datasheet typ.) | Model |
+|---|---|---|---|
+| `BC547B_OJ` NPN | BC547B | hFE 290 @ 2 mA; 150 @ 10 µA | 282; 162 |
+| | | VBE 0.66 V @ 2 mA | 0.658 V |
+| | | VCE(sat) 90 / 200 mV @ 10 / 100 mA | 69 / 231 mV |
+| | | fT 300 MHz @ 10 mA | 304 MHz |
+| `BC557B_OJ` PNP | BC557B | hFE 290 @ 2 mA | 289 |
+| | | VBE(on) 0.62 V @ 2 mA | 0.658 V |
+| | | VCE(sat) 75 / 250 mV @ 10 / 100 mA | 64 / 247 mV |
+| | | fT 150 MHz | 150 MHz |
+| `2N3904_OJ` NPN | 2N3904, MMBT3904 | hFE 100–300 @ 10 mA (min 70 @ 1 mA, 30 @ 100 mA), VCE = 1 V | 157 (164 @ 1 mA, 75 @ 100 mA) |
+| | | VCE(sat) ≤ 200 / 300 mV @ 10/1, 50/5 mA | 54 / 119 mV |
+| | | fT ≥ 300 MHz (20 V, 10 mA, 100 MHz); Cobo ≤ 4 pF; Cibo ≤ 8 pF | 361 MHz; 2.4 pF; 5.0 pF |
+| `2N3906_OJ` PNP | 2N3906, MMBT3906 | hFE 100–300 @ 10 mA (min 30 @ 100 mA), VCE = 1 V | 158 (79 @ 100 mA) |
+| | | VCE(sat) ≤ 250 / 400 mV @ 10/1, 50/5 mA | 61 / 150 mV |
+| | | fT ≥ 250 MHz (20 V, 10 mA, 100 MHz); Cobo ≤ 4.5 pF; Cibo ≤ 10 pF | 289 MHz; 3.1 pF; 6.7 pF |
+| `2N7000_OJ` NMOS | 2N7000, 2N7002, BS170 | VGS(th) 2.1 V @ 1 mA | 2.02 V |
+| | | RDS(on) 1.2 Ω @ 10 V; 1.8 Ω @ 4.5 V | 1.12 Ω; 2.06 Ω |
+| | | Ciss / Coss / Crss 20 / 11 / 4 pF @ 25 V | 19.5 / 10.4 / 3.5 pF |
+| `BS250_OJ` PMOS | BS250 | VGS(th) −1 to −3.5 V; RDS(on) 9 Ω @ −10 V | −2.4 V; 8.9 Ω |
+| | | Ciss / Coss / Crss 30 / 20 / 5 pF @ 10 V | 30.0 / 20.1 / 5.0 pF |
+| `2N5457_OJ` N-JFET | 2N5457, MMBF5457 | IDSS 3 mA; VGS −2.5 V @ 100 µA; gfs 1–5 mS; gos 10 µS | 3.02 mA; −2.51 V; 1.94 mS; 9.1 µS |
+| | | Ciss / Crss 4.5 / 1.5 pF @ 15 V | 4.4 / 1.55 pF |
+| `2N5458_OJ` N-JFET | 2N5458, MMBF5458 | IDSS 6 mA; VGS −3.5 V @ 200 µA; gfs 1.5–5.5 mS; gos 10 µS | 6.03 mA; −3.52 V; 2.74 mS; 9.4 µS |
+| | | Ciss / Crss 4.5 / 1.5 pF @ 15 V | 4.3 / 1.59 pF |
+| `2N5459_OJ` N-JFET | 2N5459, MMBF5459 | IDSS 9 mA; VGS −4.5 V @ 400 µA; gfs 2–6 mS; gos 10 µS | 8.98 mA; −4.53 V; 3.05 mS; 9.1 µS |
+| | | Ciss / Crss 4.5 / 1.5 pF @ 15 V | 4.15 / 1.56 pF |
+| `J112_OJ` N-JFET | J112, SST112 | VGS(off) −1 to −5 V; IDSS ≥ 5 mA (36 mA on the curves); rDS(on) ≤ 50 Ω | −2.19 V; 37 mA; 49 Ω |
+| | | gfs 6 mS, gos 25 µS @ 1 mA; Ciss / Crss 7 / 3 pF @ −10 V | 6.4 mS, 20 µS; 7.3 / 3.0 pF |
+| `J113_OJ` N-JFET | J113, SST113 | VGS(off) to −3 V; IDSS ≥ 2 mA (20 mA on the curves); rDS(on) ≤ 100 Ω (63 Ω on the curves) | −1.49 V; 20 mA; 65 Ω |
+| | | gfs 6 mS, gos 25 µS @ 1 mA; Ciss / Crss 7 / 3 pF @ −10 V | 6.9 mS, 19 µS; 7.3 / 3.0 pF |
+| `PN4392_OJ` N-JFET | PN4392, 2N4392 | VGS(off) −2 to −5 V; IDSS 25–75 mA; rDS(on) ≤ 60 Ω; VDS(on) 0.3 V @ 6 mA | −2.80 V; 50 mA; 49 Ω; 0.30 V |
+| | | gfs 6 mS, gos 25 µS @ 1 mA; Ciss 12 pF @ 20 V; Crss 3.4 pF @ −7 V | 5.4 mS, 20 µS; 12.0 pF; 3.4 pF |
+| `PN4393_OJ` N-JFET | PN4393, 2N4393 | VGS(off) −0.5 to −3 V; IDSS 5–30 mA; rDS(on) ≤ 100 Ω; VDS(on) 0.25 V @ 3 mA | −1.20 V; 14 mA; 78 Ω; 0.25 V |
+| | | gfs 6 mS, gos 25 µS @ 1 mA; Ciss 12 pF @ 20 V; Crss 3.5 pF @ −5 V | 6.6 mS, 19 µS; 11.6 pF; 3.5 pF |
+| `2N5460_OJ` P-JFET | 2N5460, MMBF5460 | IDSS 1–5 mA; VGS(off) 0.75–6 V; gfs 1–4 mS; Ciss / Crss 5 / 1 pF @ 15 V | 2.51 mA; 2.16 V; 2.18 mS; 4.8 / 0.99 pF |
+| `2N5461_OJ` P-JFET | 2N5461, MMBF5461 | IDSS 2–9 mA; VGS(off) 1–7.5 V; gfs 1.5–5 mS; Ciss / Crss 5 / 1 pF @ 15 V | 4.50 mA; 2.96 V; 2.86 mS; 4.75 / 0.98 pF |
+| `2N5462_OJ` P-JFET | 2N5462, MMBF5462 | IDSS 4–16 mA; VGS(off) 1.8–9 V; gfs 2–6 mS; Ciss / Crss 5 / 1 pF @ 15 V | 8.98 mA; 4.95 V; 3.46 mS; 4.75 / 1.01 pF |
+| `1N4148_OJ` | 1N4148, 1N914 | VF 0.61 / 0.72 / 0.875 V @ 1 / 10 / 100 mA | 0.611 / 0.729 / 0.920 V |
+| | | trr ≤ 8 ns (10 mA → 10 mA → 1 mA); ≤ 4 ns (10 mA, 6 V, 100 Ω) | 3.97 ns; 0.67 ns |
+| `1N5819_OJ` Schottky | 1N5819 | VF 0.30 / 0.42 / 0.55 V @ 0.1 / 1 / 3 A | 0.306 / 0.419 / 0.563 V |
+| `BAT54_OJ` Schottky | BAT54 | VF 0.22 / 0.29 / 0.35 / 0.41 / 0.52 V @ 0.1 / 1 / 10 / 30 / 100 mA | 0.230 / 0.290 / 0.360 / 0.410 / 0.518 V |
+| | | CT 7.6 pF @ 1 V; trr ≤ 5 ns (10 mA → 10 mA → 1 mA, 100 Ω) | 7.6 pF; 2.65 ns |
+| `B140_OJ` Schottky | B140, SB140 | VF ≤ 0.5 V @ 1 A; typ 0.33 / 0.44 / 0.61 / 1.07 V @ 0.1 / 1 / 3 / 10 A | 0.346 / 0.461 / 0.613 / 1.08 V |
+| | | CT 110 pF @ 4 V | 115 pF |
+| `BZX79C{3V3,4V7,5V1,5V6,6V2,9V1,12,15}_OJ` | BZX79 500 mW | VZ and rZ at IZT = 5 mA | exact by construction |
+| `1N4733A_OJ`, `1N4742A_OJ` | 1N47xxA 1 W | 5.1 V / 12 V at datasheet IZT | exact by construction |
+| `LED_RED_OJ` | Generic red | VF 1.6 / 1.79 / 1.9 / 2.01 V @ 1 / 4 / 10 / 20 mA | 1.62 / 1.79 / 1.91 / 2.01 V |
+| `LED_GREEN_OJ` | Generic green | VF 1.84 / 1.92 / 2.0 / 2.2 V @ 1 / 4 / 10 / 20 mA; C 15 pF | 1.79 / 1.89 / 2.00 / 2.14 V; 15 pF |
+| `LED_BLUE_OJ` | Generic InGaN blue | VF 2.45 / 2.72 / 2.93 / 3.3 / 3.53 V @ 1 / 5 / 10 / 20 / 30 mA | 2.47 / 2.80 / 3.00 / 3.31 / 3.57 V |
+| `TL07X_OJ` (one section) | TL071/072/074 | AOL 106 dB, GBW 3 MHz, SR 13 V/µs | 106 dB, 2.9 MHz (57° PM), 12.9 V/µs |
+| | | ±13.5 V into 10 kΩ @ ±15 V, IQ 1.4 mA | ±13.38 V, 1.4 mA |
+| `TL072_OJ`, `TL074_OJ` | TL072, TL074 | Complete packages in pin order; IQ 2.8 / 5.6 mA | every section checked; 2.8 / 5.6 mA |
+| `LM358_OJ` (one section) | LM358, LM324 | GBW 0.7 MHz, SR 0.3 V/µs, AOL 100 dB | 0.72 MHz, 0.3 V/µs, 100 dB |
+| | | swings to ~V− at light load, V+ − 1.5 V | 6 mV / V+ − 1.52 V into 10 kΩ |
+| `LM358_DUAL_OJ`, `LM324_QUAD_OJ` | LM358, LM324 | Complete packages in pin order; IQ 0.7 mA at 5 V | every section checked; 0.7 mA |
+| | | LM324: 1.2 MHz, 0.5 V/µs | 1.21 MHz (65° PM), 0.50 V/µs |
+
+Rerun every check with `python tests/validate.py`, or name models to check only
+those. It needs ngspice 47 or later and Python 3.13 or later, with nothing to install from pip. If
+ngspice isn't on your `PATH`, set the `NGSPICE` environment variable to its location.
+
+The targets and tolerances live in [`tests/models.toml`](tests/models.toml). See
+[CONTRIBUTING.md](CONTRIBUTING.md) to add a model.
+
+`POT_OJ` is a generic linear potentiometer. Set the total resistance with `R` and the
+wiper position with `POS`; its values are exact by construction.
+
+## Use as a Python dependency
+
+```bash
+pip install openjellybean
+```
+
+or, in your project's `pyproject.toml`:
+
+```toml
+dependencies = ["openjellybean>=0.6"]
+```
+
+```python
+from openjellybean import library_path
+print(library_path())  # path to the bundled jellybean.lib
+```
+
+The path is a real file, so it can go straight into a netlist, for example
+`.include /path/to/jellybean.lib`. To pin to an unreleased commit instead, install from
+git: `pip install "git+https://github.com/xdylanm/openjellybean@<tag-or-commit>"`.
+
+The package version is read from the `* Version X.Y.Z` line in the header of
+`jellybean.lib`. Releasing means bumping that line, tagging `vX.Y.Z`, and publishing a
+GitHub release, which uploads to [PyPI](https://pypi.org/project/openjellybean/).
+
+## Limits — read before trusting a result
+
+* These are *typical* devices. Real parts spread widely (BC547 hFE spans
+  110–800 across groups; 2N7000 VGS(th) spans 0.8–3 V). Run corners by
+  editing BF, VTO etc.
+* BJTs: no breakdown or quasi-saturation modelled. Temperature uses standard
+  SPICE coefficients (not fitted).
+* MOSFETs use the VDMOS model (ngspice ≥ 47, LTspice). For PSpice you would need
+  a subcircuit rewrite.
+* JFETs use the standard square-law model: no gate breakdown, no conduction tail below
+  cutoff, and gate leakage is set by the simulator (about 30 pA at 15 V, against 5 pA typ on
+  J112/J113). Noise is not fitted. Datasheets give wide or no typical IDSS and VGS(off) for
+  most of these parts, so each model is one point inside the limits, and real parts spread
+  far more: run corners by editing `VTO` and `BETA`.
+* `2N5457_OJ`-`2N5459_OJ` follow the datasheet's typical IDSS and VGS, which give about half
+  the gfs of its typical curves at 3 mA (1.9 mS, about 3.5 mS). J112, J113, PN4392 and PN4393
+  use `LAMBDA=0.035` to approach the published gos, so their drain current climbs more with
+  VDS than a real part at high current (J112: 30 mA at 5 V, 37 mA at 15 V).
+* Zeners: VZ temperature coefficient and noise not modelled; knee shape is
+  approximate.
+* Op-amps: no input common-mode range limits or phase reversal, no noise,
+  CMRR/PSRR, offset drift, or LM358 crossover distortion. VOS defaults to 0 —
+  use `OPAMP_OJ params: VOS=3m ...` to add offset.
+* These typical values are not matched, because fixing them would mean changing the
+  model structure or trading off other fits: 1N5819 leakage is 1.6 µA at 40 V (about
+  20 µA on the datasheet curve), 1N4148 leakage is 2.9 nA at 20 V (about 9 nA), and
+  LM358 short-circuit current is 27 mA (40 mA typ at a 10 V supply). BAT54 leakage is
+  14 nA at 25 V (0.2 µA typ), and B140 leakage is 0.2 µA at 40 V (about 1.7 µA).
+* `TL07X_OJ` matches the slower published TL07x figures, 3 MHz and 13 V/µs; some current
+  versions reach 5.25 MHz and 20 V/µs. `BC557B_OJ` also uses a slower figure, fT = 150 MHz;
+  some datasheets list up to 320 MHz.
+* The LED models are electrical only, with no light output. They represent one typical
+  chemistry per color: green LEDs made with InGaN run near 3.2 V instead of 2.0 V, and red
+  varies with chemistry too. Reverse breakdown is not fitted, and only the green capacitance
+  is checked against a datasheet.
+* `LM358_OJ` used as one LM324 section is slower and draws twice the supply current of a real
+  LM324. Use `LM324_QUAD_OJ` for the LM324's own figures.
+* `POT_OJ` is linear only, with no log taper, power limit or temperature coefficient.
+* Tested in ngspice 47 only; LTspice should accept the syntax
+  but hasn't been run.

openjellybean-0.6.0/README.md

@@ -0,0 +1,161 @@
+# openjellybean — MIT-licensed jelly-bean SPICE models
+
+One include file, `jellybean.lib`, with original models that behave like the
+everyday parts. Every model was written from scratch and its parameters fitted
+in ngspice to **typical** values from public datasheets — no manufacturer model
+file was copied or adapted — so the whole set is under the MIT license.
+
+Names end in `_OJ` so they never collide with vendor models.
+
+```spice
+.include jellybean.lib
+Q1  c b e  BC547B_OJ          ; BJT:      C B E  (SPICE order, not TO-92 pin order)
+M1  d g s  2N7000_OJ          ; VDMOS:    D G S  (body diode built in)
+J1  d g s  2N5457_OJ          ; JFET:     D G S  (SPICE order, not TO-92 pin order)
+D1  a k    1N4148_OJ          ; diode:    A K
+X1  a k    BZX79C5V1_OJ       ; zener:    A K
+X2  a k    ZENER_OJ params: VZ=8.2 IZT=5m RZ=10 NK=1   ; any voltage
+XU1 inp inn vcc vee out TL07X_OJ   ; op-amp: +IN -IN V+ V- OUT
+XU2 o1 n1 p1 vee p2 n2 o2 vcc TL072_OJ   ; complete dual: pins 1-8 in order
+XU3 o1 n1 p1 vcc p2 n2 o2 o3 n3 p3 vee p4 n4 o4 TL074_OJ   ; complete quad: pins 1-14 in order
+XU4 o1 n1 p1 gnd p2 n2 o2 vcc LM358_DUAL_OJ   ; complete dual: pins 1-8 in order
+XU5 o1 n1 p1 vcc p2 n2 o2 o3 n3 p3 gnd p4 n4 o4 LM324_QUAD_OJ   ; complete quad: pins 1-14 in order
+D2  a k   LED_RED_OJ            ; LED: A K (also LED_GREEN_OJ, LED_BLUE_OJ)
+XR1 a w b POT_OJ params: R=10k POS=0.25   ; pot: A WIPER B; POS 0 = at A, 1 = at B
+```
+
+## Contents and verified behaviour (ngspice 47, 27 °C)
+
+| Model | Stand-in for | Target (datasheet typ.) | Model |
+|---|---|---|---|
+| `BC547B_OJ` NPN | BC547B | hFE 290 @ 2 mA; 150 @ 10 µA | 282; 162 |
+| | | VBE 0.66 V @ 2 mA | 0.658 V |
+| | | VCE(sat) 90 / 200 mV @ 10 / 100 mA | 69 / 231 mV |
+| | | fT 300 MHz @ 10 mA | 304 MHz |
+| `BC557B_OJ` PNP | BC557B | hFE 290 @ 2 mA | 289 |
+| | | VBE(on) 0.62 V @ 2 mA | 0.658 V |
+| | | VCE(sat) 75 / 250 mV @ 10 / 100 mA | 64 / 247 mV |
+| | | fT 150 MHz | 150 MHz |
+| `2N3904_OJ` NPN | 2N3904, MMBT3904 | hFE 100–300 @ 10 mA (min 70 @ 1 mA, 30 @ 100 mA), VCE = 1 V | 157 (164 @ 1 mA, 75 @ 100 mA) |
+| | | VCE(sat) ≤ 200 / 300 mV @ 10/1, 50/5 mA | 54 / 119 mV |
+| | | fT ≥ 300 MHz (20 V, 10 mA, 100 MHz); Cobo ≤ 4 pF; Cibo ≤ 8 pF | 361 MHz; 2.4 pF; 5.0 pF |
+| `2N3906_OJ` PNP | 2N3906, MMBT3906 | hFE 100–300 @ 10 mA (min 30 @ 100 mA), VCE = 1 V | 158 (79 @ 100 mA) |
+| | | VCE(sat) ≤ 250 / 400 mV @ 10/1, 50/5 mA | 61 / 150 mV |
+| | | fT ≥ 250 MHz (20 V, 10 mA, 100 MHz); Cobo ≤ 4.5 pF; Cibo ≤ 10 pF | 289 MHz; 3.1 pF; 6.7 pF |
+| `2N7000_OJ` NMOS | 2N7000, 2N7002, BS170 | VGS(th) 2.1 V @ 1 mA | 2.02 V |
+| | | RDS(on) 1.2 Ω @ 10 V; 1.8 Ω @ 4.5 V | 1.12 Ω; 2.06 Ω |
+| | | Ciss / Coss / Crss 20 / 11 / 4 pF @ 25 V | 19.5 / 10.4 / 3.5 pF |
+| `BS250_OJ` PMOS | BS250 | VGS(th) −1 to −3.5 V; RDS(on) 9 Ω @ −10 V | −2.4 V; 8.9 Ω |
+| | | Ciss / Coss / Crss 30 / 20 / 5 pF @ 10 V | 30.0 / 20.1 / 5.0 pF |
+| `2N5457_OJ` N-JFET | 2N5457, MMBF5457 | IDSS 3 mA; VGS −2.5 V @ 100 µA; gfs 1–5 mS; gos 10 µS | 3.02 mA; −2.51 V; 1.94 mS; 9.1 µS |
+| | | Ciss / Crss 4.5 / 1.5 pF @ 15 V | 4.4 / 1.55 pF |
+| `2N5458_OJ` N-JFET | 2N5458, MMBF5458 | IDSS 6 mA; VGS −3.5 V @ 200 µA; gfs 1.5–5.5 mS; gos 10 µS | 6.03 mA; −3.52 V; 2.74 mS; 9.4 µS |
+| | | Ciss / Crss 4.5 / 1.5 pF @ 15 V | 4.3 / 1.59 pF |
+| `2N5459_OJ` N-JFET | 2N5459, MMBF5459 | IDSS 9 mA; VGS −4.5 V @ 400 µA; gfs 2–6 mS; gos 10 µS | 8.98 mA; −4.53 V; 3.05 mS; 9.1 µS |
+| | | Ciss / Crss 4.5 / 1.5 pF @ 15 V | 4.15 / 1.56 pF |
+| `J112_OJ` N-JFET | J112, SST112 | VGS(off) −1 to −5 V; IDSS ≥ 5 mA (36 mA on the curves); rDS(on) ≤ 50 Ω | −2.19 V; 37 mA; 49 Ω |
+| | | gfs 6 mS, gos 25 µS @ 1 mA; Ciss / Crss 7 / 3 pF @ −10 V | 6.4 mS, 20 µS; 7.3 / 3.0 pF |
+| `J113_OJ` N-JFET | J113, SST113 | VGS(off) to −3 V; IDSS ≥ 2 mA (20 mA on the curves); rDS(on) ≤ 100 Ω (63 Ω on the curves) | −1.49 V; 20 mA; 65 Ω |
+| | | gfs 6 mS, gos 25 µS @ 1 mA; Ciss / Crss 7 / 3 pF @ −10 V | 6.9 mS, 19 µS; 7.3 / 3.0 pF |
+| `PN4392_OJ` N-JFET | PN4392, 2N4392 | VGS(off) −2 to −5 V; IDSS 25–75 mA; rDS(on) ≤ 60 Ω; VDS(on) 0.3 V @ 6 mA | −2.80 V; 50 mA; 49 Ω; 0.30 V |
+| | | gfs 6 mS, gos 25 µS @ 1 mA; Ciss 12 pF @ 20 V; Crss 3.4 pF @ −7 V | 5.4 mS, 20 µS; 12.0 pF; 3.4 pF |
+| `PN4393_OJ` N-JFET | PN4393, 2N4393 | VGS(off) −0.5 to −3 V; IDSS 5–30 mA; rDS(on) ≤ 100 Ω; VDS(on) 0.25 V @ 3 mA | −1.20 V; 14 mA; 78 Ω; 0.25 V |
+| | | gfs 6 mS, gos 25 µS @ 1 mA; Ciss 12 pF @ 20 V; Crss 3.5 pF @ −5 V | 6.6 mS, 19 µS; 11.6 pF; 3.5 pF |
+| `2N5460_OJ` P-JFET | 2N5460, MMBF5460 | IDSS 1–5 mA; VGS(off) 0.75–6 V; gfs 1–4 mS; Ciss / Crss 5 / 1 pF @ 15 V | 2.51 mA; 2.16 V; 2.18 mS; 4.8 / 0.99 pF |
+| `2N5461_OJ` P-JFET | 2N5461, MMBF5461 | IDSS 2–9 mA; VGS(off) 1–7.5 V; gfs 1.5–5 mS; Ciss / Crss 5 / 1 pF @ 15 V | 4.50 mA; 2.96 V; 2.86 mS; 4.75 / 0.98 pF |
+| `2N5462_OJ` P-JFET | 2N5462, MMBF5462 | IDSS 4–16 mA; VGS(off) 1.8–9 V; gfs 2–6 mS; Ciss / Crss 5 / 1 pF @ 15 V | 8.98 mA; 4.95 V; 3.46 mS; 4.75 / 1.01 pF |
+| `1N4148_OJ` | 1N4148, 1N914 | VF 0.61 / 0.72 / 0.875 V @ 1 / 10 / 100 mA | 0.611 / 0.729 / 0.920 V |
+| | | trr ≤ 8 ns (10 mA → 10 mA → 1 mA); ≤ 4 ns (10 mA, 6 V, 100 Ω) | 3.97 ns; 0.67 ns |
+| `1N5819_OJ` Schottky | 1N5819 | VF 0.30 / 0.42 / 0.55 V @ 0.1 / 1 / 3 A | 0.306 / 0.419 / 0.563 V |
+| `BAT54_OJ` Schottky | BAT54 | VF 0.22 / 0.29 / 0.35 / 0.41 / 0.52 V @ 0.1 / 1 / 10 / 30 / 100 mA | 0.230 / 0.290 / 0.360 / 0.410 / 0.518 V |
+| | | CT 7.6 pF @ 1 V; trr ≤ 5 ns (10 mA → 10 mA → 1 mA, 100 Ω) | 7.6 pF; 2.65 ns |
+| `B140_OJ` Schottky | B140, SB140 | VF ≤ 0.5 V @ 1 A; typ 0.33 / 0.44 / 0.61 / 1.07 V @ 0.1 / 1 / 3 / 10 A | 0.346 / 0.461 / 0.613 / 1.08 V |
+| | | CT 110 pF @ 4 V | 115 pF |
+| `BZX79C{3V3,4V7,5V1,5V6,6V2,9V1,12,15}_OJ` | BZX79 500 mW | VZ and rZ at IZT = 5 mA | exact by construction |
+| `1N4733A_OJ`, `1N4742A_OJ` | 1N47xxA 1 W | 5.1 V / 12 V at datasheet IZT | exact by construction |
+| `LED_RED_OJ` | Generic red | VF 1.6 / 1.79 / 1.9 / 2.01 V @ 1 / 4 / 10 / 20 mA | 1.62 / 1.79 / 1.91 / 2.01 V |
+| `LED_GREEN_OJ` | Generic green | VF 1.84 / 1.92 / 2.0 / 2.2 V @ 1 / 4 / 10 / 20 mA; C 15 pF | 1.79 / 1.89 / 2.00 / 2.14 V; 15 pF |
+| `LED_BLUE_OJ` | Generic InGaN blue | VF 2.45 / 2.72 / 2.93 / 3.3 / 3.53 V @ 1 / 5 / 10 / 20 / 30 mA | 2.47 / 2.80 / 3.00 / 3.31 / 3.57 V |
+| `TL07X_OJ` (one section) | TL071/072/074 | AOL 106 dB, GBW 3 MHz, SR 13 V/µs | 106 dB, 2.9 MHz (57° PM), 12.9 V/µs |
+| | | ±13.5 V into 10 kΩ @ ±15 V, IQ 1.4 mA | ±13.38 V, 1.4 mA |
+| `TL072_OJ`, `TL074_OJ` | TL072, TL074 | Complete packages in pin order; IQ 2.8 / 5.6 mA | every section checked; 2.8 / 5.6 mA |
+| `LM358_OJ` (one section) | LM358, LM324 | GBW 0.7 MHz, SR 0.3 V/µs, AOL 100 dB | 0.72 MHz, 0.3 V/µs, 100 dB |
+| | | swings to ~V− at light load, V+ − 1.5 V | 6 mV / V+ − 1.52 V into 10 kΩ |
+| `LM358_DUAL_OJ`, `LM324_QUAD_OJ` | LM358, LM324 | Complete packages in pin order; IQ 0.7 mA at 5 V | every section checked; 0.7 mA |
+| | | LM324: 1.2 MHz, 0.5 V/µs | 1.21 MHz (65° PM), 0.50 V/µs |
+
+Rerun every check with `python tests/validate.py`, or name models to check only
+those. It needs ngspice 47 or later and Python 3.13 or later, with nothing to install from pip. If
+ngspice isn't on your `PATH`, set the `NGSPICE` environment variable to its location.
+
+The targets and tolerances live in [`tests/models.toml`](tests/models.toml). See
+[CONTRIBUTING.md](CONTRIBUTING.md) to add a model.
+
+`POT_OJ` is a generic linear potentiometer. Set the total resistance with `R` and the
+wiper position with `POS`; its values are exact by construction.
+
+## Use as a Python dependency
+
+```bash
+pip install openjellybean
+```
+
+or, in your project's `pyproject.toml`:
+
+```toml
+dependencies = ["openjellybean>=0.6"]
+```
+
+```python
+from openjellybean import library_path
+print(library_path())  # path to the bundled jellybean.lib
+```
+
+The path is a real file, so it can go straight into a netlist, for example
+`.include /path/to/jellybean.lib`. To pin to an unreleased commit instead, install from
+git: `pip install "git+https://github.com/xdylanm/openjellybean@<tag-or-commit>"`.
+
+The package version is read from the `* Version X.Y.Z` line in the header of
+`jellybean.lib`. Releasing means bumping that line, tagging `vX.Y.Z`, and publishing a
+GitHub release, which uploads to [PyPI](https://pypi.org/project/openjellybean/).
+
+## Limits — read before trusting a result
+
+* These are *typical* devices. Real parts spread widely (BC547 hFE spans
+  110–800 across groups; 2N7000 VGS(th) spans 0.8–3 V). Run corners by
+  editing BF, VTO etc.
+* BJTs: no breakdown or quasi-saturation modelled. Temperature uses standard
+  SPICE coefficients (not fitted).
+* MOSFETs use the VDMOS model (ngspice ≥ 47, LTspice). For PSpice you would need
+  a subcircuit rewrite.
+* JFETs use the standard square-law model: no gate breakdown, no conduction tail below
+  cutoff, and gate leakage is set by the simulator (about 30 pA at 15 V, against 5 pA typ on
+  J112/J113). Noise is not fitted. Datasheets give wide or no typical IDSS and VGS(off) for
+  most of these parts, so each model is one point inside the limits, and real parts spread
+  far more: run corners by editing `VTO` and `BETA`.
+* `2N5457_OJ`-`2N5459_OJ` follow the datasheet's typical IDSS and VGS, which give about half
+  the gfs of its typical curves at 3 mA (1.9 mS, about 3.5 mS). J112, J113, PN4392 and PN4393
+  use `LAMBDA=0.035` to approach the published gos, so their drain current climbs more with
+  VDS than a real part at high current (J112: 30 mA at 5 V, 37 mA at 15 V).
+* Zeners: VZ temperature coefficient and noise not modelled; knee shape is
+  approximate.
+* Op-amps: no input common-mode range limits or phase reversal, no noise,
+  CMRR/PSRR, offset drift, or LM358 crossover distortion. VOS defaults to 0 —
+  use `OPAMP_OJ params: VOS=3m ...` to add offset.
+* These typical values are not matched, because fixing them would mean changing the
+  model structure or trading off other fits: 1N5819 leakage is 1.6 µA at 40 V (about
+  20 µA on the datasheet curve), 1N4148 leakage is 2.9 nA at 20 V (about 9 nA), and
+  LM358 short-circuit current is 27 mA (40 mA typ at a 10 V supply). BAT54 leakage is
+  14 nA at 25 V (0.2 µA typ), and B140 leakage is 0.2 µA at 40 V (about 1.7 µA).
+* `TL07X_OJ` matches the slower published TL07x figures, 3 MHz and 13 V/µs; some current
+  versions reach 5.25 MHz and 20 V/µs. `BC557B_OJ` also uses a slower figure, fT = 150 MHz;
+  some datasheets list up to 320 MHz.
+* The LED models are electrical only, with no light output. They represent one typical
+  chemistry per color: green LEDs made with InGaN run near 3.2 V instead of 2.0 V, and red
+  varies with chemistry too. Reverse breakdown is not fitted, and only the green capacitance
+  is checked against a datasheet.
+* `LM358_OJ` used as one LM324 section is slower and draws twice the supply current of a real
+  LM324. Use `LM324_QUAD_OJ` for the LM324's own figures.
+* `POT_OJ` is linear only, with no log taper, power limit or temperature coefficient.
+* Tested in ngspice 47 only; LTspice should accept the syntax
+  but hasn't been run.

openjellybean-0.6.0/jellybean.lib

@@ -0,0 +1,276 @@
+* =============================================================================
+* openjellybean - generic "jelly bean" SPICE models
+* Version 0.6.0
+* https://github.com/xdylanm/openjellybean
+* SPDX-License-Identifier: MIT
+* Copyright (c) 2026 openjellybean contributors. See LICENSE for the full text.
+*
+* Original models written from scratch: parameters were fitted in ngspice to
+* typical values published in public datasheets. No manufacturer model file
+* was copied or adapted. They BEHAVE LIKE the named parts at typical bias;
+* they are not the manufacturer's models and carry no manufacturer warranty.
+* Names end in _OJ so they never collide with vendor models in the same tree.
+*
+* Tested with ngspice 47. Uses only standard SPICE syntax plus the VDMOS
+* model (ngspice >= 47, LTspice) and subcircuit params: (ngspice, LTspice).
+* =============================================================================
+
+* ---------------------------------------------------------------- BJTs ------
+* BC547B_OJ : small-signal NPN, 45 V / 100 mA class, hFE group B
+* BC557B_OJ : complementary PNP
+.model BC547B_OJ NPN(IS=1.8e-14 NF=1 BF=330 VAF=65 IKF=0.12 ISE=5e-14 NE=1.5
++ BR=4 NR=1 VAR=20 IKR=0.1 ISC=1e-13 NC=2
++ RB=40 RE=0.4 RC=1.2
++ CJE=10p VJE=0.7 MJE=0.33 CJC=4p VJC=0.6 MJC=0.33 FC=0.5
++ TF=0.45n XTF=2 VTF=10 ITF=0.1 TR=50n
++ EG=1.11 XTI=3 XTB=1.5)
+
+.model BC557B_OJ PNP(IS=1.8e-14 NF=1 BF=330 VAF=40 IKF=0.1 ISE=5e-14 NE=1.5
++ BR=6 NR=1 VAR=15 IKR=0.08 ISC=1e-13 NC=2
++ RB=40 RE=0.6 RC=1.2
++ CJE=12p VJE=0.7 MJE=0.33 CJC=7p VJC=0.6 MJC=0.33 FC=0.5
++ TF=0.95n XTF=2 VTF=10 ITF=0.1 TR=60n
++ EG=1.11 XTI=3 XTB=1.5)
+
+* 2N3904_OJ : 40 V / 200 mA general-purpose NPN (TO-92 pinout E-B-C)
+* 2N3906_OJ : complementary PNP
+.model 2N3904_OJ NPN(IS=1e-14 NF=1 BF=200 VAF=90 IKF=0.07 ISE=4e-14 NE=1.5
++ BR=4 NR=1 VAR=20 IKR=0.1 ISC=1e-13 NC=2
++ RB=10 RE=0.3 RC=1
++ CJE=6p VJE=0.7 MJE=0.33 CJC=5p VJC=0.6 MJC=0.33 FC=0.5
++ TF=0.4n XTF=2 VTF=10 ITF=0.1 TR=30n
++ EG=1.11 XTI=3 XTB=1.5)
+
+.model 2N3906_OJ PNP(IS=1e-14 NF=1 BF=200 VAF=35 IKF=0.08 ISE=4e-14 NE=1.5
++ BR=4 NR=1 VAR=15 IKR=0.08 ISC=1e-13 NC=2
++ RB=10 RE=0.4 RC=1.5
++ CJE=8p VJE=0.7 MJE=0.33 CJC=6.5p VJC=0.6 MJC=0.33 FC=0.5
++ TF=0.5n XTF=2 VTF=10 ITF=0.1 TR=40n
++ EG=1.11 XTI=3 XTB=1.5)
+
+* ------------------------------------------------------------ MOSFETs -------
+* VDMOS model: 3 terminals (D G S), body diode built in.
+* 2N7000_OJ : 60 V small-signal N-channel (also a fair 2N7002 / BS170 stand-in)
+* BS250_OJ  : 45 V small-signal P-channel
+.model 2N7000_OJ VDMOS(VTO=2.0 KP=0.3 LAMBDA=0.01 RD=0.6 RS=0.1 RG=10
++ CGS=16p CGDMAX=20p CGDMIN=3p A=0.5
++ CJO=40p VJ=0.75 M=0.5 IS=1e-13 N=1.1 RB=0.2 BV=60 IBV=10u TT=20n)
+
+.model BS250_OJ VDMOS(pchan VTO=-2.1 KP=0.02 LAMBDA=0.01 RD=1.8 RS=0.2 RG=10
++ CGS=25p CGDMAX=21p CGDMIN=3.7p A=0.5
++ CJO=57p VJ=0.75 M=0.5 IS=1e-13 N=1.1 RB=0.5 BV=45 IBV=10u TT=30n)
+
+* -------------------------------------------------------------- JFETs -------
+* Pins D G S. VTO is negative for both polarities, as SPICE defines it.
+* 2N5457_OJ .. 2N5459_OJ : N-channel general-purpose amplifiers, 25 V
+.model 2N5457_OJ NJF(VTO=-3.06 BETA=3.2e-4 LAMBDA=3.3e-3 RD=20 RS=20
++ CGS=3.2p CGD=5.5p PB=1 IS=1e-14 FC=0.5)
+.model 2N5458_OJ NJF(VTO=-4.28 BETA=3.4e-4 LAMBDA=1.7e-3 RD=20 RS=20
++ CGS=3.2p CGD=5.4p PB=1 IS=1e-14 FC=0.5)
+.model 2N5459_OJ NJF(VTO=-5.7 BETA=2.9e-4 LAMBDA=1.1e-3 RD=20 RS=20
++ CGS=3.2p CGD=5.2p PB=1 IS=1e-14 FC=0.5)
+
+* J112_OJ, J113_OJ : N-channel analog switches, 35 V
+.model J112_OJ NJF(VTO=-2.2 BETA=6.6e-3 LAMBDA=0.035 RD=7 RS=7
++ CGS=13p CGD=9p PB=1.25 IS=1e-15 FC=0.5)
+.model J113_OJ NJF(VTO=-1.5 BETA=8.3e-3 LAMBDA=0.035 RD=12 RS=12
++ CGS=13p CGD=9p PB=1.25 IS=1e-15 FC=0.5)
+
+* PN4392_OJ, PN4393_OJ : N-channel switches, 40 V
+.model PN4392_OJ NJF(VTO=-2.8 BETA=4.4e-3 LAMBDA=0.035 RD=4 RS=4
++ CGS=12p CGD=9p PB=1.17 IS=1e-15 FC=0.5)
+.model PN4393_OJ NJF(VTO=-1.2 BETA=7.4e-3 LAMBDA=0.035 RD=10 RS=10
++ CGS=12.5p CGD=8p PB=1.17 IS=1e-15 FC=0.5)
+
+* 2N5460_OJ .. 2N5462_OJ : P-channel general-purpose amplifiers, 40 V
+.model 2N5460_OJ PJF(VTO=-2.2 BETA=5.3e-4 LAMBDA=5e-3 RD=40 RS=40
++ CGS=4.8p CGD=2.3p PB=1 IS=1e-14 FC=0.5)
+.model 2N5461_OJ PJF(VTO=-3 BETA=5.1e-4 LAMBDA=5e-3 RD=30 RS=30
++ CGS=4.8p CGD=2.3p PB=1 IS=1e-14 FC=0.5)
+.model 2N5462_OJ PJF(VTO=-5 BETA=3.7e-4 LAMBDA=3e-3 RD=20 RS=20
++ CGS=4.7p CGD=2.7p PB=1 IS=1e-14 FC=0.5)
+
+* ------------------------------------------------------------- Diodes -------
+* 1N4148_OJ : small-signal fast switching (also 1N914)
+.model 1N4148_OJ D(IS=2.9n N=1.85 RS=0.9 BV=100 IBV=100u
++ CJO=2p VJ=0.5 M=0.33 TT=2.5n EG=1.11 XTI=3)
+
+* 1N5819_OJ : 1 A / 40 V Schottky
+.model 1N5819_OJ D(IS=1.6u N=1.05 RS=0.057 BV=40 IBV=1m
++ CJO=300p VJ=0.5 M=0.45 TT=0 EG=0.69 XTI=2)
+
+* BAT54_OJ : 200 mA / 30 V small-signal Schottky (one diode of the A/C/S duals)
+.model BAT54_OJ D(IS=14n N=1 RS=1.1 BV=30 IBV=10u
++ CJO=13.5p VJ=0.3 M=0.39 TT=0 EG=0.69 XTI=2)
+
+* B140_OJ : 1 A / 40 V Schottky rectifier (also a fair SB140 stand-in)
+.model B140_OJ D(IS=200n N=1 RS=0.062 BV=45 IBV=500u
++ CJO=310p VJ=0.5 M=0.45 TT=0 EG=0.69 XTI=2)
+
+* ------------------------------------------------------------- Zeners -------
+* Generic zener:  X1 anode cathode ZENER_OJ params: VZ=5.1 IZT=5m RZ=40 NK=1.5
+*   VZ  : zener voltage at test current IZT
+*   RZ  : total dynamic impedance at IZT (as quoted on datasheets)
+*   NK  : knee softness (1 = sharp, 2-3 = the soft knee of sub-5 V parts)
+.subckt ZENER_OJ a k params: VZ=5.1 IZT=5m RZ=40 NK=1.5
+.param RSER={max(RZ - NK*0.025865/IZT, 0.01)}
+.param VOFS={VZ - IZT*RSER - NK*0.025865*ln(IZT/1e-12)}
+Df  a k dfwd
+Vof k n1 {VOFS}
+Dbk n1 n2 dknee
+Rz  n2 a {RSER}
+.model dfwd  D(IS=3n N=1.8 RS=0.5 CJO=40p VJ=0.75 M=0.4 TT=50n)
+.model dknee D(IS=1e-12 N={NK})
+.ends ZENER_OJ
+
+* 500 mW glass zeners, BZX79 class, specified at IZT = 5 mA
+.subckt BZX79C3V3_OJ a k
+X1 a k ZENER_OJ params: VZ=3.3 IZT=5m RZ=85 NK=3
+.ends
+.subckt BZX79C4V7_OJ a k
+X1 a k ZENER_OJ params: VZ=4.7 IZT=5m RZ=50 NK=2.5
+.ends
+.subckt BZX79C5V1_OJ a k
+X1 a k ZENER_OJ params: VZ=5.1 IZT=5m RZ=40 NK=2
+.ends
+.subckt BZX79C5V6_OJ a k
+X1 a k ZENER_OJ params: VZ=5.6 IZT=5m RZ=15 NK=1.5
+.ends
+.subckt BZX79C6V2_OJ a k
+X1 a k ZENER_OJ params: VZ=6.2 IZT=5m RZ=6 NK=1
+.ends
+.subckt BZX79C9V1_OJ a k
+X1 a k ZENER_OJ params: VZ=9.1 IZT=5m RZ=6 NK=1
+.ends
+.subckt BZX79C12_OJ a k
+X1 a k ZENER_OJ params: VZ=12 IZT=5m RZ=10 NK=1
+.ends
+.subckt BZX79C15_OJ a k
+X1 a k ZENER_OJ params: VZ=15 IZT=5m RZ=10 NK=1
+.ends
+* 1 W, 1N47xxA class, specified at the datasheet IZT
+.subckt 1N4733A_OJ a k
+X1 a k ZENER_OJ params: VZ=5.1 IZT=49m RZ=7 NK=2
+.ends
+.subckt 1N4742A_OJ a k
+X1 a k ZENER_OJ params: VZ=12 IZT=21m RZ=9 NK=1
+.ends
+
+* ---------------------------------------------------------------- LEDs ------
+* Generic 5 mm indicator LEDs, one color each:  D1 a k LED_RED_OJ
+* LED_RED_OJ   : high-efficiency red, VF about 1.9 V at 10 mA
+* LED_GREEN_OJ : standard green, VF about 2.0 V at 10 mA
+* LED_BLUE_OJ  : InGaN blue, VF about 3.3 V at 20 mA
+.model LED_RED_OJ D(IS=1.4n N=4.64 RS=1.7 BV=10 IBV=10u
++ CJO=15p VJ=0.75 M=0.33 TT=0 EG=2.46 XTI=0)
+.model LED_GREEN_OJ D(IS=1.1e-18 N=2 RS=10 BV=10 IBV=10u
++ CJO=15p VJ=0.75 M=0.33 TT=0 EG=2.44 XTI=0)
+.model LED_BLUE_OJ D(IS=1.4e-10 N=6 RS=19.7 BV=10 IBV=10u
++ CJO=65p VJ=0.75 M=0.33 TT=0 EG=3.8 XTI=0)
+
+* ------------------------------------------------------------- Op-amps ------
+* Pin order (TI / LTspice convention):  +IN  -IN  V+  V-  OUT
+* Generic single-pole + second-pole macromodel with slew limit, output swing
+* limits, short-circuit current limit and supply current that follows the
+* load (output current is drawn from the correct rail).
+* Not modelled: input common-mode range limits / phase reversal, noise,
+* CMRR/PSRR, offset drift, LM358 crossover distortion.
+*   GBW [Hz]  SR [V/s]  AOL [V/V]  VOS [V]  IB [A, into each pin]
+*   ISC [A]   IQ [A per amplifier]  VOH/VOL: headroom from V+ / V- [V]
+*   ROUT: open-loop output resistance [ohm]  FP2: second pole [Hz]
+.subckt OPAMP_OJ inp inn vcc vee out params: GBW=3e6 SR=13e6 AOL=200k
++ VOS=0 IB=30p RIN=1e12 CIN=3p ISC=30m IQ=1.4m VOH=1.5 VOL=1.5 ROUT=100 FP2=4.5e6
+.param CC=1n
+.param IMAX={SR*CC}
+.param GM={6.2831853*GBW*CC}
+.param VLIN={IMAX/GM}
+Bmid mid 0 V={(V(vcc)+V(vee))/2}
+Iq   vcc vee {IQ}
+Vos  inp inp1 {VOS}
+Ibp  inp mid {IB}
+Ibn  inn mid {IB}
+Rin  inp1 inn {RIN}
+Cinp inp1 mid {CIN}
+Cinn inn mid {CIN}
+* transconductance with tanh slew limit -> integrator
+Bg   mid int I={IMAX}*tanh((V(inp1)-V(inn))/{VLIN})
+Cc   int mid {CC}
+Rint int mid {AOL/GM}
+* output-swing clamps
+Bhi  nhi 0 V=V(vcc)-{VOH}
+Blo  nlo 0 V=V(vee)+{VOL}
+Dhi  int nhi dclamp
+Dlo  nlo int dclamp
+* second pole
+E2   p2a 0 int 0 1
+Rp2  p2a p2 1k
+Cp2  p2 0 {1/(6.2831853*FP2*1k)}
+* current-limited output, current drawn from the rails
+* soft current limit: I = ISC*x/(1+x^4)^0.25, x=(V(p2)-V(out))/(ROUT*ISC)
+Bx   x 0 V=(V(p2)-V(out))/({ROUT}*{ISC})
+Bsrc vcc out I={ISC}*0.5*(abs(V(x))+V(x))/pwr(1+V(x)*V(x)*V(x)*V(x),0.25)
+Bsnk out vee I={ISC}*0.5*(abs(V(x))-V(x))/pwr(1+V(x)*V(x)*V(x)*V(x),0.25)
+.model dclamp D(IS=1e-15 N=0.02)
+.ends OPAMP_OJ
+
+* TL07X_OJ : one section of a TL071/TL072/TL074-class JFET-input op-amp
+.subckt TL07X_OJ inp inn vcc vee out
+* GBW/FP2 chosen so the unity-gain frequency lands at ~3 MHz with ~55-60 deg PM
+X1 inp inn vcc vee out OPAMP_OJ params: GBW=3.5e6 SR=13e6 AOL=200k IB=30p
++ RIN=1e12 CIN=3p ISC=30m IQ=1.4m VOH=1.5 VOL=1.5 ROUT=100 FP2=4.5e6
+.ends TL07X_OJ
+
+* TL072_OJ : complete dual package, pins 1-8 in order:
+*   1OUT 1IN- 1IN+ VCC- 2IN+ 2IN- 2OUT VCC+
+.subckt TL072_OJ out1 inn1 inp1 vee inp2 inn2 out2 vcc
+XA inp1 inn1 vcc vee out1 TL07X_OJ
+XB inp2 inn2 vcc vee out2 TL07X_OJ
+.ends TL072_OJ
+
+* TL074_OJ : complete quad package, pins 1-14 in order:
+*   1OUT 1IN- 1IN+ VCC+ 2IN+ 2IN- 2OUT 3OUT 3IN- 3IN+ VCC- 4IN+ 4IN- 4OUT
+.subckt TL074_OJ out1 inn1 inp1 vcc inp2 inn2 out2 out3 inn3 inp3 vee inp4 inn4 out4
+XA inp1 inn1 vcc vee out1 TL07X_OJ
+XB inp2 inn2 vcc vee out2 TL07X_OJ
+XC inp3 inn3 vcc vee out3 TL07X_OJ
+XD inp4 inn4 vcc vee out4 TL07X_OJ
+.ends TL074_OJ
+
+* LM358_OJ : one section of an LM358/LM324-class single-supply op-amp
+*   (output swings to within ~10 mV of V- at light load; bias current flows
+*    out of the pins, hence negative IB)
+.subckt LM358_OJ inp inn vcc vee out
+X1 inp inn vcc vee out OPAMP_OJ params: GBW=0.8e6 SR=0.3e6 AOL=100k IB=-20n
++ RIN=10Meg CIN=3p ISC=30m IQ=0.35m VOH=1.5 VOL=0.02 ROUT=100 FP2=1.5e6
+.ends LM358_OJ
+
+* LM358_DUAL_OJ : complete dual package, pins 1-8 in order:
+*   1OUT 1IN- 1IN+ GND 2IN+ 2IN- 2OUT VCC+
+.subckt LM358_DUAL_OJ out1 inn1 inp1 vee inp2 inn2 out2 vcc
+XA inp1 inn1 vcc vee out1 LM358_OJ
+XB inp2 inn2 vcc vee out2 LM358_OJ
+.ends LM358_DUAL_OJ
+
+* LM324_QUAD_OJ : complete quad package, pins 1-14 in order:
+*   1OUT 1IN- 1IN+ VCC+ 2IN+ 2IN- 2OUT 3OUT 3IN- 3IN+ GND 4IN+ 4IN- 4OUT
+*   Sections follow the LM324's own datasheet: faster than LM358_OJ, half the supply current.
+.subckt LM324_QUAD_OJ out1 inn1 inp1 vcc inp2 inn2 out2 out3 inn3 inp3 vee inp4 inn4 out4
+.subckt section inp inn vcc vee out
+X1 inp inn vcc vee out OPAMP_OJ params: GBW=1.34e6 SR=0.5e6 AOL=100k IB=-20n
++ RIN=10Meg CIN=3p ISC=30m IQ=0.175m VOH=1.5 VOL=0.02 ROUT=100 FP2=2.5e6
+.ends section
+XA inp1 inn1 vcc vee out1 section
+XB inp2 inn2 vcc vee out2 section
+XC inp3 inn3 vcc vee out3 section
+XD inp4 inn4 vcc vee out4 section
+.ends LM324_QUAD_OJ
+
+* ------------------------------------------------------- Potentiometers -----
+* Generic linear potentiometer:  X1 a w b POT_OJ params: R=10k POS=0.5
+*   R   : total resistance from A to B [ohm]
+*   POS : wiper position, 0 = at A, 1 = at B (limited to that range)
+.subckt POT_OJ a w b params: R=10k POS=0.5
+.param FRAC={max(min(POS,1),0)}
+Ra a w {max(R*FRAC,1e-3)}
+Rb w b {max(R*(1-FRAC),1e-3)}
+.ends POT_OJ

openjellybean-0.6.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "openjellybean"
+dynamic = ["version"]
+description = "Generic, original 'jelly bean' SPICE models, packaged for use as a dependency"
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "xdylanm" }]
+keywords = ["spice", "ngspice", "ltspice", "models", "netlist"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/xdylanm/openjellybean"
+Repository = "https://github.com/xdylanm/openjellybean"
+
+# The version lives in exactly one place: the "* Version X.Y.Z" line in the
+# header of jellybean.lib. Bump it there and tag the release vX.Y.Z.
+[tool.hatch.version]
+path = "jellybean.lib"
+pattern = '(?m)^\* Version (?P<version>\d+\.\d+\.\d+\S*)\s*$'
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/openjellybean"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"jellybean.lib" = "openjellybean/jellybean.lib"
+
+[tool.hatch.build.targets.sdist]
+include = ["src/openjellybean", "jellybean.lib", "README.md", "LICENSE"]
+
+[tool.hatch.build.targets.sdist.force-include]
+"jellybean.lib" = "jellybean.lib"

openjellybean-0.6.0/src/openjellybean/__init__.py

@@ -0,0 +1,26 @@
+"""openjellybean: generic "jelly bean" SPICE models.
+
+Use :func:`library_path` to locate ``jellybean.lib`` for ``.include``/``.lib``
+lines or for tools that take a model file path.
+"""
+
+from __future__ import annotations
+
+from importlib import resources
+from importlib.metadata import PackageNotFoundError, version as _version
+from pathlib import Path
+
+try:
+    __version__ = _version("openjellybean")
+except PackageNotFoundError:  # running from a source tree without installation
+    __version__ = "0+unknown"
+
+__all__ = ["__version__", "library_path"]
+
+
+def library_path() -> Path:
+    """Return the filesystem path of the bundled ``jellybean.lib``.
+
+    The package is installed unzipped, so the resource is a real file.
+    """
+    return Path(str(resources.files(__package__).joinpath("jellybean.lib")))