Piecemaker #288

Luisenden · 2025-10-09T09:22:03Z

This PR adds a quantum switch example: a central node serves n-GHZ states to n users using the Piecemaker protocol. The interactive version live_visualization_network_interactive.jl uses WGLMakie and can be integrated as interactive visualization in the docs. In this example, the user can select parameter settings for link_success_probability and memory_depolarization_probability. A live plot shows fidelity vs simulation time Δt, where points accumulate across runs so one can compare settings. A second panel shows the network evolving during protocol execution: edges appear when links are established; fusions and measurements then trigger the visual updates.

The example also includes a script that produces a static plot of the performance static_vic.jl as well as just a separate simple run file simple_run.jl which only collects performance data in a table without plotting. Both of these files import setup.jl.

[x ] The code is properly formatted and commented.
Substantial new functionality is documented within the docs.
All new functionality is tested.
All of the automated tests on github pass.
We recently started enforcing formatting checks. If formatting issues are reported in the new code you have written, please correct them. There will be plenty of old code that is flagged as we are slowly transitioning to enforced formatting. Please do not worry about or address older formatting issues -- keep your PR just focused on your planned contribution.

…delity computation (new observable is projector of nclient-GHZ state)

… consume simulation time

… distribution time and ghz-state fidelity as dataframe

…first round of entanglement

… in piecemaker env; updated gitignore

…nglerProt (and therefore deleted SelectedEntanglerProt); added Depolarization test to the kraus_lindblad test set

…eded anymore for event driven simulation; added small testfile to see workings of initiate();

…ded docstring and jldoctest to fusioncircuit

…multiple lindblad operators); added kraus-vs-lindblad evolution test to

Krastanov · 2025-10-10T14:18:50Z

examples/piecemakerswitch/README.md

+The fusion operation is performed on the switch node. Let's take a client who just managed to generate a bipartide entangled state -- entangled link -- with its associated qubit at the switch side. The switch executes a `CNOT` gate on the client's qubit (target) and the piecemaker qubit (control). Next, the switch measures the client qubit in the computational basis and sends the outcome to the client (in order to apply the necessary Pauli correction). This procedure merges the bipartide state into the (entangled) state that the piecemaker qubit is currently part of, modulo any required Pauli corrections.
+
+# Noise 
+The memories residing in the nodes' `Register`s suffer from depolarizing noise, see [`Depolarization`](https://github.com/QuantumSavory/QuantumSavory.jl/blob/2d40bb77b2abdebdd92a0d32830d97a9234d2fa0/src/backgrounds.jl#L18). 


Can this be a link to the docs, not to the code?

Krastanov · 2025-10-10T14:19:05Z

examples/piecemakerswitch/README.md

@@ -0,0 +1,52 @@
+# System Overview


add a link to your arxiv

Krastanov · 2025-10-10T14:21:23Z

examples/piecemakerswitch/README.md

