QCDL Examples

[qci-keen]

This PR adds QCDL/qiskit examples that demonstrate unique aspects of QCDL and dual-rail qubits.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.99%. Comparing base (26c1c3b) to head (9710efb).
⚠️ Report is 18 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #88   +/-   ##
=======================================
  Coverage   90.99%   90.99%           
=======================================
  Files          34       34           
  Lines        5683     5683           
=======================================
  Hits         5171     5171           
  Misses        512      512           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[JoelPasvolsky]

@qci-keen, I have made some suggestions on the Classical Arithmetic file, I will try to review additional ones this afternoon.

[JoelPasvolsky]

Added some suggestions for classical registers and measurement-based feedback. Will go on to the next three JNs now

[JoelPasvolsky]

Added suggestions on parallel Bell, RUS, and simple bell state JNs. Still need to look at the Bayesian example

[JoelPasvolsky]

Comments from running the first 6 JNs, will do Bayesian and random circuit generation next.

One general thought: what about adding a README.rst file that gives a quick description of the examples and helps a new user decide in what order to run them (i.e., also ranks them from beginner to advanced)?

[JoelPasvolsky]

As a new user, things that would be unclear to me and would appreciate having described here in markdown, are:

• c0 is updated based on measure(q0, register=c0) but c1 does not seem to be updated in the RTCF part of th ealgorithm
• Why measure(q0, register=c0) for the first qubit but just measure(q1) for the second
• Why with q1.If(c0 | c1 == 1) selects q1 for the method (could sc or q0 be used instead)?

[qci-keen]

@qci-amos could you help me with writing up an answer to this? Questions about scope and the inner workings of RTCF are not in my wheelhouse.

[qci-amos]

the example isn't intended to be meaningful, just illustrate some mechanics... we could update it to be slightly more meaningful? @qci-keen if you can think of something cute to show then we can update it, otherwise I suggest we just keep this as is (or omit it) and we can find something else later.

[JoelPasvolsky]

would this example be better if the above algorithm was in a loop that executed a few times so measurement of q1 would be in the RTCF?

[thisac]

Don't forget to add license headers to all files (they were missing in more files than the ones I commented on). This (normally) includes the __init__.py files, although they shouldn't be necessary at all here since the examples aren't part of the package structure.

[JoelPasvolsky]

Okay, @qci-keen, I think I've gone through all of it. These JNs will be very helpful for users, thank you!

[thisac]

I'd recommend removing the bayesian_decoding example from here and instead add it to the dwave-qiskit-plugin instead. It makes more sense having it where the dependencies are correct.

[qci-amos]

Ideally we wouldn't direct people to more than one place to find end-user examples for our system...

[thisac]

Thanks @qci-keen for addressing my other comments. The examples look great, Just a couple of more things I noticed.