quantcore-circuits 0.0.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (272) hide show
  1. quantcore_circuits/__init__.py +57 -0
  2. quantcore_circuits/analysis/__init__.py +12 -0
  3. quantcore_circuits/analysis/_metal.py +70 -0
  4. quantcore_circuits/analysis/amplifiers.py +263 -0
  5. quantcore_circuits/analysis/circuits.py +117 -0
  6. quantcore_circuits/analysis/epr.py +231 -0
  7. quantcore_circuits/analysis/epr_lumped.py +372 -0
  8. quantcore_circuits/analysis/extract.py +119 -0
  9. quantcore_circuits/analysis/lom.py +80 -0
  10. quantcore_circuits/analysis/results.py +549 -0
  11. quantcore_circuits/analysis/store.py +81 -0
  12. quantcore_circuits/analysis/synthesis.py +118 -0
  13. quantcore_circuits/analysis/transmon.py +126 -0
  14. quantcore_circuits/assembly/__init__.py +17 -0
  15. quantcore_circuits/assembly/builder.py +127 -0
  16. quantcore_circuits/assembly/drc.py +683 -0
  17. quantcore_circuits/assembly/last_good.py +137 -0
  18. quantcore_circuits/assembly/netlist.py +174 -0
  19. quantcore_circuits/assembly/plan.py +605 -0
  20. quantcore_circuits/assembly/sidecar.py +270 -0
  21. quantcore_circuits/autotrack.py +605 -0
  22. quantcore_circuits/cards.py +878 -0
  23. quantcore_circuits/circuit/__init__.py +14 -0
  24. quantcore_circuits/circuit/adapters.py +305 -0
  25. quantcore_circuits/circuit/bridges.py +353 -0
  26. quantcore_circuits/circuit/consensus.py +158 -0
  27. quantcore_circuits/circuit/derive.py +28 -0
  28. quantcore_circuits/circuit/draw.py +198 -0
  29. quantcore_circuits/circuit/fill.py +828 -0
  30. quantcore_circuits/circuit/hamiltonian.py +193 -0
  31. quantcore_circuits/circuit/kinetic.py +102 -0
  32. quantcore_circuits/circuit/schema.py +139 -0
  33. quantcore_circuits/cli.py +1085 -0
  34. quantcore_circuits/codesign.py +1038 -0
  35. quantcore_circuits/data/selftest_q1_r1.json +44 -0
  36. quantcore_circuits/design/__init__.py +44 -0
  37. quantcore_circuits/design/io.py +98 -0
  38. quantcore_circuits/design/pyscript.py +395 -0
  39. quantcore_circuits/design/schema.py +398 -0
  40. quantcore_circuits/designer.py +625 -0
  41. quantcore_circuits/guiflow.py +991 -0
  42. quantcore_circuits/kqc_files.py +208 -0
  43. quantcore_circuits/layouts/__init__.py +118 -0
  44. quantcore_circuits/layouts/catalog.py +520 -0
  45. quantcore_circuits/layouts/chips/__init__.py +0 -0
  46. quantcore_circuits/layouts/chips/design_chip.py +325 -0
  47. quantcore_circuits/layouts/chips/frame.py +235 -0
  48. quantcore_circuits/layouts/junctions/__init__.py +0 -0
  49. quantcore_circuits/layouts/junctions/jj_fingers.py +99 -0
  50. quantcore_circuits/layouts/junctions/legacy_junctions.py +237 -0
  51. quantcore_circuits/layouts/junctions/sim_gap.py +48 -0
  52. quantcore_circuits/layouts/junctions/trilayer.py +541 -0
  53. quantcore_circuits/layouts/metal/__init__.py +105 -0
  54. quantcore_circuits/layouts/metal/component.py +332 -0
  55. quantcore_circuits/layouts/metal/geometry.py +462 -0
  56. quantcore_circuits/layouts/others/__init__.py +0 -0
  57. quantcore_circuits/layouts/others/amplifiers.py +1139 -0
  58. quantcore_circuits/layouts/others/bond_pad.py +119 -0
  59. quantcore_circuits/layouts/others/connector_pads.py +190 -0
  60. quantcore_circuits/layouts/others/couplers.py +21 -0
  61. quantcore_circuits/layouts/others/cpw_segment.py +131 -0
  62. quantcore_circuits/layouts/others/cpwe.py +661 -0
  63. quantcore_circuits/layouts/others/keepout.py +66 -0
  64. quantcore_circuits/layouts/others/legacy_resonators.py +645 -0
  65. quantcore_circuits/layouts/others/markers.py +201 -0
  66. quantcore_circuits/layouts/others/qpdk_cells.py +263 -0
  67. quantcore_circuits/layouts/others/shapes.py +114 -0
  68. quantcore_circuits/layouts/others/spirals.py +140 -0
  69. quantcore_circuits/layouts/others/sqdmetal_cells.py +90 -0
  70. quantcore_circuits/layouts/others/test_pads.py +461 -0
  71. quantcore_circuits/layouts/ports.py +119 -0
  72. quantcore_circuits/layouts/qubits/__init__.py +0 -0
  73. quantcore_circuits/layouts/qubits/legacy_transmon.py +124 -0
  74. quantcore_circuits/layouts/qubits/qpdk_cells.py +374 -0
  75. quantcore_circuits/layouts/qubits/sqdmetal_cells.py +376 -0
  76. quantcore_circuits/layouts/qubits/trilayer_concentric.py +65 -0
  77. quantcore_circuits/layouts/qubits/xmon.py +375 -0
  78. quantcore_circuits/layouts/registry.py +418 -0
  79. quantcore_circuits/layouts/wafers/__init__.py +0 -0
  80. quantcore_circuits/layouts/wafers/fab_export.py +454 -0
  81. quantcore_circuits/layouts/wafers/legacy_wafer.py +111 -0
  82. quantcore_circuits/layouts/wafers/wafer.py +469 -0
  83. quantcore_circuits/live/__init__.py +6 -0
  84. quantcore_circuits/live/klayout.py +225 -0
  85. quantcore_circuits/live/klive.py +61 -0
  86. quantcore_circuits/live/snapshot.py +185 -0
  87. quantcore_circuits/live/watch.py +93 -0
  88. quantcore_circuits/lom/__init__.py +15 -0
  89. quantcore_circuits/lom/builder.py +932 -0
  90. quantcore_circuits/lom/calibration.py +82 -0
  91. quantcore_circuits/lom/estimates.py +235 -0
  92. quantcore_circuits/lom/fragment.py +421 -0
  93. quantcore_circuits/lom/kqc_models.py +734 -0
  94. quantcore_circuits/lom/metal_models.py +917 -0
  95. quantcore_circuits/lom/quantcore_models.py +784 -0
  96. quantcore_circuits/lom/simulate.py +636 -0
  97. quantcore_circuits/lom/synthesize.py +189 -0
  98. quantcore_circuits/loop.py +610 -0
  99. quantcore_circuits/optimise.py +423 -0
  100. quantcore_circuits/pdk/__init__.py +451 -0
  101. quantcore_circuits/plots.py +876 -0
  102. quantcore_circuits/plugins.py +69 -0
  103. quantcore_circuits/review/__init__.py +57 -0
  104. quantcore_circuits/review/server.py +251 -0
  105. quantcore_circuits/review/static/assets/KaTeX_AMS-Regular-BQhdFMY1.woff2 +0 -0
  106. quantcore_circuits/review/static/assets/KaTeX_AMS-Regular-DMm9YOAa.woff +0 -0
  107. quantcore_circuits/review/static/assets/KaTeX_AMS-Regular-DRggAlZN.ttf +0 -0
  108. quantcore_circuits/review/static/assets/KaTeX_Caligraphic-Bold-ATXxdsX0.ttf +0 -0
  109. quantcore_circuits/review/static/assets/KaTeX_Caligraphic-Bold-BEiXGLvX.woff +0 -0
  110. quantcore_circuits/review/static/assets/KaTeX_Caligraphic-Bold-Dq_IR9rO.woff2 +0 -0
  111. quantcore_circuits/review/static/assets/KaTeX_Caligraphic-Regular-CTRA-rTL.woff +0 -0
  112. quantcore_circuits/review/static/assets/KaTeX_Caligraphic-Regular-Di6jR-x-.woff2 +0 -0
  113. quantcore_circuits/review/static/assets/KaTeX_Caligraphic-Regular-wX97UBjC.ttf +0 -0
  114. quantcore_circuits/review/static/assets/KaTeX_Fraktur-Bold-BdnERNNW.ttf +0 -0
  115. quantcore_circuits/review/static/assets/KaTeX_Fraktur-Bold-BsDP51OF.woff +0 -0
  116. quantcore_circuits/review/static/assets/KaTeX_Fraktur-Bold-CL6g_b3V.woff2 +0 -0
  117. quantcore_circuits/review/static/assets/KaTeX_Fraktur-Regular-CB_wures.ttf +0 -0
  118. quantcore_circuits/review/static/assets/KaTeX_Fraktur-Regular-CTYiF6lA.woff2 +0 -0
  119. quantcore_circuits/review/static/assets/KaTeX_Fraktur-Regular-Dxdc4cR9.woff +0 -0
  120. quantcore_circuits/review/static/assets/KaTeX_Main-Bold-Cx986IdX.woff2 +0 -0
  121. quantcore_circuits/review/static/assets/KaTeX_Main-Bold-Jm3AIy58.woff +0 -0
  122. quantcore_circuits/review/static/assets/KaTeX_Main-Bold-waoOVXN0.ttf +0 -0
  123. quantcore_circuits/review/static/assets/KaTeX_Main-BoldItalic-DxDJ3AOS.woff2 +0 -0
  124. quantcore_circuits/review/static/assets/KaTeX_Main-BoldItalic-DzxPMmG6.ttf +0 -0
  125. quantcore_circuits/review/static/assets/KaTeX_Main-BoldItalic-SpSLRI95.woff +0 -0
  126. quantcore_circuits/review/static/assets/KaTeX_Main-Italic-3WenGoN9.ttf +0 -0
  127. quantcore_circuits/review/static/assets/KaTeX_Main-Italic-BMLOBm91.woff +0 -0
  128. quantcore_circuits/review/static/assets/KaTeX_Main-Italic-NWA7e6Wa.woff2 +0 -0
  129. quantcore_circuits/review/static/assets/KaTeX_Main-Regular-B22Nviop.woff2 +0 -0
  130. quantcore_circuits/review/static/assets/KaTeX_Main-Regular-Dr94JaBh.woff +0 -0
  131. quantcore_circuits/review/static/assets/KaTeX_Main-Regular-ypZvNtVU.ttf +0 -0
  132. quantcore_circuits/review/static/assets/KaTeX_Math-BoldItalic-B3XSjfu4.ttf +0 -0
  133. quantcore_circuits/review/static/assets/KaTeX_Math-BoldItalic-CZnvNsCZ.woff2 +0 -0
  134. quantcore_circuits/review/static/assets/KaTeX_Math-BoldItalic-iY-2wyZ7.woff +0 -0
  135. quantcore_circuits/review/static/assets/KaTeX_Math-Italic-DA0__PXp.woff +0 -0
  136. quantcore_circuits/review/static/assets/KaTeX_Math-Italic-flOr_0UB.ttf +0 -0
  137. quantcore_circuits/review/static/assets/KaTeX_Math-Italic-t53AETM-.woff2 +0 -0
  138. quantcore_circuits/review/static/assets/KaTeX_SansSerif-Bold-CFMepnvq.ttf +0 -0
  139. quantcore_circuits/review/static/assets/KaTeX_SansSerif-Bold-D1sUS0GD.woff2 +0 -0
  140. quantcore_circuits/review/static/assets/KaTeX_SansSerif-Bold-DbIhKOiC.woff +0 -0
  141. quantcore_circuits/review/static/assets/KaTeX_SansSerif-Italic-C3H0VqGB.woff2 +0 -0
  142. quantcore_circuits/review/static/assets/KaTeX_SansSerif-Italic-DN2j7dab.woff +0 -0
  143. quantcore_circuits/review/static/assets/KaTeX_SansSerif-Italic-YYjJ1zSn.ttf +0 -0
  144. quantcore_circuits/review/static/assets/KaTeX_SansSerif-Regular-BNo7hRIc.ttf +0 -0
  145. quantcore_circuits/review/static/assets/KaTeX_SansSerif-Regular-CS6fqUqJ.woff +0 -0
  146. quantcore_circuits/review/static/assets/KaTeX_SansSerif-Regular-DDBCnlJ7.woff2 +0 -0
  147. quantcore_circuits/review/static/assets/KaTeX_Script-Regular-C5JkGWo-.ttf +0 -0
  148. quantcore_circuits/review/static/assets/KaTeX_Script-Regular-D3wIWfF6.woff2 +0 -0
  149. quantcore_circuits/review/static/assets/KaTeX_Script-Regular-D5yQViql.woff +0 -0
  150. quantcore_circuits/review/static/assets/KaTeX_Size1-Regular-C195tn64.woff +0 -0
  151. quantcore_circuits/review/static/assets/KaTeX_Size1-Regular-Dbsnue_I.ttf +0 -0
  152. quantcore_circuits/review/static/assets/KaTeX_Size1-Regular-mCD8mA8B.woff2 +0 -0
  153. quantcore_circuits/review/static/assets/KaTeX_Size2-Regular-B7gKUWhC.ttf +0 -0
  154. quantcore_circuits/review/static/assets/KaTeX_Size2-Regular-Dy4dx90m.woff2 +0 -0
  155. quantcore_circuits/review/static/assets/KaTeX_Size2-Regular-oD1tc_U0.woff +0 -0
  156. quantcore_circuits/review/static/assets/KaTeX_Size3-Regular-CTq5MqoE.woff +0 -0
  157. quantcore_circuits/review/static/assets/KaTeX_Size3-Regular-DgpXs0kz.ttf +0 -0
  158. quantcore_circuits/review/static/assets/KaTeX_Size4-Regular-BF-4gkZK.woff +0 -0
  159. quantcore_circuits/review/static/assets/KaTeX_Size4-Regular-DWFBv043.ttf +0 -0
  160. quantcore_circuits/review/static/assets/KaTeX_Size4-Regular-Dl5lxZxV.woff2 +0 -0
  161. quantcore_circuits/review/static/assets/KaTeX_Typewriter-Regular-C0xS9mPB.woff +0 -0
  162. quantcore_circuits/review/static/assets/KaTeX_Typewriter-Regular-CO6r4hn1.woff2 +0 -0
  163. quantcore_circuits/review/static/assets/KaTeX_Typewriter-Regular-D3Ib7_Hf.ttf +0 -0
  164. quantcore_circuits/review/static/assets/index-CDHdrFyA.css +1 -0
  165. quantcore_circuits/review/static/assets/index-CSx05Og4.js +409 -0
  166. quantcore_circuits/review/static/assets/inter-cyrillic-400-normal-HOLc17fK.woff +0 -0
  167. quantcore_circuits/review/static/assets/inter-cyrillic-400-normal-obahsSVq.woff2 +0 -0
  168. quantcore_circuits/review/static/assets/inter-cyrillic-500-normal-BasfLYem.woff2 +0 -0
  169. quantcore_circuits/review/static/assets/inter-cyrillic-500-normal-CxZf_p3X.woff +0 -0
  170. quantcore_circuits/review/static/assets/inter-cyrillic-600-normal-4D_pXhcN.woff +0 -0
  171. quantcore_circuits/review/static/assets/inter-cyrillic-600-normal-CWCymEST.woff2 +0 -0
  172. quantcore_circuits/review/static/assets/inter-cyrillic-700-normal-CjBOestx.woff2 +0 -0
  173. quantcore_circuits/review/static/assets/inter-cyrillic-700-normal-DrXBdSj3.woff +0 -0
  174. quantcore_circuits/review/static/assets/inter-cyrillic-ext-400-normal-BQZuk6qB.woff2 +0 -0
  175. quantcore_circuits/review/static/assets/inter-cyrillic-ext-400-normal-DQukG94-.woff +0 -0
  176. quantcore_circuits/review/static/assets/inter-cyrillic-ext-500-normal-B0yAr1jD.woff2 +0 -0
  177. quantcore_circuits/review/static/assets/inter-cyrillic-ext-500-normal-BmqWE9Dz.woff +0 -0
  178. quantcore_circuits/review/static/assets/inter-cyrillic-ext-600-normal-Bcila6Z-.woff +0 -0
  179. quantcore_circuits/review/static/assets/inter-cyrillic-ext-600-normal-Dfes3d0z.woff2 +0 -0
  180. quantcore_circuits/review/static/assets/inter-cyrillic-ext-700-normal-BjwYoWNd.woff2 +0 -0
  181. quantcore_circuits/review/static/assets/inter-cyrillic-ext-700-normal-LO58E6JB.woff +0 -0
  182. quantcore_circuits/review/static/assets/inter-greek-400-normal-B4URO6DV.woff2 +0 -0
  183. quantcore_circuits/review/static/assets/inter-greek-400-normal-q2sYcFCs.woff +0 -0
  184. quantcore_circuits/review/static/assets/inter-greek-500-normal-BIZE56-Y.woff2 +0 -0
  185. quantcore_circuits/review/static/assets/inter-greek-500-normal-Xzm54t5V.woff +0 -0
  186. quantcore_circuits/review/static/assets/inter-greek-600-normal-BZpKdvQh.woff +0 -0
  187. quantcore_circuits/review/static/assets/inter-greek-600-normal-plRanbMR.woff2 +0 -0
  188. quantcore_circuits/review/static/assets/inter-greek-700-normal-BUv2fZ6O.woff +0 -0
  189. quantcore_circuits/review/static/assets/inter-greek-700-normal-C3JjAnD8.woff2 +0 -0
  190. quantcore_circuits/review/static/assets/inter-greek-ext-400-normal-DGGRlc-M.woff2 +0 -0
  191. quantcore_circuits/review/static/assets/inter-greek-ext-400-normal-KugGGMne.woff +0 -0
  192. quantcore_circuits/review/static/assets/inter-greek-ext-500-normal-2j5mBUwD.woff +0 -0
  193. quantcore_circuits/review/static/assets/inter-greek-ext-500-normal-C4iEst2y.woff2 +0 -0
  194. quantcore_circuits/review/static/assets/inter-greek-ext-600-normal-B8X0CLgF.woff +0 -0
  195. quantcore_circuits/review/static/assets/inter-greek-ext-600-normal-DRtmH8MT.woff2 +0 -0
  196. quantcore_circuits/review/static/assets/inter-greek-ext-700-normal-BoQ6DsYi.woff +0 -0
  197. quantcore_circuits/review/static/assets/inter-greek-ext-700-normal-qfdV9bQt.woff2 +0 -0
  198. quantcore_circuits/review/static/assets/inter-latin-400-normal-C38fXH4l.woff2 +0 -0
  199. quantcore_circuits/review/static/assets/inter-latin-400-normal-CyCys3Eg.woff +0 -0
  200. quantcore_circuits/review/static/assets/inter-latin-500-normal-BL9OpVg8.woff +0 -0
  201. quantcore_circuits/review/static/assets/inter-latin-500-normal-Cerq10X2.woff2 +0 -0
  202. quantcore_circuits/review/static/assets/inter-latin-600-normal-CiBQ2DWP.woff +0 -0
  203. quantcore_circuits/review/static/assets/inter-latin-600-normal-LgqL8muc.woff2 +0 -0
  204. quantcore_circuits/review/static/assets/inter-latin-700-normal-BLAVimhd.woff +0 -0
  205. quantcore_circuits/review/static/assets/inter-latin-700-normal-Yt3aPRUw.woff2 +0 -0
  206. quantcore_circuits/review/static/assets/inter-latin-ext-400-normal-77YHD8bZ.woff +0 -0
  207. quantcore_circuits/review/static/assets/inter-latin-ext-400-normal-C1nco2VV.woff2 +0 -0
  208. quantcore_circuits/review/static/assets/inter-latin-ext-500-normal-BxGbmqWO.woff +0 -0
  209. quantcore_circuits/review/static/assets/inter-latin-ext-500-normal-CV4jyFjo.woff2 +0 -0
  210. quantcore_circuits/review/static/assets/inter-latin-ext-600-normal-CIVaiw4L.woff +0 -0
  211. quantcore_circuits/review/static/assets/inter-latin-ext-600-normal-D2bJ5OIk.woff2 +0 -0
  212. quantcore_circuits/review/static/assets/inter-latin-ext-700-normal-Ca8adRJv.woff2 +0 -0
  213. quantcore_circuits/review/static/assets/inter-latin-ext-700-normal-TidjK2hL.woff +0 -0
  214. quantcore_circuits/review/static/assets/inter-vietnamese-400-normal-Bbgyi5SW.woff +0 -0
  215. quantcore_circuits/review/static/assets/inter-vietnamese-400-normal-DMkecbls.woff2 +0 -0
  216. quantcore_circuits/review/static/assets/inter-vietnamese-500-normal-DOriooB6.woff2 +0 -0
  217. quantcore_circuits/review/static/assets/inter-vietnamese-500-normal-mJboJaSs.woff +0 -0
  218. quantcore_circuits/review/static/assets/inter-vietnamese-600-normal-BuLX-rYi.woff +0 -0
  219. quantcore_circuits/review/static/assets/inter-vietnamese-600-normal-Cc8MFFhd.woff2 +0 -0
  220. quantcore_circuits/review/static/assets/inter-vietnamese-700-normal-BZaoP0fm.woff +0 -0
  221. quantcore_circuits/review/static/assets/inter-vietnamese-700-normal-DlLaEgI2.woff2 +0 -0
  222. quantcore_circuits/review/static/assets/jetbrains-mono-cyrillic-400-normal-BEIGL1Tu.woff2 +0 -0
  223. quantcore_circuits/review/static/assets/jetbrains-mono-cyrillic-400-normal-ugxPyKxw.woff +0 -0
  224. quantcore_circuits/review/static/assets/jetbrains-mono-cyrillic-500-normal-DJqRU3vO.woff +0 -0
  225. quantcore_circuits/review/static/assets/jetbrains-mono-cyrillic-500-normal-DmUKJPL_.woff2 +0 -0
  226. quantcore_circuits/review/static/assets/jetbrains-mono-greek-400-normal-B9oWc5Lo.woff +0 -0
  227. quantcore_circuits/review/static/assets/jetbrains-mono-greek-400-normal-C190GLew.woff2 +0 -0
  228. quantcore_circuits/review/static/assets/jetbrains-mono-greek-500-normal-D7SFKleX.woff +0 -0
  229. quantcore_circuits/review/static/assets/jetbrains-mono-greek-500-normal-JpySY46c.woff2 +0 -0
  230. quantcore_circuits/review/static/assets/jetbrains-mono-latin-400-normal-6-qcROiO.woff +0 -0
  231. quantcore_circuits/review/static/assets/jetbrains-mono-latin-400-normal-V6pRDFza.woff2 +0 -0
  232. quantcore_circuits/review/static/assets/jetbrains-mono-latin-500-normal-BWZEU5yA.woff2 +0 -0
  233. quantcore_circuits/review/static/assets/jetbrains-mono-latin-500-normal-CJOVTJB7.woff +0 -0
  234. quantcore_circuits/review/static/assets/jetbrains-mono-latin-ext-400-normal-Bc8Ftmh3.woff2 +0 -0
  235. quantcore_circuits/review/static/assets/jetbrains-mono-latin-ext-400-normal-fXTG6kC5.woff +0 -0
  236. quantcore_circuits/review/static/assets/jetbrains-mono-latin-ext-500-normal-Cut-4mMH.woff2 +0 -0
  237. quantcore_circuits/review/static/assets/jetbrains-mono-latin-ext-500-normal-ckzbgY84.woff +0 -0
  238. quantcore_circuits/review/static/assets/jetbrains-mono-vietnamese-400-normal-CqNFfHCs.woff +0 -0
  239. quantcore_circuits/review/static/assets/jetbrains-mono-vietnamese-500-normal-DNRqzVM1.woff +0 -0
  240. quantcore_circuits/review/static/index.html +14 -0
  241. quantcore_circuits/review/static/logo-quantcore-black.png +0 -0
  242. quantcore_circuits/review/static/logo-quantcore-white.png +0 -0
  243. quantcore_circuits/review/static/sample/chip.png +0 -0
  244. quantcore_circuits/review/static/sample/chip_rev1.png +0 -0
  245. quantcore_circuits/review/static/sample/q1.png +0 -0
  246. quantcore_circuits/review/static/sample/q2.png +0 -0
  247. quantcore_circuits/review/static/sample-state.json +3747 -0
  248. quantcore_circuits/route/__init__.py +5 -0
  249. quantcore_circuits/route/router.py +694 -0
  250. quantcore_circuits/route/waveguide.py +187 -0
  251. quantcore_circuits/selftest.py +224 -0
  252. quantcore_circuits/sim_tools/__init__.py +6 -0
  253. quantcore_circuits/sim_tools/aedt_attach.py +66 -0
  254. quantcore_circuits/sim_tools/aedt_progress.py +224 -0
  255. quantcore_circuits/sim_tools/aedt_project.py +302 -0
  256. quantcore_circuits/sim_tools/aedt_scripts.py +397 -0
  257. quantcore_circuits/sim_tools/aedt_session.py +275 -0
  258. quantcore_circuits/sim_tools/ansys.py +90 -0
  259. quantcore_circuits/sim_tools/builder.py +1690 -0
  260. quantcore_circuits/sim_tools/export.py +470 -0
  261. quantcore_circuits/sim_tools/geometry_check.py +342 -0
  262. quantcore_circuits/sim_tools/hfss.py +583 -0
  263. quantcore_circuits/sim_tools/palace.py +197 -0
  264. quantcore_circuits/sim_tools/runner.py +179 -0
  265. quantcore_circuits/sim_tools/subset.py +364 -0
  266. quantcore_circuits/track.py +671 -0
  267. quantcore_circuits-0.0.1.dist-info/METADATA +204 -0
  268. quantcore_circuits-0.0.1.dist-info/RECORD +272 -0
  269. quantcore_circuits-0.0.1.dist-info/WHEEL +5 -0
  270. quantcore_circuits-0.0.1.dist-info/entry_points.txt +2 -0
  271. quantcore_circuits-0.0.1.dist-info/licenses/LICENSE +674 -0
  272. quantcore_circuits-0.0.1.dist-info/top_level.txt +1 -0