+            SwitchNode->>SwitchNode: Keep checking
+        end
+    end
+```


check the readme of https://github.com/QuantumSavory/QuantumSavory.jl/tree/master/examples/simpleswitch and https://github.com/QuantumSavory/QuantumSavory.jl/tree/master/examples/state_explorer to add similar structural components like a spelled out link to docs and a link to live example (just make up one in the same style, e.g. areweentagledyet...../PICK_A_NAME) -- I will make sure it runs by the time we merge this

Krastanov · 2025-10-10T14:21:47Z

examples/piecemakerswitch/live_visualization_interactive.jl

+    - The current n-qubit state (the clients’ memory qubits) is compared to the ideal GHZₙ target state. The resulting fidelity is plotted as a point on the left over the number of taken time steps Δt.
+
+    Noise model:
+    - Memory qubits are subject to depolarizing noise ([`Depolarization`](https://github.com/QuantumSavory/QuantumSavory.jl/blob/2d40bb77b2abdebdd92a0d32830d97a9234d2fa0/src/backgrounds.jl#L18) background). The slider “mem depolar prob” controls the memory depolarization probability.


link to docs

Krastanov · 2025-10-10T14:21:56Z

examples/piecemakerswitch/live_visualization_interactive.jl

+    end
+
+    content = md"""
+    Pick simulation settings and hit “Run once”. The left panel plots the running fidelity to the target GHZ state; the right panel shows the network state as it evolves.


link to your paper

Krastanov · 2025-10-10T14:22:55Z

examples/piecemakerswitch/simple_run.jl

@@ -0,0 +1,59 @@
+include("setup.jl")


add this whole file to the example tests (see how they are structured)

Krastanov · 2025-10-10T14:23:38Z

examples/piecemakerswitch/static_viz.jl

@@ -0,0 +1,33 @@
+include("setup.jl")


add this to the example tests with plots (and check if the other examples use CairoMakie and switch to it if necessary)

other examples use GLMakie and WGLMakie as well (e.g., congestionchain, simpleswitch, repeatergrid)

Krastanov · 2025-10-10T14:24:30Z

examples/piecemakerswitch/Project.toml

@@ -0,0 +1,17 @@
+[deps]


the tests run with a different project.toml file -- in case some tests fail with a missing dependency, probably you just need to add the dependency to the test project.toml

when I run julia --project=. runtests.jl in test I get the following error

"ERROR: LoadError: UndefVarError: onchange not defined in Main.var"##234""

that might be because of a weird setup for your project environment; we can debug it with ] status

Krastanov · 2025-10-10T14:29:36Z

examples/piecemakerswitch/setup.jl

+    link_success_prob::Float64, seed::Int, logging::DataFrame, rounds::Int)
+
+    # Set a random seed
+    Random.seed!(seed)


let's keep things random!

Krastanov · 2025-10-11T00:45:49Z

I forgot to share the comment from today's meeting. Here it is:

-                run(sim)
+                # TODO suggestions from stefan that makes it possible to remove
 code duplication
+                t = 0
+                while true
+                   t += some_step # a fraction of the simulation time unit
+                   run(sim, t)
+                   notify(plot_observables)
+                   sleep(some_pause)
+                   if ...
+                      break
+                   end
+                end
+                # end of TODO

…ple run

Krastanov · 2025-10-31T15:10:03Z

examples/piecemakerswitch/static_viz.jl

+)
+
+timed = @elapsed run(sim)
+println("Simulation finished in $(timed) seconds")


make it into a log statement so that it does not pollute the logs in the test runner

Krastanov · 2025-10-31T15:10:34Z

examples/piecemakerswitch/static_viz.jl

+
+fig = plot_fidelity(logging)
+display(fig)
+wait() # keeps REPL open until the figure is closed


does this block the tests?

Krastanov · 2025-10-31T15:10:58Z

examples/piecemakerswitch/simple_run.jl

+
+    @info "Simulation with $(nclients) clients finished in $(elapsed_time) seconds"
+end
+println(results_per_client)


log, not print

Luisenden added 30 commits September 17, 2024 14:54

added new interactive example (no visualization yet) termed 'piecemaker'

d8b724e

added depolarization channel for stabilizer state repr and updated fi…

337fc92

…delity computation (new observable is projector of nclient-GHZ state)

execute ghz generation only once, only entanglement generation should…

39ae298

… consume simulation time

simple run finished, runs fusion protocol multiple times and collects…

54d9ad2

… distribution time and ghz-state fidelity as dataframe

updated README

307fd09

adjustements in simulation setup and run script, noise applied after …

f7a3f47

…first round of entanglement

deleted init function, moved param value setting to run script

8a14160

changed GHZConsumer to FusionConsumer

0957cf6

deleted tag Piecemaker

0aaeae1

reset project env in parent directory and added specific dependencies…

be08d75

… in piecemaker env; updated gitignore

deleted .DS_Store; updated local env

81f12d1

updated readme

cef2e06

Uptdated to event-driven implementation; added slot variables to Enta…

467a314

…nglerProt (and therefore deleted SelectedEntanglerProt); added Depolarization test to the kraus_lindblad test set

cleaned up code; deleted FusionSwitchDiscreteProtocol as it is not ne…

77631f2

…eded anymore for event driven simulation; added small testfile to see workings of initiate();

deleted functions not in use (entangler functions and fusion function)

e7d4349

deleted .vscode

5ab85ce

added explanation to tag FusionCounterpart

46681bb

changed order of parameters in fusioncircuit to (control, target); ad…

badefaa

…ded docstring and jldoctest to fusioncircuit

extended function apply_noninstant! to work with depolarizing noise (…

3a40643

…multiple lindblad operators); added kraus-vs-lindblad evolution test to

updated readme

9a12dd6

updated readme

751c5b1

Merge branch 'master' into piecemaker

e9761d6

reverted to whats on master

83276fe

fixed open loop

c032be4

updated ProtocolZoo to align with original source

b81b390

updated switches.jl to align with original source

87a5816

updated CircuitZoo to align with original source

47e6134

fix small typo

1847ccc

Merge branch 'master' into piecemaker

c703404

simple piecemaker updated

38d0784

Luisenden added 5 commits August 12, 2025 17:19

added small vizualisation

315a4ab

typo in file name

720fd3e

deleted depr tests

1b4b477

Merge branch 'master' into piecemaker

ff44bee

updated simple runs and added interactive html with wgl makie

97caf9e

Luisenden assigned Krastanov Oct 9, 2025

Krastanov reviewed Oct 10, 2025

View reviewed changes

Luisenden added 5 commits October 20, 2025 16:09

updated readme, renamed web-app version

ca48d0d

consolidated web-app with setup; small updates to static plot and sim…

6ae9e1a

…ple run

added examples to test_examples

31b6b2a

added docstrings to setup file

5c23612

small final updates

669528c

Krastanov reviewed Oct 31, 2025

View reviewed changes

Piecemaker #288

Are you sure you want to change the base?

Piecemaker #288

Uh oh!

Conversation

Luisenden commented Oct 9, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Luisenden Oct 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Krastanov commented Oct 11, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Luisenden Oct 21, 2025 •

edited

Loading