Skip to main contentIBM Quantum Documentation
You are viewing the API reference for an old version of Qiskit SDK. Switch to latest version


Operator Evolutions


Deprecated since version 0.24.0

The qiskit.opflow module is deprecated and will be removed no earlier than 3 months after the release date. For code migration guidelines, visit in a new tab).

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.


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.

EvolutionBase()Deprecated: A base for Evolution converters.


EvolutionFactory()Deprecated: A factory class for convenient automatic selection of an Evolution algorithm based on the Operator to be converted.
EvolvedOp(*args, **kwargs)Deprecated: Class for wrapping Operator Evolutions for compilation (convert) by an EvolutionBase method later, essentially acting as a placeholder.
MatrixEvolution()Deprecated: Performs Evolution by classical matrix exponentiation, constructing a circuit with UnitaryGates or HamiltonianGates containing the exponentiation of the Operator.
PauliTrotterEvolution([trotter_mode, reps])Deprecated: An Evolution algorithm replacing exponentiated sums of Paulis by changing them each to the Z basis, rotating with an rZ, changing back, and Trotterizing.


TrotterizationBase([reps])Deprecated: A base for Trotterization methods, algorithms for approximating exponentiations of operator sums by compositions of exponentiations.
TrotterizationFactory()Deprecated: A factory for conveniently creating TrotterizationBase instances.
Trotter([reps])Deprecated: Simple Trotter expansion, composing the evolution circuits of each Operator in the sum together reps times and dividing the evolution time of each by reps.
Suzuki([reps, order])Deprecated: Suzuki 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.
QDrift([reps])Deprecated: The 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.