search

Qiskit / qiskit

Qiskit is an open-source SDK for working with quantum computers at the level of extended quantum circuits, operators, and primitives.
https://www.ibm.com/quantum/qiskit
Apache License 2.0
5.24k stars 2.36k forks source link

Advanced Circuits tutorial lacks explanations. #10672

Open 3yakuya opened 4 years ago

3yakuya commented 4 years ago

While other tutorials in Qiskit tend to lead the user through some story, explaining concepts and showing them in practice, Advanced Circuits starts with Opaque Gates without introducing any text about why they could be useful and in what context.

I tried to have a go at it myself, but the Gate documentation on its own does not help very much.

Similarly, "Composite Gates", while a bit more self-explanatory, lack some text that would make reading the tutorial more natural. I am afraid that in the current shape the tutorial looks unfinished and somehow not ready for release.

Ideal improvement would be to add some text surrounding the code, explaining why and when it could be useful.

3yakuya commented 4 years ago

Suggested by AG on Slack, Gate appears to be a parent class for UnitaryGate, which looks very similar, but provides a constructor to create the gate from data.

I suppose my question is: what is the actual intended use of the black-box gate and how could the tutorial be updated to reflect that?

abbycross commented 2 months ago

This tutorial is now part of an archived repo - will the content be repurposed and is this issue still relevant?