qdk_chemistry.algorithms.phase_estimation.circuit_builder.iterative_builder module

Iterative phase estimation circuit builder.

This module implements the circuit-building component of the Kitaev-style iterative quantum phase estimation (IQPE) algorithm. It constructs the iteration circuits without executing them, enabling standalone resource estimation and circuit preview.

class qdk_chemistry.algorithms.phase_estimation.circuit_builder.iterative_builder.QdkIterativeQpeCircuitBuilder(num_bits=-1, phase_correction=0.0, num_iteration=-1, unitary_builder=None, controlled_circuit_mapper=None)[source]

Bases: IterativeQpeCircuitBuilder

Iterative Phase Estimation circuit builder.

Constructs the quantum circuits for each IQPE iteration without executing them. Can be used standalone for resource estimation or composed inside IterativePhaseEstimation.

Parameters:
__init__(num_bits=-1, phase_correction=0.0, num_iteration=-1, unitary_builder=None, controlled_circuit_mapper=None)[source]

Initialize the IterativeQpeCircuitBuilder.

Parameters:

  • num_bits (int) – The number of phase bits to estimate. Default to -1; user needs to set a valid value.

  • phase_correction (float) – The accumulated phase feedback from prior iterations. Default to 0.0.

  • num_iteration (int) – The specific iteration to build. Default to -1 (build all iterations).

  • unitary_builder (AlgorithmRef | None) – Optional algorithm reference for the unitary builder.

  • controlled_circuit_mapper (AlgorithmRef | None) – Optional algorithm reference for the controlled circuit mapper.

name()[source]

Return the name of the builder algorithm.

Return type:

str

class qdk_chemistry.algorithms.phase_estimation.circuit_builder.iterative_builder.QdkIterativeQpeCircuitBuilderSettings[source]

Bases: QpeCircuitBuilderSettings

Settings for the Iterative Phase Estimation Builder.

__init__()[source]

Initialize the settings for the Iterative Phase Estimation Builder.