@@ -0,0 +1,451 @@
1
+ """Quantcore process design kit: fab layer map, stack-up and CPW defaults.
2
+
3
+ Geometry is always drawn in KQC layer names (``1t1_base_metal_gap_wo_grid``, ``1t1_SIS_junction``, ...) plus a few
4
+ Quantcore layers (:data:`QCC_LAYERS`, drawn at their fab numbers). Fab layer numbers appear at mask export
5
+ (:mod:`quantcore_circuits.layouts.wafers.fab_export`). The map below is the fab layer map (2026-11-03), all as a
6
+ **negative** mask (drawn = removed / exposed):
7
+
8
+ ========= ================================================ ====================================================
9
+ fab layer source meaning
10
+ ========= ================================================ ====================================================
11
+ 1/0 KQC ``base_metal_gap`` (drawn = etch) fine structure: feedline ends, resonator and
12
+ transmon ground cut-outs
13
+ 2/0 KQC ``SIS_junction`` junction top finger
14
+ 3/0 derived: filled keep-outs (:class:`KeepoutRule`) second-metal subtractive etch: each 1/0 feature
15
+ *including* what lies between its gaps (a CPW's
16
+ centre conductor, a qubit's island) + ground margin,
17
+ plus the cheese holes (the same squares as on 1/0)
18
+ 4/0 KQC ``SIS_junction_2`` junction second finger
19
+ 50/0 qcc ``hsq`` junction spacer material (HSQ)
20
+ 51–53/0 qcc ``spacer_1`` … ``spacer_3`` spacer gradient (greyscale lithography shades)
21
+ 100/0 qcc ``chip_boundary`` (drawn by the die frame) chip boundary
22
+ 500/0 qcc ``wafer_boundary`` wafer boundary (wafer level, ``Wafer``)
23
+ 501/0 qcc ``wafer_markers`` wafer markers: die labels / outlines, alignment
24
+ and orientation marks (wafer level, ``Wafer``)
25
+ 1000/0 … qcc ``marker_0`` … (drawn by the die frame) marker layers: 1000/0 dicing markers, 1001/0
26
+ alignment-marker grids (confirmed 2026-11-03)
27
+ 300/0 KQC ``airbridge_pads`` airbridge layers ("300/0"); the bridge
28
+ 301/0 KQC ``airbridge_flyover`` (flyover) on 301/0 is an assumption
29
+ 700/0 KQC ``through_silicon_via`` TSVs
30
+ 800/0 … KQC face ``2b1`` (flip-chip top chip) 800/0 its base-metal etch, 801/0 indium bumps,
31
+ 802/0 under-bump metal, 803/0 + 804/0 its
32
+ junction fingers (numbering after 800 assumed)
33
+ ========= ================================================ ====================================================
34
+
35
+ **Universal Quantcore (QCT) chip rules** (2026-11-03), applied to every chip built with this PDK:
36
+
37
+ * the die frame: L-shaped dicing markers and the 3×3 alignment grids (:class:`DieFrame`); the device ID is optional
38
+ (edge centres → beside the feedline pads, 50 µm gap → slid along the left/right edges; omitted if nowhere free);
39
+ * the brand text is ``"QCT"`` (:attr:`Pdk.brand`) wherever a KQC chip frame draws one;
40
+ * **fab export only** (never in simulation exports): ground **cheese** in a band around the components
41
+ (:class:`CheeseRule`: 3/0 grown by ``rows`` grid pitches, 5 µm squares, 20 µm gaps, none within 4 µm of the 3/0
42
+ keep-outs; every hole is written on 1/0 *and* on 3/0, 2026-11-17) and
43
+ **rounded corners** with a radius tied to each polygon's shortest dimension (:class:`CornerRounding`).
44
+
45
+ The die frame (:class:`DieFrame`, ``components/pdk_geometry_summary.md``) is drawn on every chip by default.
46
+ ``hsq_boundary`` (legacy HSQ write-field frame, 150/0) is kept for the legacy marker cells but is not a fab layer.
47
+ Legacy helper layers 9/0 (bounding box) and 10/0 (scratch) are not exported.
48
+ """
49
+
50
+ from __future__ import annotations
51
+
52
+ import math
53
+ import re
54
+ from dataclasses import dataclass, field, replace
55
+ from functools import cache
56
+
57
+ from kqcircuits.pya_resolver import pya
58
+
59
+ # Extra layers not present in KQC's default layer config, drawn directly at their fab numbers (KQC's own layers use
60
+ # datatype ≥ 1, apart from 220–225/0, so none of these collide).
61
+ QCC_LAYERS = {
62
+ "hsq": pya.LayerInfo(50, 0, "qcc_spacer"),
63
+ "spacer_1": pya.LayerInfo(51, 0, "qcc_spacer_1"),
64
+ "spacer_2": pya.LayerInfo(52, 0, "qcc_spacer_2"),
65
+ "spacer_3": pya.LayerInfo(53, 0, "qcc_spacer_3"),
66
+ "chip_boundary": pya.LayerInfo(100, 0, "qcc_chip_boundary"),
67
+ "wafer_boundary": pya.LayerInfo(500, 0, "qcc_wafer_boundary"),
68
+ "wafer_markers": pya.LayerInfo(501, 0, "qcc_wafer_markers"),
69
+ "hsq_boundary": pya.LayerInfo(150, 0, "qcc_hsq_boundary"), # legacy, not exported
70
+ **{f"marker_{i}": pya.LayerInfo(1000 + i, 0, f"qcc_marker_{i}") for i in range(4)},
71
+ # gatemon process layers drawn by qpdk_cells.Gatemon at the components agent's *proposed* numbers: not fab layers
72
+ # until fab numbers are given, so `qcc mask` reports them as dropped instead of losing them silently
73
+ **{
74
+ f"gatemon_{n}": pya.LayerInfo(600 + i, 0, f"qcc_{n}")
75
+ for i, n in enumerate(("cnt_contact", "cnt", "hbn", "jj_patch", "top_gate"))
76
+ },
77
+ }
78
+
79
+
80
+ @dataclass(frozen=True)
81
+ class FabLayer:
82
+ layer: int
83
+ datatype: int
84
+ source: str # KQC layer name (without face prefix), qcc layer name, or "derived"
85
+ invert: bool = False # True: export the complement inside the chip box (positive metal)
86
+ description: str = ""
87
+ faces: tuple[str, ...] | None = None # KQC faces to read (union); None = the PDK's own face
88
+
89
+ @property
90
+ def info(self) -> pya.LayerInfo:
91
+ return pya.LayerInfo(self.layer, self.datatype)
92
+
93
+
94
+ @dataclass(frozen=True)
95
+ class Stack:
96
+ """Material stack used by simulation exports (all lengths in µm)."""
97
+
98
+ substrate_material: str = "sapphire"
99
+ substrate_permittivity: float = 10.25 # effective isotropic value used by Quantcore (2026-11-02)
100
+ substrate_loss_tangent: float = 1e-6
101
+ substrate_height: float = 650.0 # wafer thickness confirmed (2026-11-02)
102
+ metal_height: float = 0.0 # 0 = sheet (PEC) metal; Nb film ~0.2 µm if thick metal is needed
103
+ metal_thickness_um: float = 0.2 # used by analytic CPW formulas only
104
+ upper_box_height: float = 1000.0
105
+ lower_box_height: float = 0.0
106
+ london_penetration_depth_um: float = 0.09 # Nb
107
+
108
+
109
+ @dataclass(frozen=True)
110
+ class DieFrame:
111
+ """Die frame (``components/pdk_geometry_summary.md``), drawn inside the chip box; all lengths in µm.
112
+
113
+ Corner L-shaped dicing markers (legs along the die edges), a design area inset by ``margin``, a
114
+ ``marker_area`` square in each corner of the design area holding a 3×3 alignment grid, and the device-ID block
115
+ centred at the bottom of the design area. Grid positions are measured from the die corner, mirrored for the
116
+ other corners.
117
+
118
+ **Pad rule** (2026-11-03; distance 2026-11-10): bond pads and launchers sit with the outer edge of their
119
+ etch ``pad_edge`` = 100 µm from the die edge (the design-area margin), whatever the original chip did.
120
+ ``place.edge`` in a design puts an instance there; KQC sample-holder launchers get their ``launcher_indent`` from
121
+ it (unless a design sets ``launchers.indent``); the DRC flags pads that are not there (``pad_edge`` warning).
122
+ """
123
+
124
+ margin: float = 100.0
125
+ dicing_leg: float = 250.0
126
+ dicing_width: float = 25.0
127
+ marker_area: float = 500.0
128
+ grid_x: tuple[float, float, float] = (302.5, 452.5, 602.5)
129
+ grid_y: tuple[float, float, float] = (305.0, 452.5, 600.0)
130
+ grid_small: float = 5.0 # corners and centre of the 3×3 grid
131
+ grid_large: float = 10.0 # edge midpoints
132
+ device_id: tuple[float, float] = (700.0, 300.0)
133
+ pad_edge: float = 100.0 # pads/launchers: outer etch edge this far from the die edge (2026-11-10)
134
+ dicing_layer: str = "marker_0"
135
+ alignment_layer: str = "marker_1"
136
+ boundary_layer: str = "chip_boundary"
137
+
138
+
139
+ @dataclass(frozen=True)
140
+ class KeepoutRule:
141
+ """3/0: where the second metal is etched away after its deposition (design rule, 2026-11-03), so it cannot short
142
+ the 1/0 features. Filled regions — they do not exclude the 1/0 structure in the middle:
143
+
144
+ * routes (CPW lines, meanders): the whole CPW footprint (gaps + centre conductor) grown by ``route_margin``
145
+ (legacy resonators ≈ 6 µm: some ground on both sides);
146
+ * components (qubits, pads, capacitors …): the bounding box of their etch grown by ``component_margin`` — a
147
+ square/rectangle engulfing some ground (as the legacy Xmon / two-pad PCells draw it), unless the cell defines
148
+ its own keep-out with a classmethod ``qcc_keepout(params) -> [pya.DBox | pya.DPolygon]`` (local µm);
149
+ * anything else drawn in 1/0 (device-ID text, shapes placed directly): grown by ``other_margin``.
150
+
151
+ Fab change 2026-11-17 (design rule): every 3/0 keep-out is 4 µm wider per side than before
152
+ (the cheese sat too close to its edge): ``route_margin`` 6 → 10, ``component_margin`` 20 → 24,
153
+ ``other_margin`` 5 → 9, and the keep-outs the cells draw themselves (``qcc_keepout``, legacy PCells) grow by ``own_grow`` = 4 (applied once in
154
+ :func:`~quantcore_circuits.layouts.wafers.fab_export.keepout_region`, not per cell).
155
+
156
+ Whole chips placed as one cell (e.g. a KQC chip replica) are opened and their parts treated as above.
157
+
158
+ Gaps the union leaves between neighbouring keep-outs are filled when smaller than ``fill_holes_um2``; larger
159
+ enclosed areas — the ground inside a closed bus ring — stay outside 3/0 (they are ground, not a feature), so the
160
+ cheese can reach them (notebooks-metal, 2026-11-10).
161
+ """
162
+
163
+ route_margin: float = 10.0
164
+ component_margin: float = 24.0
165
+ other_margin: float = 9.0
166
+ own_grow: float = 4.0 # added to a cell's own ``qcc_keepout`` shapes
167
+ fill_holes_um2: float = 200.0 * 200.0
168
+
169
+
170
+ @dataclass(frozen=True)
171
+ class CheeseRule:
172
+ """Ground cheese (design rule): holes only in a band around the components, not over the whole chip.
173
+
174
+ The band is the 3/0 keep-out grown by ``rows`` grid pitches; ``size`` µm squares on a chip-aligned grid with
175
+ ``gap`` µm between them (pitch = size + gap) are kept where they lie entirely in the band, ``clearance`` µm or
176
+ more from 3/0, inside the design area and clear of the frame's markers and device ID. They are etched (added to
177
+ ``layer``, M1 = 1/0) and, as the same squares (not grown by the keep-out margin), added to 3/0 (2026-11-17: the
178
+ cheese is on both fab layers 1/0 and 3/0; the clearance is to the keep-outs alone). Simulation exports never get
179
+ cheese.
180
+
181
+ Where it is drawn (2026-11-03): in the chip build itself, into KQC's ``ground_grid`` layer, so layouts and
182
+ snapshots show it (chip parameter ``cheese``: ``"auto"`` default, ``"pdk"``, ``"original"``). **The original
183
+ design wins**: a design that carries its own cheese (KQC ``with_grid``, or a static cell with its holes — mark it
184
+ ``cheese: "original"``) keeps it and gets no PDK band; a design without any gets this band. The fab export adds
185
+ the band only to a build that has no cheese at all.
186
+ """
187
+
188
+ size: float = 5.0
189
+ gap: float = 20.0
190
+ rows: int = 3
191
+ clearance: float = 4.0 # no hole closer than this to 3/0 (2026-11-17)
192
+ layer: str = "M1"
193
+
194
+ @property
195
+ def pitch(self) -> float:
196
+ return self.size + self.gap
197
+
198
+
199
+ @dataclass(frozen=True)
200
+ class CornerRounding:
201
+ """Fab-export rounding of sharp corners (design rule): each polygon's corners get a radius tied to its shortest
202
+ dimension, so narrow features keep their shape and wide ones get softer corners.
203
+
204
+ Shortest dimension d = min(2·area/perimeter, shortest straight edge ≥ ``min_edge``) (a strip of width w gives
205
+ w); radius r = min(``fraction`` · d, ``max_radius``), skipped below ``min_radius``. Applied to ``layers``
206
+ (fab-layer names) before cheesing; junction fingers are left exact by default.
207
+ """
208
+
209
+ fraction: float = 0.25
210
+ max_radius: float = 10.0
211
+ min_radius: float = 0.1
212
+ min_edge: float = 2.0 # ignore shorter edges (arc facets, joints) when bounding the radius
213
+ points: int = 64 # points per full circle
214
+ layers: tuple[str, ...] = ("M1", "M3")
215
+
216
+
217
+ # ---- junction process (components-pdk agent; design decisions #1 / #21, 2026-11-03) ------------------------------
218
+ @dataclass(frozen=True)
219
+ class JunctionProcess:
220
+ """Quantcore Nb/AlOx/Nb trilayer junction rule (2026-11-03): Nb gap Δ = 1.4 meV, R_n 40–50 kΩ, qubits
221
+ at 4–8 GHz. Formulas: :mod:`quantcore_circuits.circuit.bridges` (I_c·R_n = πΔ/2e, Ambegaokar–Baratoff at
222
+ T ≪ T_c; L_J = Φ0/2πI_c; R_n = R_n·A / area; :func:`~quantcore_circuits.circuit.bridges.size_junction`).
223
+
224
+ **Assumed** (not stated in the fab spec; flagged as an open assumption): the specific resistance
225
+ ``rn_area_ohm_um2`` = 45 kΩ × 0.30 µm², chosen so the trilayer chips' nominal qubit junction (straight 0.5 µm ×
226
+ bent 0.6 µm: chip_05 Q2–Q6, chip_10a, chip_11m ``JX``, the centre of the chip_04/06/08 test sweeps) has
227
+ R_n = 45 kΩ; that is J_c = πΔ/(2e·R_n·A) ≈ 0.163 µA/µm² (16 A/cm²). ``cj_fF_per_um2`` (50 fF/µm²) is the
228
+ usual Nb/AlOx/Nb specific capacitance. Sizing keeps the bent finger at ``bent_finger_um`` and solves the
229
+ straight finger, rounded to ``finger_grid_um`` within ``finger_range_um``.
230
+
231
+ ``spacer_gradient`` switches the 51–53/0 dose levels on by default in every junction cell that draws a 50/0
232
+ spacer (decision #4: rectangular spacers split into ``spacer_shades`` nested strips of width/3, windows and
233
+ concentric spacers into rings; :func:`quantcore_circuits.layouts.junctions.trilayer.spacer_gradient_levels`).
234
+ """
235
+
236
+ material: str = "Nb/AlOx/Nb trilayer"
237
+ gap_meV: float = 1.4
238
+ rn_target_kohm: tuple[float, float] = (40.0, 50.0)
239
+ rn_nominal_kohm: float = 45.0
240
+ f_q_range_GHz: tuple[float, float] = (4.0, 8.0)
241
+ nominal_fingers_um: tuple[float, float] = (0.5, 0.6) # (straight, bent) of the trilayer chips' qubit junction
242
+ rn_area_ohm_um2: float = 13500.0 # ASSUMED: rn_nominal_kohm × the nominal finger area
243
+ cj_fF_per_um2: float = 50.0 # ASSUMED
244
+ bent_finger_um: float = 0.6
245
+ finger_grid_um: float = 0.01
246
+ finger_range_um: tuple[float, float] = (0.1, 2.0)
247
+ spacer_gradient: bool = True
248
+ spacer_shades: int = 3
249
+ # the R_n window is for the device: a SQUID's parallel R_n (2026-11-13: "40-50 kΩ is for the whole SQUID,
250
+ # actual junctions are higher based on ratio"); a symmetric SQUID's junctions are 2× (asymmetric: by the ratio)
251
+
252
+ @property
253
+ def nominal_area_um2(self) -> float:
254
+ return self.nominal_fingers_um[0] * self.nominal_fingers_um[1]
255
+
256
+ @property
257
+ def jc_uA_per_um2(self) -> float:
258
+ """Critical-current density implied by ``gap_meV`` and ``rn_area_ohm_um2`` (µA/µm²)."""
259
+ return 3.141592653589793 * self.gap_meV * 1e-3 / 2 / self.rn_area_ohm_um2 * 1e6
260
+
261
+
262
+ @dataclass(frozen=True)
263
+ class KineticInductance:
264
+ """Kinetic inductance of the superconducting film (decision #45, 2026-11-03).
265
+
266
+ Sheet kinetic inductance of a film of thickness ``t`` and London penetration depth ``λ_L`` in the local London
267
+ limit (uniform current across the thickness, T ≪ T_c, dirty-limit λ_eff supplied as ``λ_L``):
268
+
269
+ L_s = μ0 · λ_L · coth(t / λ_L) [H/□] (Annett 1990; Tinkham §3; coth → λ_L/t · μ0 λ_L for t ≪ λ_L)
270
+
271
+ For the Nb of this PDK (λ_L = 90 nm, t = 200 nm): L_s = 0.1158 pH/□ (≈ 0.12 pH/□).
272
+ ``sheet_inductance_pH_sq`` overrides the formula with a measured value (e.g. from a resonator-frequency fit);
273
+ ``enabled=False`` switches kinetic inductance off everywhere (analytic CPW formulas, resonator lengths, wire
274
+ inductors): the old values return.
275
+ Not valid when t ≳ 3 λ_L (bulk: use the geometric inductance only, L_s → μ0 λ_L is still the surface value) or
276
+ for dimensions ≲ the Pearl length 2λ²/t.
277
+ """
278
+
279
+ enabled: bool = True
280
+ sheet_inductance_pH_sq: float | None = None # explicit L_s override (pH/□); None: from λ_L and t
281
+
282
+ def sheet_pH_sq(self, stack: Stack) -> float:
283
+ """L_s in pH/□ (0 when disabled)."""
284
+ if not self.enabled:
285
+ return 0.0
286
+ if self.sheet_inductance_pH_sq is not None:
287
+ return float(self.sheet_inductance_pH_sq)
288
+ lam, t = stack.london_penetration_depth_um, stack.metal_thickness_um
289
+ x = t / lam
290
+ return 4e-7 * math.pi * lam * 1e-6 / math.tanh(x) * 1e12
291
+
292
+
293
+ @dataclass(frozen=True)
294
+ class Pdk:
295
+ name: str
296
+ version: str
297
+ fab_layers: dict[str, FabLayer]
298
+ stack: Stack = field(default_factory=Stack)
299
+ cpw_a: float = 10.0 # centre width, µm
300
+ cpw_b: float = 6.0 # gap, µm
301
+ turn_radius: float = 100.0
302
+ m3_margin_um: float = 5.0 # legacy: 3/0 = 1/0 grown by this; superseded by ``keepout`` (other_margin)
303
+ face: str = "1t1"
304
+ design_grid_um: float = 0.001 # snap grid for GUI placement (KLayout grid is used if coarser)
305
+ die_size: tuple[float, float] = (7500.0, 7500.0) # standard die (µm)
306
+ frame: DieFrame | None = field(default_factory=DieFrame) # None: KQC's chip frame instead
307
+ brand: str = "QCT" # brand text on chip frames (2026-11-03)
308
+ keepout: KeepoutRule = field(default_factory=KeepoutRule) # 3/0 keep-outs
309
+ cheese: CheeseRule | None = field(default_factory=CheeseRule) # fab export only; None: no cheese
310
+ rounding: CornerRounding | None = field(default_factory=CornerRounding) # fab export only; None: sharp corners
311
+ junction: JunctionProcess = field(default_factory=JunctionProcess) # trilayer junction rule (components-pdk)
312
+ kinetic: KineticInductance = field(default_factory=KineticInductance) # film kinetic inductance (decision #45)
313
+ # other films of the process by name (2026-11-10: "yes we will do NbN; add it to the PDK"): the default
314
+ # film is ``kinetic`` (Nb); "NbN" is the high-kinetic-inductance film of KI devices (KI-TWPA, KIPA): L_s 20 pH/□
315
+ # as the NY CREATES / twpa-sim geometry assumes. Choosing a film per element is a later step
316
+ films: dict[str, KineticInductance] = field(
317
+ default_factory=lambda: {"Nb": KineticInductance(), "NbN": KineticInductance(sheet_inductance_pH_sq=20.0)}
318
+ )
319
+
320
+ def film(self, name: str | None = None) -> KineticInductance:
321
+ """The kinetic inductance of film ``name`` ("Nb", "NbN"); None → the default film (``kinetic``)."""
322
+ if name is None:
323
+ return self.kinetic
324
+ if name not in self.films:
325
+ raise KeyError(f"PDK {self.name}: no film {name!r}; films: {sorted(self.films)}")
326
+ return self.films[name]
327
+
328
+ def material_dict(self) -> dict:
329
+ return {
330
+ self.stack.substrate_material: {
331
+ "permittivity": self.stack.substrate_permittivity,
332
+ "dielectric_loss_tangent": self.stack.substrate_loss_tangent,
333
+ }
334
+ }
335
+
336
+ def simulation_params(self) -> dict:
337
+ """KQC ``Simulation`` parameters for this stack."""
338
+ s = self.stack
339
+ return {
340
+ "face_stack": [self.face],
341
+ "substrate_height": [s.substrate_height],
342
+ "substrate_material": [s.substrate_material],
343
+ "material_dict": str(self.material_dict()),
344
+ "metal_height": [s.metal_height],
345
+ "upper_box_height": s.upper_box_height,
346
+ "lower_box_height": s.lower_box_height,
347
+ }
348
+
349
+
350
+ _FAB_LAYERS = {
351
+ "M1": FabLayer(1, 0, "base_metal_gap", description="fine structure etch (negative)"),
352
+ "JJ_STRAIGHT": FabLayer(2, 0, "SIS_junction", description="junction top finger"),
353
+ "M3": FabLayer(3, 0, "derived", description="second-metal keep-out: filled keep-outs (KeepoutRule)"),
354
+ "JJ_BENT": FabLayer(4, 0, "SIS_junction_2", description="junction second finger"),
355
+ "HSQ": FabLayer(50, 0, "hsq", description="junction spacer material"),
356
+ "SPACER_1": FabLayer(51, 0, "spacer_1", description="spacer gradient, shade 1"),
357
+ "SPACER_2": FabLayer(52, 0, "spacer_2", description="spacer gradient, shade 2"),
358
+ "SPACER_3": FabLayer(53, 0, "spacer_3", description="spacer gradient, shade 3"),
359
+ "CHIP_BOUNDARY": FabLayer(100, 0, "chip_boundary", description="chip boundary"),
360
+ "WAFER_BOUNDARY": FabLayer(500, 0, "wafer_boundary", description="wafer boundary"),
361
+ "WAFER_MARKERS": FabLayer(501, 0, "wafer_markers", description="wafer markers"),
362
+ "MARKERS_DICING": FabLayer(1000, 0, "marker_0", description="dicing markers"),
363
+ "MARKERS_ALIGN": FabLayer(1001, 0, "marker_1", description="alignment markers"),
364
+ "AIRBRIDGE_PADS": FabLayer(300, 0, "airbridge_pads", description="airbridge pads"),
365
+ "AIRBRIDGE_BRIDGE": FabLayer(301, 0, "airbridge_flyover", description="airbridge bridge (301/0 assumed)"),
366
+ "TSV": FabLayer(700, 0, "through_silicon_via", description="through-silicon vias", faces=("1t1", "2b1")),
367
+ "FC_M1": FabLayer(800, 0, "base_metal_gap", description="flip-chip top chip (face 2b1) etch", faces=("2b1",)),
368
+ "FC_BUMPS": FabLayer(801, 0, "indium_bump", description="indium bumps", faces=("1t1", "2b1")),
369
+ "FC_UBM": FabLayer(802, 0, "underbump_metallization", description="under-bump metal", faces=("1t1", "2b1")),
370
+ "FC_JJ_1": FabLayer(803, 0, "SIS_junction", description="face 2b1 junction finger 1", faces=("2b1",)),
371
+ "FC_JJ_2": FabLayer(804, 0, "SIS_junction_2", description="face 2b1 junction finger 2", faces=("2b1",)),
372
+ }
373
+
374
+ # Default process: Nb on sapphire. Version 2: the 2026-11-03 layer map and die frame (v1 had HSQ on 500/0).
375
+ QUANTCORE_NB_SAPPHIRE_V1 = Pdk(name="quantcore_nb_sapphire_v1", version="3", fab_layers=_FAB_LAYERS)
376
+
377
+ # Same layers and CPW rules on high-resistivity silicon (kept for comparison runs and older designs).
378
+ QUANTCORE_NB_SI_V1 = Pdk(
379
+ name="quantcore_nb_si_v1",
380
+ version="3",
381
+ fab_layers=_FAB_LAYERS,
382
+ stack=Stack(substrate_material="silicon", substrate_permittivity=11.45),
383
+ )
384
+
385
+ DEFAULT_PDK = QUANTCORE_NB_SAPPHIRE_V1.name
386
+ _PDKS = {p.name: p for p in (QUANTCORE_NB_SAPPHIRE_V1, QUANTCORE_NB_SI_V1)}
387
+
388
+
389
+ # A design's own substrate on a PDK: "quantcore_nb_sapphire_v1+substrate(h=500,eps_r=11.45,tan_d=1e-06)" is that PDK
390
+ # with the substrate thickness (µm), permittivity and loss tangent replaced (any subset; the KLayout plugin's Chip
391
+ # settings write it). Everything that reads the design's PDK (CPW / λ/4 estimates, LOM, simulation exports) follows.
392
+ SUBSTRATE_KEYS = {"h": "substrate_height", "eps_r": "substrate_permittivity", "tan_d": "substrate_loss_tangent"}
393
+ _SUBSTRATE_RE = re.compile(r"^(?P<base>[^+]+)\+substrate\((?P<args>[^)]*)\)$")
394
+
395
+
396
+ def substrate_name(base: str, h: float | None = None, eps_r: float | None = None, tan_d: float | None = None) -> str:
397
+ """The PDK name of ``base`` with its own substrate values (None / equal to the PDK's: left out; all left out: the
398
+ plain ``base``)."""
399
+ stack = get_pdk(base).stack
400
+ parts = []
401
+ for key, value in (("h", h), ("eps_r", eps_r), ("tan_d", tan_d)):
402
+ if value is not None and abs(float(value) - float(getattr(stack, SUBSTRATE_KEYS[key]))) > 1e-15:
403
+ parts.append(f"{key}={float(value):g}")
404
+ return f"{base}+substrate({','.join(parts)})" if parts else base
405
+
406
+
407
+ @cache
408
+ def _with_substrate(name: str) -> Pdk:
409
+ m = _SUBSTRATE_RE.match(name)
410
+ if m is None:
411
+ raise ValueError(f"unknown PDK {name!r}; known: {sorted(_PDKS)}")
412
+ base = get_pdk(m["base"])
413
+ values = {}
414
+ for item in filter(None, (s.strip() for s in m["args"].split(","))):
415
+ key, _, value = item.partition("=")
416
+ if key.strip() not in SUBSTRATE_KEYS:
417
+ raise ValueError(f"PDK {name!r}: unknown substrate key {key.strip()!r}; keys: {', '.join(SUBSTRATE_KEYS)}")
418
+ values[SUBSTRATE_KEYS[key.strip()]] = float(value)
419
+ return replace(base, name=name, stack=replace(base.stack, **values))
420
+
421
+
422
+ def get_pdk(name: str = DEFAULT_PDK) -> Pdk:
423
+ try:
424
+ return _PDKS[name]
425
+ except KeyError as e:
426
+ if "+substrate(" in str(name):
427
+ return _with_substrate(name)
428
+ raise ValueError(f"unknown PDK {name!r}; known: {sorted(_PDKS)}") from e
429
+
430
+
431
+ def register_pdk(pdk: Pdk) -> None:
432
+ _PDKS[pdk.name] = pdk
433
+
434
+
435
+ __all__ = [
436
+ "DEFAULT_PDK",
437
+ "QCC_LAYERS",
438
+ "QUANTCORE_NB_SAPPHIRE_V1",
439
+ "QUANTCORE_NB_SI_V1",
440
+ "CheeseRule",
441
+ "CornerRounding",
442
+ "KeepoutRule",
443
+ "DieFrame",
444
+ "JunctionProcess",
445
+ "FabLayer",
446
+ "Pdk",
447
+ "Stack",
448
+ "get_pdk",
449
+ "substrate_name",
450
+ "register_pdk",
451
+ ]