qdk_chemistry.algorithms.phase_estimation.circuit_builder.standard_builder module

Standard (QFT-based) phase estimation circuit builder.

This module implements the circuit-building component of the standard quantum phase estimation (QPE) algorithm. It constructs a single circuit that uses multiple ancilla qubits and the inverse QFT, enabling standalone resource estimation and circuit preview.

class qdk_chemistry.algorithms.phase_estimation.circuit_builder.standard_builder.QdkStandardQpeCircuitBuilder(num_bits=-1, unitary_builder=None, controlled_circuit_mapper=None)

Bases: StandardQpeCircuitBuilder

Standard (QFT-based) Phase Estimation circuit builder.

Constructs a single quantum circuit that performs standard QPE using multiple ancilla qubits and the inverse QFT. Can be used standalone for resource estimation or composed inside StandardPhaseEstimation.

Parameters:

• num_bits (int)

• unitary_builder (AlgorithmRef | None)

• controlled_circuit_mapper (AlgorithmRef | None)

__init__(num_bits=-1, unitary_builder=None, controlled_circuit_mapper=None)

Initialize the StandardQpeCircuitBuilder.

Parameters:

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

• 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()

Return the name of the builder algorithm.

Return type:

str

class qdk_chemistry.algorithms.phase_estimation.circuit_builder.standard_builder.QdkStandardQpeCircuitBuilderSettings

Bases: QpeCircuitBuilderSettings

Settings for the Standard Phase Estimation Circuit Builder.

__init__()

Initialize the settings for the Standard Phase Estimation Circuit Builder.