---
title: TimeEvolutionProblem (v0.46)
description: API reference for qiskit.algorithms.TimeEvolutionProblem in qiskit v0.46
source: https://eu-de.quantum.cloud.ibm.com/docs/en/api/qiskit/0.46/qiskit.algorithms.TimeEvolutionProblem
---

# TimeEvolutionProblem

*class* `qiskit.algorithms.TimeEvolutionProblem(hamiltonian, time, initial_state=None, aux_operators=None, truncation_threshold=1e-12, t_param=None, param_value_map=None)`

[GitHub](https://github.com/qiskit/qiskit/tree/stable/0.46/qiskit/algorithms/time_evolvers/time_evolution_problem.py)

Bases: [`object`](https://docs.python.org/3/library/functions.html#object)

Time evolution problem class.

This class is the input to time evolution algorithms and must contain information on the total evolution time, a quantum state to be evolved and under which Hamiltonian the state is evolved.

### hamiltonian

The Hamiltonian under which to evolve the system.

**Type**

BaseOperator | [PauliSumOp](/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")

### initial\_state

The quantum state to be evolved for methods like Trotterization. For variational time evolutions, where the evolution happens in an ansatz, this argument is not required.

**Type**

[QuantumCircuit](/docs/api/qiskit/0.46/qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit") | [Statevector](/docs/api/qiskit/0.46/qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") | None

### aux\_operators

Optional list of auxiliary operators to be evaluated with the evolved `initial_state` and their expectation values returned.

**Type**

ListOrDict\[BaseOperator | [PauliSumOp](/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")] | None

### truncation\_threshold

Defines a threshold under which values can be assumed to be 0. Used when `aux_operators` is provided.

**Type**

[float](https://docs.python.org/3/library/functions.html#float)

### t\_param

Time parameter in case of a time-dependent Hamiltonian. This free parameter must be within the `hamiltonian`.

**Type**

[Parameter](/docs/api/qiskit/0.46/qiskit.circuit.Parameter "qiskit.circuit.Parameter") | None

### param\_value\_map

Maps free parameters in the problem to values. Depending on the algorithm, it might refer to e.g. a Hamiltonian or an initial state.

**Type**

[dict](https://docs.python.org/3/library/stdtypes.html#dict)\[[Parameter](/docs/api/qiskit/0.46/qiskit.circuit.Parameter "qiskit.circuit.Parameter"), [complex](https://docs.python.org/3/library/functions.html#complex)] | None

**Parameters**

- **hamiltonian** (*BaseOperator |* [*PauliSumOp*](/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")) – The Hamiltonian under which to evolve the system.
- **time** ([*float*](https://docs.python.org/3/library/functions.html#float)) – Total time of evolution.
- **initial\_state** ([*QuantumCircuit*](/docs/api/qiskit/0.46/qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")  *|*[*Statevector*](/docs/api/qiskit/0.46/qiskit.quantum_info.Statevector "qiskit.quantum_info.Statevector") *| None*) – The quantum state to be evolved for methods like Trotterization. For variational time evolutions, where the evolution happens in an ansatz, this argument is not required.
- **aux\_operators** (*ListOrDict\[BaseOperator |* [*PauliSumOp*](/docs/api/qiskit/0.46/qiskit.opflow.primitive_ops.PauliSumOp "qiskit.opflow.primitive_ops.PauliSumOp")*] | None*) – Optional list of auxiliary operators to be evaluated with the evolved `initial_state` and their expectation values returned.
- **truncation\_threshold** ([*float*](https://docs.python.org/3/library/functions.html#float)) – Defines a threshold under which values can be assumed to be 0. Used when `aux_operators` is provided.
- **t\_param** ([*Parameter*](/docs/api/qiskit/0.46/qiskit.circuit.Parameter "qiskit.circuit.Parameter") *| None*) – Time parameter in case of a time-dependent Hamiltonian. This free parameter must be within the `hamiltonian`.
- **param\_value\_map** (*Mapping\[*[*Parameter*](/docs/api/qiskit/0.46/qiskit.circuit.Parameter "qiskit.circuit.Parameter")*,* [*complex*](https://docs.python.org/3/library/functions.html#complex)*] | None*) – Maps free parameters in the problem to values. Depending on the algorithm, it might refer to e.g. a Hamiltonian or an initial state.

**Raises**

[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError) – If non-positive time of evolution is provided.

## Attributes

### time

Returns time.

## Methods

### validate\_params

`validate_params()`

Checks if all parameters present in the Hamiltonian are also present in the dictionary that maps them to values.

**Raises**

[**ValueError**](https://docs.python.org/3/library/exceptions.html#ValueError) – If Hamiltonian parameters cannot be bound with data provided.