bloqade-python icon indicating copy to clipboard operation
bloqade-python copied to clipboard

Program Structure/Hamiltonian Intuition Guide

Open johnzl-777 opened this issue 2 years ago • 0 comments

Describe the issue

While we have a nice set of tutorials and a diagram that shows the builder syntax I think it would really help beginners if there was some kind of documentation that justified its structure. As in, "Ah, a program represented via a chain like Rydberg -> Rabi -> Uniform" makes sense because it... (mirrors hardware capabilities/potential operations with neutral atoms, makes sense in the context of the many-body Rydberg Hamiltonian, etc.).

Link to the page and section containing the issue, if applicable

Suggested content or correction, if applicable

  • We could piggy back off of some of the details from the Aquila Whitepaper
  • If you wanted to go the full nine yards this guide could be accompanied by an initial set of tutorials (Tutorial "Zero") I always thought were a good idea to develop for folks who don't even know what a rabi cycle is. You'd show a single qubit, then start adding operations (apply rabi? Rabi + phase? Rabi + detuning? maybe the simplest possible derivation of them possible), and then throw in a two body example.And along the way you could show each increase in complexity/control with a subgraph of what we have under the builder workflow page.
    • The ultimate goal is for an expert they could easily glean the justification of the builder structure but for novices you've coupled the builder structure gently enough with a pedagogical guide of the physics that they won't do what I've witnessed users do which is initially fight the syntax instead of letting it work for them.

johnzl-777 avatar Sep 23 '23 04:09 johnzl-777