About this map
Sections
What this is
Quantum algorithms are not written from scratch. They are assembled from a small number of reusable steps, and almost every published method is a different route through the same handful of them.
This is a map of those routes. Circles are the things an algorithm can be holding. Lines are the steps that carry you from one to the next. A method is a path across.
Nothing here is generated. Every line was read out of a paper and checked against it.
How to read it
- Something you can hold — a state, a matrix, a circuit, an answer.
- The same, in the middle of a step you have opened.
- A step. Someone has published a way through it.
- A step whose way through has not been pinned to one method.
- A step nothing published fills yet.
- A step you have opened. What is drawn inside it is how it was done.
- There is a record in the repository for this one.
How to move around
- Two fingers move the map. Pinch to zoom, or hold ctrl and scroll.
- Click a step to open it in place — everything else stays where it is.
- Click a name to read the full record without leaving the map.
- Arrow keys move, plus and minus zoom, zero puts it back.
What a line is claiming
A solid line means a paper puts those two steps together and we have the citation. A long-dashed line means the route is recorded but no single method has been named for that step. A short-dashed line means nothing published fills it — the step is real, the way through is not written yet.
A count after a step's name — ×T/h, ×O(κ) — means the route walks that step that many times rather than once. It is the source's own symbol, and the card says what it stands for and what one turn costs. A step with no count is a step no source we read said is repeated, which is not the same as one taken once.
A line drawn nested under another, on the soft shaded band behind it, is a narrower version of the line above it: the same construction, re-analysed or re-tuned, filling the same step. It is why two lines can draw the identical interior and still be two entries. Lines outside the band are alternatives to their neighbours, not versions of them.
The map does not hide the gaps. An empty step is drawn as an empty step.
What is not here yet
The map covers the algorithm literature. The repository covers circuits and primitives. They overlap less than you would expect, and where a method has no record we say so on its page rather than leaving the space blank.
Where something named here does have a record, its name links straight to it.
Method
qubit-ADAPT-VQE ansatz
The same grow-it-one-operator-at-a-time construction, with the pool rebuilt out of qubit operators rather than fermionic excitations so that the circuits it produces are shallow enough for near-term hardware.
A narrower version of: ADAPT-VQE adaptive ansatz
Open the full recordFills the slot: Choose a parameterised trial state
Tang et al. name the gaps in the parent they are closing, and they are gaps in the specification rather than in the results: the original "did not provide a prescription for how to select the pool, how many operators it must contain, or whether the resulting ansatz will succeed in converging to the ground state". They also state the practical failure that motivates the qubit pool — the original pool "leads to state preparation circuits that are too deep for a practical application on near-term devices".
The Hamiltonian whose ground state is wanted, together with whatever structure is to be respected — particle number, spin, point-group symmetry, a reference determinant — and the connectivity and native gate set of the device the family has to run on.
Hamiltonian whose eigenvalues are wanted → Parameterised circuit familyadd the Pauli string with steepest gradient
The ansatz is built operator by operator from anti-Hermitian pool operators : after k steps, , and the next is the pool operator that maximizes the energy gradient , with growth halted once falls below a threshold . qubit-ADAPT draws each from single Pauli strings , , restricted to odd numbers of s assumption: the fermionic operators being decomposed are real, so only odd- are themselves real and admissible as generators; separately, being real and time-reversal symmetric means an even string's gradient vanishes identically, so nothing is lost by dropping them. The Jordan-Wigner -chains that would otherwise run the string length up to are then dropped approximation: cutting the -chains caps each Pauli string at length 4 for shallower circuits, a simplification checked only numerically -- the paper reports the two pools perform similarly, not that they are equivalent.
approximationassumption
A circuit family with a fixed structure and free real parameters, together with the number of those parameters — which is the size of the classical search problem handed to the next layer.
- Estimate an observable
Given the ability to prepare and a description of an observable , return a classical scalar within of at confidence . The state is never returned; only the number is.
Before any parameter is optimized, each growth step asks this ingredient for one commutator expectation per pool operator: for each . The calls per step therefore number the pool size, and the qubit pool is larger than the fermionic one it replaces, which "leads to proportionally more measurements at each iteration." The relief is a smaller pool, not a cheaper estimator: for qubits a complete pool needs only operators, so "the additional measurement overhead of qubit-ADAPT compared to fixed-ansatz variational algorithms scales only linearly with the number of qubits" assumption: that bound is for a minimal complete pool and against non-adaptive VQE, which screens no gradients; the reported energies used the larger fermionic-derived pool, and no per-step comparison with fermionic-ADAPT is given. Calls per run also carry the iteration count, which moves the other way: qubit-ADAPT "requires more variational parameters" than fermionic-ADAPT, each one a further pool sweep, and that trade is not quantified.
assumption
given Hamiltonian H on n qubits,
reference state |psi_HF>,
operator pool P = { individual Pauli strings P_a = i * (p_1 (x) ... (x) p_q),
p_j in {X,Y,Z}, that appear when the spin-adapted fermionic single-
and double-excitation pool is Jordan-Wigner-decomposed for this system },
P restricted to odd-Y strings, Jordan-Wigner Z-chains stripped so
length(P_a) <= 4 -- the "qubit pool": much smaller than the full
length<=4 Pauli set, since only strings already present in the
fermionic pool survive (Sec. III)
convergence threshold eps > 0
requires H real, time-reversal symmetric
# an even-Y P_a's gradient vanishes identically against such an H --
# that is why P excludes them outright, not a later screening step
# P here is this fermionic-derived qubit pool, not the separate minimal
# complete pools {V_j}_n / {G_j}_n -- those are DEFINED in Sec. III B
# and proved complete there via a rank criterion (proofs in App. B/C);
# P's own completeness against that criterion is never established
# --- grow the ansatz: one Pauli-string term, one parameter, per iteration ---
|psi> <- |psi_HF>; ansatz <- [ ]; k <- 0
loop
for each P_a in P: # observable-estimation
g_a <- <psi| [H, P_a] |psi> (Eq. 2)
||g|| <- sqrt( sum_a g_a^2 ) (Eq. 3)
if ||g|| < eps: break
# growth stops once the gradient norm drops below the threshold
a_k <- argmax_a |g_a|
# the pool operator causing the largest energy change is added next
k <- k + 1; theta_k <- 0; ansatz <- ansatz ++ [ (theta_k, P_{a_k}) ]
theta_1 .. theta_k <- classical optimizer minimizing <psi(theta)| H |psi(theta)>
# scope not spelled out by THIS paper -- inherited ADAPT-VQE protocol;
# text here only supports "more params cost more" (Sec. III A)
|psi> <- exp(theta_k P_{a_k}) ... exp(theta_1 P_{a_1}) |psi_HF> (Eq. 1)
return the parameterised circuit family
|psi^ADAPT(theta)> = exp(theta_k P_{a_k}) ... exp(theta_1 P_{a_1}) |psi_HF> (Eq. 1)
# ansatz depth stays at the k found above; theta is left at its last
# classically-optimized valueTang, Shkolnikov, Barron, Grimsley, Mayhall, Barnes and Economou count CNOTs per variational parameter (Eq. A1), a figure they call a conservative estimate: exponentiating a Pauli string of length costs CNOTs, and the qubit pool, with the Jordan-Wigner chains stripped, has maximum length 4. One iteration adds one operator and one parameter. The generalized singles-doubles fermionic pool it replaces costs per spin-adapted doubles operator after first-order Trotterization (Eq. A2), roughly for large spatial orbitals, and accurate only when all spin orbitals are evenly explored, i.e. no core orbitals - for LiH it overshoots the counted total by a third. Each step measures over the whole pool: additional measurements roughly pool size times Hamiltonian terms. Complete pools of size are proved to exist constructively, but that minimum is numerical up to 7 qubits, and only 20-40% of random pools of that size are complete at . Nothing bounds the iteration count, hence nothing bounds the total; the roughly order-of-magnitude CNOT reduction over fermionic-ADAPT is measured on H4, LiH and H6 in STO-3G, not proved.
None found yet.
None found yet.
qubit-ADAPT against fermionic-ADAPT on H4, LiH and H6
- qubit-ADAPT-VQE: An adaptive algorithm for constructing hardware-efficient ansatze on a quantum processor
Ho Lun Tang, V. O. Shkolnikov, George S. Barron, Harper R. Grimsley, Nicholas J. Mayhall, Edwin Barnes, Sophia E. Economou · 2019
About
The run the method was introduced for. Tang, Shkolnikov, Barron, Grimsley, Mayhall, Barnes and Economou set qubit-ADAPT against the fermionic-pool version of the same algorithm, and they name the thing they are measuring against in the introduction: "We term this algorithm qubit-Adaptive Derivative Assembled Problem-Tailored (qubit-ADAPT) VQE, in contrast with the implementation in Ref. [29], which we refer to as fermionic-ADAPT in this paper." Ref. 29 is Grimsley et al., the parent method. The claim under test is stated in the abstract: "Through numerical simulations on H4, LiH and H6, we show that our algorithm (“qubit-ADAPT”) reduces the circuit depth by an order of magnitude while maintaining the same accuracy as the original ADAPT-VQE." Two quantities are tracked per run, the number of variational parameters, which equals the ADAPT iteration count, and the number of CNOTs in the state preparation circuit; the outcome the paper reports is a trade between them rather than a win on both.
Methods
Sec. III A runs both algorithms on each molecule and plots the energy error against FCI twice, once as a function of the iteration count and once as a function of the CNOT count of the corresponding state preparation circuit (Fig. 1, panels (a)-(c) and (d)-(f) respectively). The CNOTs behind those curves are counted from circuits rather than estimated from the formulas of Sec. II and Appendix A: "All CNOT gate counts are obtained using the qiskit command count ops, where we consider the case of all-to-all qubit connectivity for concreteness." For fermionic-ADAPT two curves are given, before and after transpilation, and the transpiled counts come from "qiskit.transpile [47] with heavy optimization, which includes canceling back-to-back CNOTs and “commutative cancellation”". The all-to-all assumption is acknowledged as favourable and left uncorrected: "Although these counts will increase as the connectivity is reduced, we do not expect the relative performance of the two algorithms to change significantly." Two controls sit on top of the head-to-head comparison inside Sec. III A. Fig. 2 replaces the gradient selection with random operator orderings drawn from the same qubit pool, on H4 and LiH, to test whether the gradient is what does the work. Fig. 3 repeats LiH at bond distances from 1Å to 3Å, to test sensitivity to the amount of correlation in the ground state. A third control belongs to the section after it: Sec. III B opens by thinning the qubit pool, removing randomly selected operators and keeping 1/4, 1/16 and 1/32 of it, on H4 at "The orbital basis and bond distance ... chosen as in Fig. 1" (Fig. 4). Qiskit is the only software the paper names, and it names it only for the gate counts and the transpilation: no simulator, no classical optimizer and no shot count is given anywhere for the energy evaluations themselves.
Data
Three molecules at geometries chosen for strong correlation: "In each case, we choose a bond distance such that correlation effects are significant: r = 1.5Å for H4 and H6, and r = 2Å for LiH." The orbital treatment is stated once for all of them: "All the calculations are performed using an STO-3G basis and start from restricted Hartree-Fock orbitals without using a frozen-core approximation such that we have 8 spin-orbitals for H4 and 12 spin-orbitals for each of the other two molecules." The fermion-to-qubit map is Jordan-Wigner throughout - "In this paper, we employ the Jordan-Wigner (JW) mapping" - with the others deferred: "Adapting the methods we develop here to other mappings [44-46] will be the subject of future work." Beyond the bond distance, the H4 and H6 geometries are given only by the atom strings drawn above the panels of Fig. 1, and the source of the one- and two-electron integrals is not stated.
Code
None found yet.
Results
Fig. 1 reports the energy difference from the exact (FCI) result for H4 at 1.5Å, LiH at 2Å and H6 at 1.5Å, with qubit-ADAPT, fermionic-ADAPT and transpiled fermionic-ADAPT on the same axes. The outcome is a trade, and the paper states both halves of it: "It is evident from Fig. 1 that in the case of the qubit pool, more parameters are used compared to the fermionic pool. On the other hand, the number of CNOTs is reduced significantly, by about an order of magnitude in the case of H6." The abstract and the introduction state the order of magnitude for the three molecules together; in the body the only molecule the phrase is attached to by name is H6. On these runs the gradient selection is what keeps the parameter count down: on H4, "convergence to the ground state requires 46-78 parameters, compared to only 30 parameters for qubit-ADAPT", and on LiH the random orderings "require more than three times as many parameters as qubit-ADAPT to converge" - a figure the authors mark as incomplete, since "We can only provide a lower bound on the number of parameters needed to converge the random ordering results in Fig. 2(b) due to the long computational times needed in this case." They put the conclusion no more strongly than the runs allow: these findings "suggest that the role of the gradient selection in qubit-ADAPT is crucial for larger problems." Across LiH bond distances from 1Å to 3Å the curves largely overlap, and Fig. 3(c) plots "The final energies obtained by qubit-ADAPT (points marked by ×) for each bond distance considered" alongside "the exact ground state energies (solid curve)". Thinning the pool costs little at first and then costs accuracy: removing 3/4 of the operators leaves performance "similar to that with the original pool", and by Fig. 4's caption, "For the 1/4 and 1/16 pools, the algorithm can converge for almost every run. For the 1/32 pool, most of the runs can only reach an energy error of ." Every number here comes from classical simulation - the paper calls them "classical simulations of several different molecules" - and it names no simulator, no classical optimizer and no shot count for them. No hardware run is reported.
- qubit-ADAPT-VQE: An adaptive algorithm for constructing hardware-efficient ansatze on a quantum processor
Minimal complete pools on random 3-, 4- and 5-qubit Hamiltonians
- qubit-ADAPT-VQE: An adaptive algorithm for constructing hardware-efficient ansatze on a quantum processor
Ho Lun Tang, V. O. Shkolnikov, George S. Barron, Harper R. Grimsley, Nicholas J. Mayhall, Edwin Barnes, Sophia E. Economou · 2019
About
The completeness study that closes Sec. III B of the same paper, and the one that answers the specification gap the paper opens with: what makes a pool good enough, and how small it can be. Sec. III B opens on the molecular pool-thinning of Fig. 4, recorded in the entry above, and then leaves chemistry behind. It fixes the test - "For a given pool, we define the overlap matrix as where is an arbitrary real state. If the rank of satisfies , this pool is called complete." The are not the pool operators alone: they "include all the pool operators and their commutators", which is what lets a pool far smaller than the Hilbert space span it. Nothing chemical enters the completeness study - the Hamiltonians are random, and the energy axes of Fig. 6 are labelled in arbitrary units.
Methods
Two things are run in it. First a search for the smallest complete pool: "To determine the smallest complete pools, we randomly generate many different pools of increasing size and compute in each case to test for completeness. We did this for up to 7 qubits." Second, qubit-ADAPT itself is run with pools at that minimal size, to check that the rank criterion actually predicts convergence: "we run qubit-ADAPT for random real Hamiltonians of 3, 4 and 5 qubits with random initial states and for pools consisting of operators randomly chosen from the set of odd Pauli strings. We also run simulations using the minimal complete pools and ." Those two families are the constructive proof of Appendices B and C made concrete: defined recursively from , and holding "all two-qubit operators of the form that act on two neighboring qubits labeled by and " together with "all single-qubit Pauli operators except on the first qubit". Appendix C closes by naming the hardware was shaped for, and it names it as a target rather than as a machine anything here ran on: the pool "is particularly useful for quantum processors containing a linear array of qubits with nearest-neighbor coupling only", and "the entangling operators in the pool are similar to the cross-resonance interaction in fixed-frequency superconducting qubits, such as those in the IBM quantum processors" - a resemblance that "could be exploited to implement qubit-ADAPT with native hardware operations", in some future implementation and not in this one. The pools tested here are not the fermionic-derived qubit pool that produced the molecular curves of Fig. 1; they are random draws from the odd Pauli strings plus these two families. As in the molecular study, the paper names no simulator, no optimizer and no shot count.
Data
Random real symmetric Hamiltonians on 3, 4 and 5 qubits, with random initial states: "The operator coefficients in each Hamiltonian (which is taken to be real and symmetric) are obtained by sampling uniformly in the range with 10 samples for each of these 3 cases." No molecule, basis set or integral source enters, and Fig. 6's vertical axes read "energy (arbitrary units)". The completeness search that precedes it takes randomly generated pools of increasing size, tested up to 7 qubits, with Fig. 5 reporting the fraction complete for "two (blue circles), three (yellow squares), four (green diamonds), and five (red triangles) qubits".
Code
None found yet.
Results
The minimal size comes out linear, and smaller than the authors expected: "Our numerical investigations reveal that, surprisingly, the minimal pool size required for the overlap matrix to have the required rank of is only ." Fig. 5 shows the fraction of random pools that are complete as a function of pool size, and "In each case, complete pools are found for pool sizes that contain at least operators." At exactly that size most random pools still fail: "For the cases considered, we find that 20-40% of pools containing operators are complete." On the runs that were made, the criterion separates the two outcomes without exception: "All of the curves that fail to converge correspond to incomplete pools. For these cases, even though the gradient goes to zero the ground state is not reached because important operators are never generated. On the other hand, the runs with complete pools always converge, highlighting the importance of this criterion." The search is what stops the sweep, and it is why existence is proved analytically in Appendix B rather than measured further: "Randomly selecting pools of size and testing for completeness by computing is a numerically intensive process that quickly becomes infeasible as the number of qubits increases." The verdict returned on the parent's pool is that it was bigger than it had to be - the findings "suggest that the fermionic pool used in that work is overcomplete." All of it is classical simulation on random Hamiltonians: no molecule, no simulator, no classical optimizer and no shot count is named, and no hardware run is reported. The one device the paper names anywhere - the IBM quantum processors of Appendix C - is named as a target for a future implementation of , not as a machine these runs used.
- qubit-ADAPT-VQE: An adaptive algorithm for constructing hardware-efficient ansatze on a quantum processor
Qubit-ADAPT-VQE · Qiskit
From the repository — run, not written up from a paper · unsupported
About
Qubit-space Pauli generators replace fermionic excitation operators to seek shorter adaptive circuits.
Methods
None found yet.
Data
None found yet.
Code
Qiskit
Results
Literature-backed method record; algorithmic scope and evidence boundary reviewed, with no benchmark run claimed.
- Qubit-ADAPT-VQE
Qubit-space Pauli generators replace fermionic excitation operators to seek shorter adaptive circuits.
References
- qubit-ADAPT-VQE: An adaptive algorithm for constructing hardware-efficient ansatze on a quantum processor
Ho Lun Tang, V. O. Shkolnikov, George S. Barron, Harper R. Grimsley, Nicholas J. Mayhall, Edwin Barnes, Sophia E. Economou · 2019
Where the routes meet
11 problems nothing else needs — the places a reader arrives. Open a line to see what is recorded inside it, or click its name to go there.
15 lines have something recorded inside that you have not opened.
Of the routes that have been taken apart, 15 are built entirely from named slots, 15 hand off part of the work and finish the rest themselves, and 20 are one undivided act. None of the three is a defect; they are different things to reuse.
Every line on this figure, in words
The lines on this figure
Solve a nonlinear ODE dy/dt = F(y)
- Embed a nonlinear system into a linear one — opens into 6 · a way across — click it to open it here
- Solve a linear ODE du/dt = A(t)u + b(t) — opens into 9 · a way across — click it to open it here
- Choose a time discretization or propagator approximation → Quantum linear solve — open
- Choose a time discretization or propagator approximation — opens into 6 · a way across — click it to open it here
- Quantum linear solve — opens into 5 · a way across — click it to open it here
- Simulate Hamiltonian evolution → Estimate an observable — open
- Simulate Hamiltonian evolution — opens into 3 · a way across — click it to open it here
- Estimate an observable — opens into 4 · a way across — click it to open it here
Estimate an excited-state energy
- Variational quantum deflation — opens into 3 · a way across — click it to open it here
- Subspace-search variational eigensolver — open · opened: what was inside is drawn in its place
- Choose a parameterised trial state — opens into 13 · a way across — click it to open it here
- Minimise the objective over the parameters — opens into 6 · a way across — click it to open it here
- Estimate an observable ×inputs — opens into 4 · a way across — click it to open it here
- Quantum subspace expansion
- Quantum equation of motion
- Folded-spectrum variational eigensolver — opens into 3 · a way across — click it to open it here
- Penalty-constrained variational eigensolver — opens into 3 · a way across — click it to open it here
- Multistate contracted variational eigensolver — opens into 3 · a way across — click it to open it here
Every step you can open
1 of these have an object recorded in the middle; the rest open into the methods that fill them.
- Solve a nonlinear ODE dy/dt = F(y)
- Replace a spatial domain with a finite grid
- Discretize a PDE into one linear system
- Embed a nonlinear system into a linear one
- Solve a linear ODE du/dt = A(t)u + b(t)
- Recast a non-Hermitian generator as Hamiltonian evolution
- Choose a time discretization or propagator approximation
- Quantum linear solve
- Matrix function
- QSP phase factors
- Polynomial approximation
- Block-encode a matrix
- Prepare an input state
- Amplify a success branch
- Simulate Hamiltonian evolution
- Estimate an observable
- Compile a circuit to a specific device
- Satisfy the hardware connectivity constraint
- Approximate a continuous rotation in a discrete gate set
- Recover a noiseless expectation value by post-processing
- Build logical qubits at a target logical error rate
- Estimate a Hamiltonian's ground-state energy
- Choose a parameterised trial state
- Minimise the objective over the parameters
- Estimate an excited-state energy
- Measure what the machine can actually do
- Recover the period of a periodic function
- Estimate the eigenphase of a unitary
- Find the item a check accepts
- Walk a graph to the vertex you want
- Search a cost Hamiltonian for the assignment it minimises
What is on this map, counted
What is here, counted
147 nodes — 31 slots and 116 methods.
76 of the 147 link to a record in the Atlas, between them naming 89 records. The rest name papers and nothing else: this graph describes work the catalogue has not got yet, and the nodes with no record are the list of what a corpus pass has to go and read.
0 slots have no method recorded, and 32 methods have not been taken apart. Both are shown as what they are rather than left blank.
Every claim here rests on a source. This graph cites 140 papers; they and the 172 the Atlas cites alone are registered in one place, with what each reports and everywhere it is cited from. Papers