joqed 0.0.1__tar.gz

joqed-0.0.1/.gitignore

@@ -0,0 +1,218 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml

joqed-0.0.1/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

joqed-0.0.1/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.5
+Name: joqed
+Version: 0.0.1
+Summary: JoQED - design flow for superconducting quantum chips and their control circuits
+Project-URL: Homepage, https://github.com/joqed/joqed
+Project-URL: Repository, https://github.com/joqed/joqed
+Author: Roman Klimovich
+License: Apache-2.0
+License-File: LICENSE
+Keywords: EDA,circuit-QED,design-flow,quantum,qubit,superconducting
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# JoQED
+
+**Quantum control-circuit design flow.**
+
+JoQED (*Josephson QED*, pronounced "Jo-Q-E-D") is an early-stage design-automation
+project for superconducting quantum chips and their control circuitry: formulate
+physical targets (frequencies, χ, κ, T1, capacitances), simulate, and iteratively
+optimize the chip geometry until the targets converge.
+
+## Status
+
+Pre-alpha. This repository currently holds the reference design flows and tooling
+groundwork; the software itself is under construction.
+
+## Design flows
+
+Two reference flows, documented as flow charts in [docs/design-flow](docs/design-flow):
+
+| Flow | Chart | Stack |
+|---|---|---|
+| Commercial | [design_flow_hfss.pdf](docs/design-flow/design_flow_hfss.pdf) | Qiskit Metal → Ansys HFSS (eigenmode / capacitance) → pyEPR → optimizer |
+| Open source | [design_flow_opensource.pdf](docs/design-flow/design_flow_opensource.pdf) | Qiskit Metal → Gmsh → Palace (eigenmode / electrostatic) → EPR analysis → optimizer |
+
+The open-source flow runs identically on macOS and Linux; on Windows, Palace runs
+via WSL2 or Docker. The charts are generated by the `build_flow_*.py` scripts in
+the same directory (requires `reportlab`).
+
+## Tooling
+
+- [tools/build_palace.sh](tools/build_palace.sh) — builds
+  [Palace](https://github.com/awslabs/palace) (AWS's open-source FEM solver for
+  electromagnetics) from source into `tools/palace/`, using Homebrew-provided
+  CMake, Open MPI, gfortran, and OpenBLAS on macOS. Expect a 30–60 minute compile.
+
+## Open-source stack
+
+| Role | Tool | License |
+|---|---|---|
+| Chip layout | [Qiskit Metal](https://github.com/qiskit-community/qiskit-metal) (`quantum-metal` fork) | Apache-2.0 |
+| Meshing | [Gmsh](https://gmsh.info) | GPL |
+| FEM simulation (eigenmode, electrostatic) | [Palace](https://github.com/awslabs/palace) | Apache-2.0 |
+| Metal → Palace bridge | [SQDMetal](https://github.com/sqdlab/SQDMetal) | BSD-3 |
+| Quantum analysis | [scqubits](https://github.com/scqubits/scqubits), [QuTiP](https://qutip.org), [pyEPR](https://github.com/zlatko-minev/pyEPR) | BSD |
+| Optimization | [QDesignOptimizer](https://github.com/202Q-lab/QDesignOptimizer) | Apache-2.0 |
+
+## License
+
+[Apache License 2.0](LICENSE)

joqed-0.0.1/README.md

@@ -0,0 +1,48 @@
+# JoQED
+
+**Quantum control-circuit design flow.**
+
+JoQED (*Josephson QED*, pronounced "Jo-Q-E-D") is an early-stage design-automation
+project for superconducting quantum chips and their control circuitry: formulate
+physical targets (frequencies, χ, κ, T1, capacitances), simulate, and iteratively
+optimize the chip geometry until the targets converge.
+
+## Status
+
+Pre-alpha. This repository currently holds the reference design flows and tooling
+groundwork; the software itself is under construction.
+
+## Design flows
+
+Two reference flows, documented as flow charts in [docs/design-flow](docs/design-flow):
+
+| Flow | Chart | Stack |
+|---|---|---|
+| Commercial | [design_flow_hfss.pdf](docs/design-flow/design_flow_hfss.pdf) | Qiskit Metal → Ansys HFSS (eigenmode / capacitance) → pyEPR → optimizer |
+| Open source | [design_flow_opensource.pdf](docs/design-flow/design_flow_opensource.pdf) | Qiskit Metal → Gmsh → Palace (eigenmode / electrostatic) → EPR analysis → optimizer |
+
+The open-source flow runs identically on macOS and Linux; on Windows, Palace runs
+via WSL2 or Docker. The charts are generated by the `build_flow_*.py` scripts in
+the same directory (requires `reportlab`).
+
+## Tooling
+
+- [tools/build_palace.sh](tools/build_palace.sh) — builds
+  [Palace](https://github.com/awslabs/palace) (AWS's open-source FEM solver for
+  electromagnetics) from source into `tools/palace/`, using Homebrew-provided
+  CMake, Open MPI, gfortran, and OpenBLAS on macOS. Expect a 30–60 minute compile.
+
+## Open-source stack
+
+| Role | Tool | License |
+|---|---|---|
+| Chip layout | [Qiskit Metal](https://github.com/qiskit-community/qiskit-metal) (`quantum-metal` fork) | Apache-2.0 |
+| Meshing | [Gmsh](https://gmsh.info) | GPL |
+| FEM simulation (eigenmode, electrostatic) | [Palace](https://github.com/awslabs/palace) | Apache-2.0 |
+| Metal → Palace bridge | [SQDMetal](https://github.com/sqdlab/SQDMetal) | BSD-3 |
+| Quantum analysis | [scqubits](https://github.com/scqubits/scqubits), [QuTiP](https://qutip.org), [pyEPR](https://github.com/zlatko-minev/pyEPR) | BSD |
+| Optimization | [QDesignOptimizer](https://github.com/202Q-lab/QDesignOptimizer) | Apache-2.0 |
+
+## License
+
+[Apache License 2.0](LICENSE)

joqed-0.0.1/docs/design-flow/build_flow_hfss.py

@@ -0,0 +1,173 @@
+from reportlab.lib.colors import HexColor, white
+from reportlab.lib.pagesizes import A3
+from reportlab.pdfgen import canvas
+from reportlab.lib.utils import simpleSplit
+from pathlib import Path
+import math
+
+OUT = Path("output/pdf/qdesignoptimizer_design_flow_portrait.pdf")
+OUT.parent.mkdir(parents=True, exist_ok=True)
+W, H = A3
+TEXT = HexColor("#20252B")
+GRAY = HexColor("#F7F8FA")
+STROKE = HexColor("#68727D")
+BLUE = HexColor("#EAF3FF")
+BLUE_LINE = HexColor("#4A90E2")
+YELLOW = HexColor("#FFF4D6")
+YELLOW_LINE = HexColor("#D79B00")
+PURPLE = HexColor("#EDE7F6")
+PURPLE_LINE = HexColor("#7E57C2")
+GREEN = HexColor("#E8F5E9")
+GREEN_LINE = HexColor("#43A047")
+RED = HexColor("#E5533D")
+ARROW = HexColor("#59636E")
+
+def lines(text, font, size, width):
+    return simpleSplit(text, font, size, width)
+
+def text(c, value, x, y, width, font="Helvetica", size=8, leading=10):
+    ls = lines(value, font, size, width)
+    c.setFillColor(TEXT)
+    c.setFont(font, size)
+    for i, line in enumerate(ls):
+        c.drawCentredString(x + width / 2, y - i * leading, line)
+    return len(ls) * leading
+
+def box(c, x, y, w, h, title, detail="", fill=GRAY, stroke=STROKE, size=9):
+    c.setFillColor(fill)
+    c.setStrokeColor(stroke)
+    c.setLineWidth(1.3)
+    c.roundRect(x, y, w, h, 7, fill=1, stroke=1)
+    tl = lines(title, "Helvetica-Bold", size, w - 14)
+    dl = lines(detail, "Helvetica", 7.2, w - 14) if detail else []
+    total = len(tl) * (size + 1) + (5 + len(dl) * 8 if dl else 0)
+    top = y + (h + total) / 2 - size
+    text(c, title, x + 7, top, w - 14, "Helvetica-Bold", size, size + 1)
+    if dl:
+        text(c, detail, x + 7, top - len(tl) * (size + 1) - 4, w - 14, "Helvetica", 7.2, 8)
+
+def diamond(c, cx, cy, w, h, label):
+    c.setFillColor(YELLOW)
+    c.setStrokeColor(YELLOW_LINE)
+    c.setLineWidth(1.5)
+    p = c.beginPath()
+    p.moveTo(cx, cy + h / 2)
+    p.lineTo(cx + w / 2, cy)
+    p.lineTo(cx, cy - h / 2)
+    p.lineTo(cx - w / 2, cy)
+    p.close()
+    c.drawPath(p, fill=1, stroke=1)
+    text(c, label, cx - w / 2 + 12, cy + 4, w - 24, "Helvetica-Bold", 8, 10)
+
+def arrow(c, pts, color=ARROW, label=None, label_at=None):
+    c.setStrokeColor(color)
+    c.setFillColor(color)
+    c.setLineWidth(1.3)
+    p = c.beginPath()
+    p.moveTo(*pts[0])
+    for pt in pts[1:]:
+        p.lineTo(*pt)
+    c.drawPath(p, stroke=1, fill=0)
+    x1, y1 = pts[-2]
+    x2, y2 = pts[-1]
+    a = math.atan2(y2 - y1, x2 - x1)
+    s = 7
+    c.line(x2, y2, x2 + s * math.cos(a + 2.65), y2 + s * math.sin(a + 2.65))
+    c.line(x2, y2, x2 + s * math.cos(a - 2.65), y2 + s * math.sin(a - 2.65))
+    if label and label_at:
+        c.setFillColor(color)
+        c.setFont("Helvetica-Bold", 8)
+        c.drawCentredString(*label_at, label)
+
+def connector(c, pts, color=ARROW, width=1.3):
+    c.setStrokeColor(color)
+    c.setLineWidth(width)
+    p = c.beginPath()
+    p.moveTo(*pts[0])
+    for pt in pts[1:]:
+        p.lineTo(*pt)
+    c.drawPath(p, stroke=1, fill=0)
+
+def section(c, x, y, w, h, title):
+    c.setFillColor(BLUE)
+    c.setStrokeColor(BLUE_LINE)
+    c.setLineWidth(1.2)
+    c.roundRect(x, y, w, h, 9, fill=1, stroke=1)
+    c.setFillColor(BLUE_LINE)
+    c.setFont("Helvetica-Bold", 11)
+    c.drawString(x + 12, y + h - 18, title)
+
+c = canvas.Canvas(str(OUT), pagesize=A3)
+c.setTitle("QDesignOptimizer Design Flow")
+c.setAuthor("QDesignOptimizer")
+c.setFillColor(white)
+c.rect(0, 0, W, H, fill=1, stroke=0)
+margin = 48
+center = W / 2
+main_w = 250
+main_x = center - main_w / 2
+
+c.setFillColor(TEXT)
+c.setFont("Helvetica-Bold", 22)
+c.drawString(margin, H - 42, "QDesignOptimizer Design Flow")
+c.setFont("Helvetica", 10)
+c.setFillColor(STROKE)
+c.drawString(margin, H - 60, "Portrait overview: formulate targets, simulate, update design variables, and validate convergence")
+
+box(c, center - 75, 1076, 150, 42, "Start optimization project", size=9)
+arrow(c, [(center, 1076), (center, 1048)])
+box(c, main_x, 998, main_w, 50, "Project setup", "A Qiskit Metal design project", fill=BLUE, stroke=BLUE_LINE)
+arrow(c, [(center, 998), (center, 980)])
+
+section(c, 60, 830, W - 120, 150, "1. Problem formulation")
+cards = [
+    (77, "design.py", "Qiskit Metal chip layout"),
+    (217, "design_variables.json", "Initial geometry and junction values"),
+    (357, "parameter_targets.py", "Desired frequencies, kappa, chi, T1"),
+    (497, "optimization_targets.py", "Physical parameter-variable relations"),
+    (637, "mini_studies.py", "HFSS study, ports, and mesh settings"),
+]
+for x, title, detail in cards:
+    box(c, x, 865, 128, 72, title, detail, fill=white, stroke=BLUE_LINE, size=8.1)
+arrow(c, [(center, 830), (center, 806)])
+box(c, main_x, 756, main_w, 50, "Render chip in Qiskit Metal", "Build the current geometry")
+arrow(c, [(center, 756), (center, 727)])
+diamond(c, center, 697, 150, 60, "Simulation path")
+
+left_x = 110
+right_x = W - 330
+box(c, left_x, 598, 220, 48, "Ansys HFSS eigenmode simulation", "Resonant modes and fields", size=8.6)
+box(c, right_x, 598, 220, 48, "Ansys HFSS capacitance matrix", "Capacitances and coupling", size=8.6)
+arrow(c, [(center, 667), (center, 656), (left_x + 110, 656), (left_x + 110, 646)], label="Eigenmode", label_at=(center - 92, 660))
+arrow(c, [(center, 667), (center, 656), (right_x + 110, 656), (right_x + 110, 646)], label="Capacitance", label_at=(center + 92, 660))
+
+box(c, left_x, 518, 220, 48, "pyEPR energy participation analysis", "Hamiltonian and loss parameters", size=8.4)
+box(c, right_x, 518, 220, 48, "Capacitance and decay analysis", "Estimate kappa, T1, or capacitance", size=8.4)
+arrow(c, [(left_x + 110, 598), (left_x + 110, 566)])
+arrow(c, [(right_x + 110, 598), (right_x + 110, 566)])
+
+box(c, main_x, 434, main_w, 50, "Extract current quantum parameters", "Frequencies, chi, anharmonicity, kappa, T1, and capacitance", size=8.7)
+connector(c, [(left_x + 110, 518), (left_x + 110, 501), (center, 501)])
+connector(c, [(right_x + 110, 518), (right_x + 110, 501), (center, 501)])
+arrow(c, [(center, 501), (center, 484)])
+
+box(c, main_x, 350, main_w, 50, "ANModOptimizer", "Uses targets and physical relations to solve the approximate model", fill=PURPLE, stroke=PURPLE_LINE, size=10)
+arrow(c, [(center, 434), (center, 400)])
+box(c, main_x, 268, main_w, 50, "Propose updated design variables", "Respect constraints and adjustment rate")
+arrow(c, [(center, 350), (center, 318)])
+
+diamond(c, center, 210, 174, 60, "Targets and constraints met?")
+arrow(c, [(center, 268), (center, 240)])
+
+box(c, main_x, 116, main_w, 48, "Validate final design", "Run the chosen simulation again", size=9)
+arrow(c, [(center, 180), (center, 164)], color=GREEN_LINE, label="Yes", label_at=(center + 22, 169))
+box(c, main_x, 42, main_w, 48, "Save results and plot convergence", "Optimized chip design", fill=GREEN, stroke=GREEN_LINE, size=8.7)
+arrow(c, [(center, 116), (center, 90)], color=GREEN_LINE)
+
+update_x = W - 244
+box(c, update_x, 186, 180, 48, "Update Qiskit Metal design", "Apply new variables and rebuild", size=8.2)
+arrow(c, [(center + 87, 210), (update_x, 210)], color=RED, label="No", label_at=(center + 112, 220))
+arrow(c, [(update_x + 180, 210), (W - 34, 210), (W - 34, 781), (main_x + main_w, 781)], color=RED)
+
+c.save()
+print(OUT)

joqed-0.0.1/docs/design-flow/build_flow_opensource.py

@@ -0,0 +1,179 @@
+from reportlab.lib.colors import HexColor, white
+from reportlab.lib.pagesizes import A3
+from reportlab.pdfgen import canvas
+from reportlab.lib.utils import simpleSplit
+from pathlib import Path
+import math
+
+OUT = Path("output/pdf/qdesignoptimizer_design_flow_opensource_portrait.pdf")
+OUT.parent.mkdir(parents=True, exist_ok=True)
+W, H = A3
+TEXT = HexColor("#20252B")
+GRAY = HexColor("#F7F8FA")
+STROKE = HexColor("#68727D")
+BLUE = HexColor("#EAF3FF")
+BLUE_LINE = HexColor("#4A90E2")
+YELLOW = HexColor("#FFF4D6")
+YELLOW_LINE = HexColor("#D79B00")
+PURPLE = HexColor("#EDE7F6")
+PURPLE_LINE = HexColor("#7E57C2")
+GREEN = HexColor("#E8F5E9")
+GREEN_LINE = HexColor("#43A047")
+RED = HexColor("#E5533D")
+ARROW = HexColor("#59636E")
+
+def lines(text, font, size, width):
+    return simpleSplit(text, font, size, width)
+
+def text(c, value, x, y, width, font="Helvetica", size=8, leading=10):
+    ls = lines(value, font, size, width)
+    c.setFillColor(TEXT)
+    c.setFont(font, size)
+    for i, line in enumerate(ls):
+        c.drawCentredString(x + width / 2, y - i * leading, line)
+    return len(ls) * leading
+
+def box(c, x, y, w, h, title, detail="", fill=GRAY, stroke=STROKE, size=9):
+    c.setFillColor(fill)
+    c.setStrokeColor(stroke)
+    c.setLineWidth(1.3)
+    c.roundRect(x, y, w, h, 7, fill=1, stroke=1)
+    tl = lines(title, "Helvetica-Bold", size, w - 14)
+    dl = lines(detail, "Helvetica", 7.2, w - 14) if detail else []
+    total = len(tl) * (size + 1) + (5 + len(dl) * 8 if dl else 0)
+    top = y + (h + total) / 2 - size
+    text(c, title, x + 7, top, w - 14, "Helvetica-Bold", size, size + 1)
+    if dl:
+        text(c, detail, x + 7, top - len(tl) * (size + 1) - 4, w - 14, "Helvetica", 7.2, 8)
+
+def diamond(c, cx, cy, w, h, label):
+    c.setFillColor(YELLOW)
+    c.setStrokeColor(YELLOW_LINE)
+    c.setLineWidth(1.5)
+    p = c.beginPath()
+    p.moveTo(cx, cy + h / 2)
+    p.lineTo(cx + w / 2, cy)
+    p.lineTo(cx, cy - h / 2)
+    p.lineTo(cx - w / 2, cy)
+    p.close()
+    c.drawPath(p, fill=1, stroke=1)
+    text(c, label, cx - w / 2 + 12, cy + 4, w - 24, "Helvetica-Bold", 8, 10)
+
+def arrow(c, pts, color=ARROW, label=None, label_at=None):
+    c.setStrokeColor(color)
+    c.setFillColor(color)
+    c.setLineWidth(1.3)
+    p = c.beginPath()
+    p.moveTo(*pts[0])
+    for pt in pts[1:]:
+        p.lineTo(*pt)
+    c.drawPath(p, stroke=1, fill=0)
+    x1, y1 = pts[-2]
+    x2, y2 = pts[-1]
+    a = math.atan2(y2 - y1, x2 - x1)
+    s = 7
+    c.line(x2, y2, x2 + s * math.cos(a + 2.65), y2 + s * math.sin(a + 2.65))
+    c.line(x2, y2, x2 + s * math.cos(a - 2.65), y2 + s * math.sin(a - 2.65))
+    if label and label_at:
+        c.setFillColor(color)
+        c.setFont("Helvetica-Bold", 8)
+        c.drawCentredString(*label_at, label)
+
+def connector(c, pts, color=ARROW, width=1.3):
+    c.setStrokeColor(color)
+    c.setLineWidth(width)
+    p = c.beginPath()
+    p.moveTo(*pts[0])
+    for pt in pts[1:]:
+        p.lineTo(*pt)
+    c.drawPath(p, stroke=1, fill=0)
+
+def section(c, x, y, w, h, title):
+    c.setFillColor(BLUE)
+    c.setStrokeColor(BLUE_LINE)
+    c.setLineWidth(1.2)
+    c.roundRect(x, y, w, h, 9, fill=1, stroke=1)
+    c.setFillColor(BLUE_LINE)
+    c.setFont("Helvetica-Bold", 11)
+    c.drawString(x + 12, y + h - 18, title)
+
+c = canvas.Canvas(str(OUT), pagesize=A3)
+c.setTitle("QDesignOptimizer Open-Source Design Flow")
+c.setAuthor("QDesignOptimizer")
+c.setFillColor(white)
+c.rect(0, 0, W, H, fill=1, stroke=0)
+margin = 48
+center = W / 2
+main_w = 250
+main_x = center - main_w / 2
+
+c.setFillColor(TEXT)
+c.setFont("Helvetica-Bold", 22)
+c.drawString(margin, H - 42, "QDesignOptimizer Open-Source Design Flow")
+c.setFont("Helvetica", 10)
+c.setFillColor(STROKE)
+c.drawString(margin, H - 60, "Fully open-source stack: identical on macOS and Linux (Windows runs Palace via WSL2 or Docker)")
+
+box(c, center - 75, 1076, 150, 42, "Start optimization project", size=9)
+arrow(c, [(center, 1076), (center, 1048)])
+box(c, main_x, 998, main_w, 50, "Project setup", "A Qiskit Metal design project (Apache-2.0)", fill=BLUE, stroke=BLUE_LINE)
+arrow(c, [(center, 998), (center, 986)])
+
+section(c, 60, 836, W - 120, 150, "1. Problem formulation")
+cards = [
+    (77, "design.py", "Qiskit Metal chip layout"),
+    (217, "design_variables.json", "Initial geometry and junction values"),
+    (357, "parameter_targets.py", "Desired frequencies, kappa, chi, T1"),
+    (497, "optimization_targets.py", "Physical parameter-variable relations"),
+    (637, "mini_studies.py", "Palace study, ports, and Gmsh mesh settings"),
+]
+for x, title, detail in cards:
+    box(c, x, 871, 128, 72, title, detail, fill=white, stroke=BLUE_LINE, size=8.1)
+arrow(c, [(center, 836), (center, 800)])
+box(c, main_x, 756, main_w, 44, "Render chip in Qiskit Metal", "Build the current geometry")
+arrow(c, [(center, 756), (center, 734)])
+box(c, main_x, 690, main_w, 44, "Mesh geometry with Gmsh", "Export via SQDMetal to a FEM mesh (GPL)")
+arrow(c, [(center, 690), (center, 662)])
+diamond(c, center, 634, 150, 56, "Simulation path")
+
+left_x = 110
+right_x = W - 330
+box(c, left_x, 546, 220, 48, "Palace eigenmode simulation", "Resonant modes and EM fields (Apache-2.0)", size=8.6)
+box(c, right_x, 546, 220, 48, "Palace electrostatic simulation", "Capacitance matrix and coupling (Apache-2.0)", size=8.6)
+arrow(c, [(center, 606), (center, 598), (left_x + 110, 598), (left_x + 110, 594)], label="Eigenmode", label_at=(center - 92, 602))
+arrow(c, [(center, 606), (center, 598), (right_x + 110, 598), (right_x + 110, 594)], label="Capacitance", label_at=(center + 92, 602))
+
+box(c, left_x, 470, 220, 48, "Energy participation analysis", "EPR from Palace fields (SQDMetal, scqubits)", size=8.4)
+box(c, right_x, 470, 220, 48, "Capacitance and decay analysis", "Estimate kappa, T1, or capacitance", size=8.4)
+arrow(c, [(left_x + 110, 546), (left_x + 110, 518)])
+arrow(c, [(right_x + 110, 546), (right_x + 110, 518)])
+
+box(c, main_x, 382, main_w, 48, "Extract current quantum parameters", "Frequencies, chi, anharmonicity, kappa, T1, and capacitance", size=8.7)
+connector(c, [(left_x + 110, 470), (left_x + 110, 449), (center, 449)])
+connector(c, [(right_x + 110, 470), (right_x + 110, 449), (center, 449)])
+arrow(c, [(center, 449), (center, 430)])
+
+box(c, main_x, 310, main_w, 48, "ANModOptimizer", "Uses targets and physical relations to solve the approximate model", fill=PURPLE, stroke=PURPLE_LINE, size=10)
+arrow(c, [(center, 382), (center, 358)])
+box(c, main_x, 238, main_w, 48, "Propose updated design variables", "Respect constraints and adjustment rate")
+arrow(c, [(center, 310), (center, 286)])
+
+diamond(c, center, 186, 174, 56, "Targets and constraints met?")
+arrow(c, [(center, 238), (center, 214)])
+
+box(c, main_x, 104, main_w, 44, "Validate final design", "Run the chosen Palace simulation again", size=9)
+arrow(c, [(center, 158), (center, 148)], color=GREEN_LINE, label="Yes", label_at=(center + 22, 151))
+box(c, main_x, 40, main_w, 44, "Save results and plot convergence", "Optimized chip design", fill=GREEN, stroke=GREEN_LINE, size=8.7)
+arrow(c, [(center, 104), (center, 84)], color=GREEN_LINE)
+
+update_x = W - 244
+box(c, update_x, 162, 180, 48, "Update Qiskit Metal design", "Apply new variables and rebuild", size=8.2)
+arrow(c, [(center + 87, 186), (update_x, 186)], color=RED, label="No", label_at=(center + 112, 196))
+arrow(c, [(update_x + 180, 186), (W - 34, 186), (W - 34, 778), (main_x + main_w, 778)], color=RED)
+
+c.setFillColor(STROKE)
+c.setFont("Helvetica", 7.5)
+c.drawCentredString(center, 20, "All tools open source: Qiskit Metal (Apache-2.0), Gmsh (GPL), Palace (Apache-2.0), SQDMetal (BSD-3), scqubits / QuTiP (BSD), QDesignOptimizer")
+
+c.save()
+print(OUT)

joqed-0.0.1/docs/design-flow/design_flow_hfss.pdf

@@ -0,0 +1,74 @@
+%PDF-1.4
+%���� ReportLab Generated PDF document (opensource)
+1 0 obj
+<<
+/F1 2 0 R /F2 3 0 R
+>>
+endobj
+2 0 obj
+<<
+/BaseFont /Helvetica /Encoding /WinAnsiEncoding /Name /F1 /Subtype /Type1 /Type /Font
+>>
+endobj
+3 0 obj
+<<
+/BaseFont /Helvetica-Bold /Encoding /WinAnsiEncoding /Name /F2 /Subtype /Type1 /Type /Font
+>>
+endobj
+4 0 obj
+<<
+/Contents 8 0 R /MediaBox [ 0 0 841.8898 1190.551 ] /Parent 7 0 R /Resources <<
+/Font 1 0 R /ProcSet [ /PDF /Text /ImageB /ImageC /ImageI ]
+>> /Rotate 0 /Trans <<
+
+>> 
+  /Type /Page
+>>
+endobj
+5 0 obj
+<<
+/PageMode /UseNone /Pages 7 0 R /Type /Catalog
+>>
+endobj
+6 0 obj
+<<
+/Author (QDesignOptimizer) /CreationDate (D:20260825110331+03'00') /Creator (anonymous) /Keywords () /ModDate (D:20260825110331+03'00') /Producer (ReportLab PDF Library - \(opensource\)) 
+  /Subject (unspecified) /Title (QDesignOptimizer Design Flow) /Trapped /False
+>>
+endobj
+7 0 obj
+<<
+/Count 1 /Kids [ 4 0 R ] /Type /Pages
+>>
+endobj
+8 0 obj
+<<
+/Filter [ /ASCII85Decode /FlateDecode ] /Length 4300
+>>
+stream
+GauHO=d.XL&Up?ZJ]G^:@;m<68]?ONUagP(CQkb\\`d12QSRan*0N4p52?2>2E8&:8k[4)nt88g%J86gJ/+$\58!q1hD"Zb/c5K^_1Z@.Djet3B".eJYARE<"of),X)2\<[:m2`Sd?!R@gmbMf\8&[NK?U7ed-+PHu4Q0<]]R`#F8''JYaq#6bO=^co@QhEOaa4qouU"l&P`@p7M4\^ZkdQ*E]&hlXBPH\*Wf/]DZ1Y+gT<:bAnT3dG0#L=JN:a#$B<)MdT%UW[SZ9;gu&7S.9Cc@_;BjiI0U3p]GlT4)E20Hg97_4kt7Zise*DWTJr+pNQDo/i!(64nS+P6O-?>m2_9U+$ZrQ>8ZeBgTEWTG8&Ee1r6"_$_FCAOi+)as6d'@d4"]s[9Y4+S"QIEi6JXQ8pa@t@ASTm4GY0.3gfIq1d]RsYLn.YdI:N051-t3N_SO?iRp%,;JX,Yd_e]Acu<VsU6V;Z7OnUbf9DbUdYZdo4BtUop@[]Zp#S!&(Eu%fj"HOmXDP'5)EnB@Ja`ks%4FcoCJXnHbP$_I]5E%k&d5YQA<$.d.K`RH690`tHK#;d1Wkbmaf51dX`4U'e8:iggZV,lJ64bA&Inr_Y-o"HYlLK/>n_mt)Y%EMd%`W\1*N\Qn;5&da'CJ9deL?,!Od-W1<NDRYVLOC"d3J\)]'n]>%'ZoK[q@@T'1uh10e'VR4D2$M3W(EA14Y^>)(^<ZiXZ*B]*L$kf@WZ%i80HHO5db#&301AC<:]fpdXDG3hue4[mrJcQefmU*91Pk:8>KdjQ)Q>D*i+q@ib75Q1qSmAo[)%bY=i8skW0+f+:B6t6r4FRU&cH3*67=iPO5m*kJU,G&a[?GWirk@AUB8.Inr``j**k=,BG)_M.rUa?'[$5l[P-jbuU7^>,pY+SIA`#9La4(?78Og9B")p8Lh.,]27.ZCKN0B@1Z91J(XMkAo6>DMuQNP%Z="8#b7_'0d%a95;I.II]t+@/R*#G,?g^oZNbCfUU]cUPkUFn6B[+Xo\n^%J%J>UKS4!G-s_Lk82EQ$S[t6%OI%4b_cN:4e1.j`qaM.HdRWZ&CaJ"e8tVKfj5?($2':Su_B8!q'c9gm(#;;DpXNi0Gn/C#%L>HHlG/0msit34^aR_3e$)<8,'8kkAn,+*ZnsB*qMY/4HD@'U:"C"ID8gB-a2cZ';&O8u"48<tl=.R&#PE,V_n_j<t0DA0Oj5=A#<HV#hf3KUMXB7%+bDOnI^k1qt];?h<\fC!+UE$g]e^9`gIDhm`Q`#GL!u]1mK14N:Lph0HVm;$mGskO/,5;H>\K=h?4rm>7(8-W5smPVSPfPZ)91<U#B-`"A2tEL%k]AVlY:+];&<O.g-NE\%r]=X)tOpEEL9&9<(?%$gCt4g_HHh;S5c$!:)RJboXV[\Z=1<9MWaZ+#MVV_]S.4XLn.[ekK"KA(^jDT-82f^LG%/$b,9,Vlfka>af0``Phg:8LfaV(7E77nbZr4NlAr,%DXLN"a$;p5ro+96p*V("p`W0-XmN+9L")\E,?dQj3H&L7!t)(d#R*#G&j3c,8SH?\:*MJGh*)OugK4K4rl8J67A!BH6*[-3*nR>&SOQKJOJXc4WN)9+V\lL^5OX7&3`S[$Dg97ne`S=V;o$Pa`4m'gY53@Z7*<,%@Oe;%l?.^)'(gFW<<*$]9a7^[8d#T$DPQI7kd#)YDXkM?sT=Hi<(9_mph,fRA$(NFrNdmeC`A$';>K-K#Y58:WPVe8Of:9?6WY?7$r,o6;=W83H?p]Gf+Wc#PpR21+;-8C#f5OHM.08Wono=cuNm_J!UTNE%f.FWo*We\`@=Ve%hm:RMOrP,"m[.Oc[,-/gC"Po?0MA>mQT8PfemAN3pc[H9o<5no+Wi^i7_Qo9EFD=>&'$6]4_Ps[0kY'No9#fiJFj0W0bqr*R+*]g_n*tI-#<2,q[TcN)Y8Eo9``[V%,Vpn^[O3KGeX(DEs<7hjL0][:Q`+-m.8%)N0'=`=>Z^L?ML<Vufi#da=X0kKaj0J=MRFX(F6@8*m!_;E-2c$?GDu,t*JtG(e/9Zas+Da",:e=4n9+^/U46dY(_-i->O(L**MZfLG=GhBD/Ep#u8lr'U;"8`MB>N!r-'d;BKiFF]NC6J,@k!uZV:%>Kl"]4OGN/MqNlR/PVlo-;i6jc[$X!o3dp^Mppip>s-$9*6\)$E=\pWeu0:6&O#9eqVOMhLRLf*+SIq_4-E6_tc6#ZX<\2u;iFX)8p%8!:<Yj+PA-m?DDJ7"51;rb,TOTVRK,YVa%_aJ+QQJk[$AZ>ll_FQuu`e7TKfg*uAq++FY`5tD:YRkj9Zj_]tWRe]jClGX'g#37iXP808mSE4nh6B\$3qOM\MdsS.>O*R9c(Coe&nKS*o6u3\A8,h=p5W6jMp<=VITk/[36BYS8u_o[!6_6s91TErc>A)>[;,4gB>87N+cKAaZHV>M]ul61J(^$QQ:3p]aKdm-eHQ]#7Ne/b*LaG=*#ih?@b[],J8Tbg-3C#TrJW.R7aulV,X5canM<XH5@[C\1WI`=N3ULNi,A0B=<`1u8TZ2RCEuUI1H<Q3Q7i)o)#]Eg'SE)LK>F`ZGN`[IYJ;:>m79:hG^T2/GHBPBL\jS85u7Hjh^:qODVG24e)PJ_`hGdj=;_riST:<FdgrA4[VrY&C(.`7EQWra%?D`KO!AD#,DaAh&g9,ta%=(683?Q*./[d/>Bu`lPK?6qia9i!;iRb=:4`ou00G8f*bR2-)$@-\OIcH.BPWjj?+4\nQcG,kVU8FAm(>BNq@-c6O,%2RieHh1eF+u"B@05f80sNPoe&cImpb(+G8XUqmo$Q<$!5(u-e9Wm?J,"j6FQ>=*p9Z2IBOMo-8X6r5a%N[8MY?49;\hVRq:_ChV_/)F#5])T$K05mIc^3,=+)+,Y;U.ABD4%85kLh1c*bRid)e)VpfUhOD<%df02-.T>$U;_ce(8?.t1UVDS,!a4$_fT1Y:EdhsA(oB$>uqQ_@e5jea8QQYL>55(Ed:<-;tG5KW-2IOou#9Rl_DT8XE':#n%5uCUC$^q,eEqOM-FK%'jesT;Sn.UC0*/k#5$$k(3!EP?C"W7(#n\Wp0+"pU<RXc44^eiqn=G#FPef48q^;+c?AV_Za!skU;?I_h_37UeMM1-XOoM$2\dndWH+o80iUACj@Sa.Zd6pE]8oTSl=5CkB^<^n8jMWuQE1/LlnoFi$=XnfO(3I>1(Pllu"!psC<NLAGN?g[:(_mSTj;!97?>uBWNrP+ASE/f&V;8r8)6D7WkYg\UQGJj;1*iFQU*d/WhkJUnA=?7CX7\5_>iop\K;8Deh:Huj2"n:;"mZ=6H*],$3!0:XkY]O=YGe?G<J/?a_-BqI=GU:FX-7,\T9M/9fR?3p=S4=b\eRKq:A>#`c!?N%TXa,bu@djHMM<$Y>>GhAefSsenmk,YM/uJlm2A#18-G:hJeAj_dUKRcXnH%fr</:28h>)<LTPlpm;bMa+>"h8?MjJc_<"J_fe5sIM2ToL3R_@YK=DHpCi/Lb__1E7h-h%]\Uq;M5IIZ:$eP/jQLJ*3p/[8&M4:n._EG9\dKs$b,P=O>h+qLZV)kXB<Q:KJA+lae8F\d]:0g8-'O!DXASk@)hSk>A")A[K;%1>h'@3k&@8m=a%859[?m5u:&VM^+j&c.SebjVNM+k<$J0L!c>)J3@Yes?f\^[k[q\,E`tDd;dc#/oX*JmSQ#rFg2rgN5[Q!&eag%d-uA%fiM+9:-#rd)7$QAr.?:&_^$.])#1S=10GIXa^4aX%6-ul]L8\XLo.Bc$kD@?TuV2VX`*p"<h[1IqkGpGeEVPona8o'0qPR8T,<7gnDn:;H>fRXAVS\njP?1+9U.2?\PD,*h<KJS;&LO%97'[87_#KJZ5j4;B;dEdEJpdaljY0ar*Jc[IOaq4/RsT>)3:lh=3VgLiM(<T)&hKQRRoLa?\\rVToKXNem/PL%;(+/u0tk]$h+TYE/"ia3hD<J+<<DIX=am^!$^`5+W)gDrWoi5*>Um<Mope,i^]?oPLt:;bbJ_$7Y#[ogC:$+23cQ8VN^\riG/W@QfkKb#kGA6mPKoO#5D.R-Opma?[hjBc.Bs;Q]cjka'?GphR'H^trbnn9HGG9hL2hTAs1%l+Ys-*T\1L4^ce`?b>_"_^!oZ+/W.!C=]*U!M;*nWI;\k`%m/QRGp5[p[p0Bh,P/u+i4d.hGk<!&E'qbcQL/N5+1p=A2?Cj;FZ1$aj2X:!@'m?"@dns?0QaM>A+BkE(A2:Vctj;cD*1b*q=K;2i(MNb4,s7,TSBCJ%Cosdk7rVrrDStm`k~>endstream
+endobj
+xref
+0 9
+0000000000 65535 f 
+0000000061 00000 n 
+0000000102 00000 n 
+0000000209 00000 n 
+0000000321 00000 n 
+0000000524 00000 n 
+0000000592 00000 n 
+0000000880 00000 n 
+0000000939 00000 n 
+trailer
+<<
+/ID 
+[<fcbf56e7fb3cee579be603e7960c0999><fcbf56e7fb3cee579be603e7960c0999>]
+% ReportLab generated PDF document -- digest (opensource)
+
+/Info 6 0 R
+/Root 5 0 R
+/Size 9
+>>
+startxref
+5330
+%%EOF

joqed-0.0.1/docs/design-flow/design_flow_opensource.pdf

@@ -0,0 +1,74 @@
+%PDF-1.4
+%���� ReportLab Generated PDF document (opensource)
+1 0 obj
+<<
+/F1 2 0 R /F2 3 0 R
+>>
+endobj
+2 0 obj
+<<
+/BaseFont /Helvetica /Encoding /WinAnsiEncoding /Name /F1 /Subtype /Type1 /Type /Font
+>>
+endobj
+3 0 obj
+<<
+/BaseFont /Helvetica-Bold /Encoding /WinAnsiEncoding /Name /F2 /Subtype /Type1 /Type /Font
+>>
+endobj
+4 0 obj
+<<
+/Contents 8 0 R /MediaBox [ 0 0 841.8898 1190.551 ] /Parent 7 0 R /Resources <<
+/Font 1 0 R /ProcSet [ /PDF /Text /ImageB /ImageC /ImageI ]
+>> /Rotate 0 /Trans <<
+
+>> 
+  /Type /Page
+>>
+endobj
+5 0 obj
+<<
+/PageMode /UseNone /Pages 7 0 R /Type /Catalog
+>>
+endobj
+6 0 obj
+<<
+/Author (QDesignOptimizer) /CreationDate (D:20260826120043+03'00') /Creator (anonymous) /Keywords () /ModDate (D:20260826120043+03'00') /Producer (ReportLab PDF Library - \(opensource\)) 
+  /Subject (unspecified) /Title (QDesignOptimizer Open-Source Design Flow) /Trapped /False
+>>
+endobj
+7 0 obj
+<<
+/Count 1 /Kids [ 4 0 R ] /Type /Pages
+>>
+endobj
+8 0 obj
+<<
+/Filter [ /ASCII85Decode /FlateDecode ] /Length 4706
+>>
+stream
+GauHO>E@;o&q3'[_N2p@ai&CM?<4;GBI0#H\p$Xp+cS7T"!,InbXi;kqs1`6Ng"M[1t0f[6-q7)Yq)u\>SgI_<l/2bra0R\H[NYYI)[$?m,BVWW_i'A3I?(WJhHhFGdlC]Thb-p3U[gJ^+?XG7l>Yj[oL7u<h:%2kn9R'gc-N0^)&+39SA7V)(1/f54G4a3p"5#(E<)+eW[R[hJIbupW]T2Dgc$.md'8XoA/r@Y$$.lT!c1+5Hp(?m,Ds$Ck;O?YV1_g$<:9-,V,+bV$?XX0=a"D>M8SQ*1).uCtia6__o'9B%L,M%mR>]ZJP<"\n]o9b;RoIf5ju00A5r/Hi2+E4SZ&3?LC""lu:a'lt+^JnE.cg@_\Hu(Mn;':Nl%7p#4.+K^HXsI4Dmhqr_66]g)d?j8JYs.pbd?Bsh5</IJ]>2-sJ(2Cml/U"bk'U2V6;81UmaVnV)PFu[UpX,2QqiUr%.KsPTaO)r@=eW<rJDNJa;;Yd&o>"2\qfjqIBj6MSCdo&6443`OfPCNIUFgZOC#8I"7O0W^`5q%^AN,o=IHPpdAhH,IRE"GiJoaM1TJ(VH<f0,BAYZ2$28EYZU+=5.+PpiJ5ScCR!r0S*CPolh;mbi@S#5W:t.YR?uFfc!g5u?q/3,T*+&B`$.Sm.s$Dd%BCBQbOCZ3h&%9).Xif5ubSEnG4>gU^O%kpE]ABf4fM8Nk1tj<ut@Tg;S0<]n#Xd/b-FFQ$0<[0!b-=;a"gp^n9,$U:,>Fs,!7%G\<.*S;Cq_iMpRHO5db"t=6uA3q(n_!GXN'^P&`\>RFEniE;o,+PVBjEtD_/IO.&gdKGCPod23:%t@Gfo*Fs6gQS"U][LQ!.2)VelVN3;3^l"[04DME!Y^P*8oI<nEjYb!4FiU4Ub!QcA$a1]L@@[n]XQe6*1mL]HPr0Ba\QqTWB(`T2T;u$G[SE6!TJH[hdjA8SE@L"\Z2\(Q8_FYsnrWNYiMo7`ptE]@_jP@:U7ACL^l4,e\nZ%c<GbHHX?)BSEQU\B7.n"H`jA)],`r$O/lpUTHKAmI%2=[c'Is-lF%Z3ufVeauVME2Cjg"LM,(.JG(u*Y9Ab4FV]uh=fR$<ou!(+Jr)'$h\]_n?nQFgr40g9YgKUY)(.`Xp2GC4ZuN":JIAii0eAgN6@K,fms4uD,4)9^m"mme!qaYdi3r9.e$-A['8uh^@d;94$,-Q5m7lR!.[fk2YF7UiX6\THs$e.=OeaC:P+koDMI=8um>Q^VL454nC^nf0?UZ^.N)>JB8ee$37#lj45t1o%M6/2KfLc\f7$ri"7AMBJ3Z5t68FuS:eY/s-@CkHHQYFV@,R`rT(68SBfmdn/^&aqAX*:&E5?nH&o_idA%Sk3fW]eqh2bI5A,\:PNPa*Ik<fT^2&h%=-74H:.+KFs3'I(g>V2VHC.8*%(/2`Q1,Y[\aPE]Q-6-Klh-b^CZZ31]fENZ:*pXPshc)qSlK:DY=m^jdq(Uu,oeV4DK".qr/ake*(5EGJ\h:16uqbZ\SeJW,n)8"ha-t?O0)&o/XC]om*&OaX$5T+&^auHg66&i(B#][j4@pLE!l]T=kGp;9>Qk53%)9:=4q"Q>EQ2"ZR`gVNIV?CiG[W%<_p&2X\Qo-hd42IBT=bE)K?<qau`Z,$Q0V'J7]K8l_Ca"5BMF`pNl=cg)<U5W:Lp/o`_A\"3CBu+.JV_*B6pti;95=eWE5m\>>U:Qq>e(.Q7M8*W,5=\a+X4?-*#1b-id28*(gFksQCK..dqkN2]Dd$]g:&=?N95)ZUVB6Z&5rkEg@Z?<mg_K/4J(n(Dn<!u=>8;@f(0:XS%?5Ki1b.un%,@OqVX7FZ7P0V4a%FHhNd6!><`NhDLFG0Slq3j_r5l5@TOgHm#'j@MH]D&o4I>DP/aZU9,bBF4Ji^nj)k&Zj&/F0a>ND6(hb*RL8!X$UdrkC'cA0'lcA<M*I^QQc&3i;,_uQX8IKEUK[oC7HW_Gb+5(J:aDs9sLi=-fQ!7aQAKN"`p6,)M2-V.5LO.^9:=%A8%WESe<-)__(P0$6PNW.VLLCMCfs$1'D1"pKN?j'5Os<qcQSW:oD_l&7RmC8E1MGhC9NhQ%JTfhF$&_[n+K(X)*apM)OcbrmEX$CYOR/GQK!oY1'3MCAN4m"?F7c:n2>u)'aLuM0"p?>n-d/;[:I!n8*n&$jYF`ZDXl$C@4a[$WKbOC/K:cL7?Tp+VO@)P`js\8&JoYAV8X'b''$@Oh*&B@S70$p)kiO#j?b!le.nmm,)3M%6r5EA?9H_'j;fH*t.?tmFhU1sc_f&9rl#?>/Vi/*Ho-WQ\^a\TQ(<bTVNlb$Q8lEaWJqumTQ3<4fM2FA7n:Aq0>/HRm>mW)IW7CO?LXA)V8)4TSGZ7>]PNi7l3I*IncA'_dPr?)!imXq87n:;^mU_ePs5^/4#Zrcr_-,/d'UF&/Fn;cmDK_B)"#VG]:A;to-ig1H=_Y79K1U\\]`OCLCNdPE!pt?heEpiAL%OTB0VGt7M80B"$YhS_i'e#-J1)upXlSa"+I/oRi*ml43$pD;H(#6B9hPYW9T0+U?oV*m3(1W&5+cQS$)j95!1es?S5.N^I$oBR1*An,QI=D!+DU4bJ(Sm,^h<U/J;!HZ$bJ4skoUX*V<P$4XM:b26h<<gBtZUr>O]MEF/g5k7<52>]VE:W=Op*i9VOGlOp-XKF3U*p6Uj>NC-7/ffneBCqs0HSK[A6QQ:3W_8`Th(HP-r+&_8`nm7u6?_:1ukTf(Suq'^d&G$6Q-:!.a+XdlhVi+l2"":k`IKIpYlO@3<JXIP63$5X>k"GQa4fMZd#KU9GeN5?l\0HK+uGd8aQ7Ji9TN<C>^OUAQHYpF&&#h_gthu+Nl_`:Vdn-6G^T]B:,a'jj=rL[un_n0\Xa1q`(m%YY!D6*BACUs\oOY%]c_A'"<%WUHoYM%[JDNefA7RND&`&#uHs#g;.o\K6q8.c9*Q&(55/I7N7JJfb$H>I2T!^I$jjou,W0H$YdQ,uW$]M')o4(<Ze9VdGBK,!9383&Isp`\<L0*<K%_%HCX&KjrOJEGdq?<>b%,=rh[..i0!P.J@.4&i,"nHD.pJs>rmA)n]oD6Oc=aM\j<eB2`#Xc+%\L6[T?P*O-YgkVrpHk*5PjN(]Z24a=p*p9<H3M/+=9LLP)TFj>M,bdeLN6nEMZ\VpK:Et03Z=K45o44,L,[#g(M<L'I&Nu:eKKd[LHEq&r1=B&ucQ[]5OR/J*Y'kK?5'8?lL2XI2eMC3WP,&Z$5?-rtbT$M+"BYW5RI]^fW?Bj*_Kg&CPZ0)Qr/=t:K_q3QHW;(E].I-Mrq_T=AoJO#;E:]`L8-i=i$1e**6?Zs[-<=j`475cCFB#e-Op(f-S6Mq9/9lka[IV'3gi)=9=]jp=Q-MA";p^+#+"1[]EJW<#u<goJS"=#$j-d/_Of=SSn6]=V#&2)`_H#L`_H"Tj!JnL#:6dHl)3%,%LNN:T1BUn6up_b1_],qMP-%CWh4[1EPi=/^A4r.3NL)ob2FIr"76(1d_rGe?XE(Oa(!BVPRq)P:uiokN6;.M5u9f$iWU(OVlR8r\dWXth6-]YLC>sejC.dC>##Jug81R-E6&\jhl-Ch/cp:1(Hr#t@9<SY2JaOh,\0sOLElm_Os>L2i\S@XPu[eilRCbG'/RE3B-tEP:a.bO&dkI)KH`DXGarL5Z(;#'W3#3$jE-hcP,^_lQ:N`_Df71^<K*B(rq<t,B#jirT^+A`if,f?$g*mP!PY^J6;KO!h&Zt'ec9qKM9U3?L[+I/Z0O>^)\9a6iaCqPVHM]U!#0\^TX^g":ui@Afs#g6RK^ai?'f`5#=\V_=Y8nc**JFg]m$=knDL-nl$O@:F$WPK.N\(Trk>a%JjSXm5F2W$m^GLteL>e5m!^H([a=!N5t/oSK-WI)3'D"9#V\Jj@X\&?cDloTgtM>#l?H?O4KCKf8rhHWg@ACgEJT3<`NbsS556;S2_T1G=Bd1U!Go"[%Y0%1D1fk=HeWAW3oEG&*/j+%`s]<,a)/Jp]n/%YS+7Fq/s]N+!9]RK!=OK-MXU_4=s-dh5klpl:=dt]%-%1Q<W0"t?D"[0Hra0ALOF`I^Wu1;>r^f)e**S)-U7Gjlp&8cZm[o.Knk'k3Yq8@\jJE`7qJj'auiZm**"lj;cS9$SD=Rbq6dFO\&'c0'R&0#YTm5dm`(6*Fs3qBmo7Q&;al(4oehSq08GQ/?Bq4_HAEQe.rYb)Fa%Ycj4NdOq>=@4EBO]Vm\`,X+DZ)A_,q4f@rdM]A#[FAAR.i,8sL.^gb8pbZNWO_nYNip`flgBCt/DWJLQB8+NFlKQ*o^A@c=bQGsioFSUGlDU`2jc&,"c].8$#.r$,oRAb[sM!2!h-8qc\HA42*4c]gQS&Oj3*S^0]M6N)unN3nfh3$"p7&';Q]mcYGV\8eFhbi$-2%[;q405nh..!VD_IPYNFi\kM/'&I$OlJZdOd=0tZZYfYTEd<:L*U5kn^kXQ0!`$P-M(FJHefh\%59]79S@Qli$pONZ=Vm+V@(REHO,n"tM!s)RM3t=P!5Fek^U+)HJB%*:#f`8,Qeau40L7pBmRk%o'5=_UP#T'HA1=i;pi6hh2NJb3Ie`<**1qEEbJ/uR6);C.S[]\kj]mW6U7_@^`U]C%gP'"`AF\8.J'('I?a?8W&tW&kF-_38q4P"fk08P!k>*-klq<Zrlppd7GgX0_cg]'S(KH=9f]mr<3p'Z~>endstream
+endobj
+xref
+0 9
+0000000000 65535 f 
+0000000061 00000 n 
+0000000102 00000 n 
+0000000209 00000 n 
+0000000321 00000 n 
+0000000524 00000 n 
+0000000592 00000 n 
+0000000892 00000 n 
+0000000951 00000 n 
+trailer
+<<
+/ID 
+[<b4be0217ca8d4b0f85b1fcff0aec009f><b4be0217ca8d4b0f85b1fcff0aec009f>]
+% ReportLab generated PDF document -- digest (opensource)
+
+/Info 6 0 R
+/Root 5 0 R
+/Size 9
+>>
+startxref
+5748
+%%EOF

joqed-0.0.1/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "joqed"
+version = "0.0.1"
+description = "JoQED - design flow for superconducting quantum chips and their control circuits"
+authors = [{ name = "Roman Klimovich" }]
+license = { text = "Apache-2.0" }
+readme = "README.md"
+requires-python = ">=3.11"
+keywords = ["quantum", "EDA", "superconducting", "qubit", "design-flow", "circuit-QED"]
+classifiers = [
+  "Development Status :: 1 - Planning",
+  "Intended Audience :: Science/Research",
+  "License :: OSI Approved :: Apache Software License",
+  "Programming Language :: Python :: 3",
+  "Topic :: Scientific/Engineering :: Physics",
+]
+
+[project.urls]
+Homepage = "https://github.com/joqed/joqed"
+Repository = "https://github.com/joqed/joqed"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/joqed"]

joqed-0.0.1/src/joqed/__init__.py

@@ -0,0 +1,7 @@
+"""JoQED — design flow for superconducting quantum chips and their control circuits.
+
+Pre-alpha placeholder release reserving the package name. See
+https://github.com/joqed/joqed for the project roadmap.
+"""
+
+__version__ = "0.0.1"

joqed-0.0.1/tools/build_palace.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# Build Palace (https://github.com/awslabs/palace) from tools/palace-src
+# into tools/palace, using Homebrew cmake/open-mpi/gcc(gfortran)/openblas.
+set -euo pipefail
+cd "$(dirname "$0")"
+
+export PATH="/opt/homebrew/bin:$PATH"
+GFORTRAN=$(ls /opt/homebrew/bin/gfortran* 2>/dev/null | head -1)
+
+mkdir -p palace-build
+cd palace-build
+cmake ../palace-src \
+  -DCMAKE_INSTALL_PREFIX="$(pwd)/../palace" \
+  -DCMAKE_BUILD_TYPE=Release \
+  -DCMAKE_Fortran_COMPILER="$GFORTRAN" \
+  -DBLA_VENDOR=OpenBLAS \
+  -DCMAKE_PREFIX_PATH="/opt/homebrew/opt/openblas"
+make -j "$(sysctl -n hw.ncpu)"
+echo "PALACE BUILD COMPLETE"