Skip to main contentIBM Quantum Documentation
This page is from an old version of Qiskit SDK and does not exist in the latest version. We recommend you migrate to the latest version. See the release notes for more information.

Operator Evolutions

qiskit.aqua.operators.evolutions

Evolutions are converters which traverse an Operator tree, replacing any EvolvedOp e with a Schrodinger equation-style evolution CircuitOp equalling or approximating the matrix exponential of -i * the Operator contained inside (e.primitive). The Evolutions are essentially implementations of Hamiltonian Simulation algorithms, including various methods for Trotterization.

The EvolvedOp is simply a placeholder signifying that the Operator inside it should be converted to its exponential by the Evolution converter. All Operators (not state_fns) have .exp_i() methods which either return the exponential of the Operator directly, or an EvolvedOp containing the Operator.

Note

Evolutions work with parameterized Operator coefficients, so my_expectation.convert((t * H).exp_i()), where t is a scalar or Terra Parameter and H is an Operator, will produce a CircuitOp equivalent to e^iHt.

Evolution Base Class

The EvolutionBase class gives an interface for algorithms to ask for Evolutions as execution settings. For example, if an algorithm contains an Operator evolution step within it, such as QAOA, the algorithm can give the opportunity for the user to pass an EvolutionBase of their choice to be used in that evolution step.

EvolutionBaseA base for Evolution converters.

Evolutions

EvolutionFactoryA factory class for convenient automatic selection of an Evolution algorithm based on the Operator to be converted.
EvolvedOpClass for wrapping Operator Evolutions for compilation (convert) by an EvolutionBase method later, essentially acting as a placeholder.
MatrixEvolutionPerforms Evolution by classical matrix exponentiation, constructing a circuit with UnitaryGates or HamiltonianGates containing the exponentiation of the Operator.
PauliTrotterEvolutionAn Evolution algorithm replacing exponentiated sums of Paulis by changing them each to the Z basis, rotating with an rZ, changing back, and trotterizing.

Trotterizations

TrotterizationBaseA base for Trotterization methods, algorithms for approximating exponentiations of operator sums by compositions of exponentiations.
TrotterizationFactoryA factory for conveniently creating TrotterizationBase instances.
TrotterSimple Trotter expansion, composing the evolution circuits of each Operator in the sum together reps times and dividing the evolution time of each by reps.
SuzukiSuzuki Trotter expansion, composing the evolution circuits of each Operator in the sum together by a recursive “bookends” strategy, repeating the whole composed circuit reps times.
QDriftThe QDrift Trotterization method, which selects each each term in the Trotterization randomly, with a probability proportional to its weight.
Was this page helpful?
Report a bug or request content on GitHub.