qiskit-community/qiskit-metal: v0.6.3 - Tutorial and Bug Fixes

What's new in v0.6.3

Tutorial series — fully restructured 1.x Overview

The introductory tutorials have been reorganised so each notebook has a single, clear purpose. No content was lost — everything was moved, not deleted.

| Notebook | What changed | |----------|-------------| | 1.1 Bird's eye view | Teaser code cell at the top — run 3 lines, see a qubit, then learn the concepts | | 1.2 Quick start | Now uses FakeJunction_01 throughout; adds zoom panels for vertical and horizontal junctions | | 1.3 Saving your design | Slimmed down; design setup shown as a single to_python_script() block | | 1.4 Headless workflow | Batch PNG export section added | | 1.5 Parametric design (new) | Sweep pad_width and CPW length with 3-panel comparison figures | | 1.6 Shape library (new) | Gallery of all 14 sample_shapes components on a single canvas | | 3.2 Export to GDS | GDS export cells and cheesing appendix moved here from 1.2 |

Every tutorial now carries a 💡 Using this tutorial without the Qt GUI callout with a working link to 1.4.

GDS renderer improvements

• debug_summarize_gds_library now produces a colour-coded SVG overview and an HTML legend table with matching swatches — layers are colour-consistent with plot_gds_zoom
• Junction rotation fix — _get_linestring_characteristics was returning degrees instead of radians for gdstk.Reference.rotation; corrected
• write_library_overview_svg passes colours via shape_style= (gdstk 0.9.x API)

Headless viewer fix

qm.view(design) no longer destroys the figure when running with the ipympl widget or any interactive backend. plt.close() is now only called for Agg / inline backends, where it prevents double-rendering in Jupyter's post-execute hook.

Ansys renderer — graceful failure on macOS / Linux

Connecting to HFSS on a non-Windows machine previously raised a cryptic NameError: name 'Dispatch' is not defined. It now raises a clear RuntimeError explaining the Windows + Ansys AEDT + pywin32 requirement and pointing to the ElmerFEM (tutorial 4.19) and GDS (tutorial 3.2) alternatives.

Docs

• Sphinx build warnings reduced from 58 → 16 (all remaining are pre-existing in hard-touch zones)
• All broken cross-notebook links fixed across docs/tut/ (space-encoded %20 paths → hyphenated filenames)
• Gallery thumbnails: 1.1 and 1.2 now show distinct images

Tests

14 new tests across two files:

• tests/test_gds_export.py — TestJunctionRotationRadians (4), TestPlotGDSZoom (5), TestDebugSummarizeGDSLibrary (3), TestGDSShapeStyle (2)
• tests/test_viewer.py — TestViewBackendConditionalClose (2)

Test count: 495 passing, 0 failing.

Dependency update

• gmsh 4.15.0 → 4.15.2

Full changelog: v0.6.2...v0.6.3