[unitaryDESIGN] Visual Design of a Bosonic Qubit in Wigner Function Space

[aarontrowbridge]

Description

Create a visual design of a bosonic qubit represented in Wigner function space. Bosonic qubits encode quantum information in the continuous-variable states of a harmonic oscillator (e.g., a superconducting cavity). The Wigner function provides a quasi-probability distribution in phase space that beautifully visualizes these quantum states.

Bounty: $125

Why it matters

Wigner function visualizations are the gold standard for understanding bosonic quantum states (cat states, GKP states, Fock states). Having a polished visual would help communicate Piccolo.jl's bosonic quantum control capabilities and may be featured on the Harmoniqs website.

Relevant code & references

• CatSystem — Piccolo's cat qubit system template, including coherent state construction via coherent_ket(α, levels)
• PiccoloMakieExt.jl — Existing Makie-based visualization extension
• Visualization guide — Current plotting documentation
• Wigner function (Wikipedia) — Mathematical background
• QuantumToolbox.jl — Potential reference implementation for Wigner function computation

Scope

In scope:

• Create a Wigner function visualization (2D heatmap or 3D surface) of bosonic states using Makie.jl
• Demonstrate with cat states (superpositions of coherent states) using the existing CatSystem and coherent_ket helpers
• Produce publication-quality figures suitable for a website

Out of scope:

• Integrating the visualization into Piccolo.jl's core API (though a PR adding it would be welcome)
• Animating the Wigner function over time (see the pulse animation issue)

Potential outcomes

• Static Wigner function plots for various bosonic code states (cat, GKP, Fock)
• Blog-ready visuals or interactive figures

[lmee]

I read through the full thread for "[unitaryDESIGN] Visual Design of a Bosonic Qubit in Wigner Function Space" including all comments. The core problem appears to be: Create a visual design of a bosonic qubit represented in Wigner function space . Bosonic qubits encode quantum information in the continuous-variable states of a harmonic oscillator (e.g., a superconducting cavity). The Wigner function provides a quasi-probability distribution in phase space that beautifully visualizes these quantum states. My root-cause hypothesis is a state flow mismatch between action handling and final UI state. My plan is to I will reproduce the issue against acceptance criteria, isolate the root cause in the relevant module, and submit a focused fix with regression tests. I can start now and keep updates focused on evidence and validation. Best, Jerry Li

[ahkatlio]

Hello I have submitted a pr, please check