bloqade-python
bloqade-python copied to clipboard
Program Structure/Hamiltonian Intuition Guide
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.