PySparQ.pysparq.algorithms.state_preparation

Quantum state preparation based on QRAM binary-tree decomposition.

Classes

StatePrepViaQRAM	Quantum state-preparation operator based on QRAM binary-tree decomposition.
StatePreparation	High-level wrapper managing the full state-preparation pipeline.

Functions

create_state_preparation_demo(→ str)

Return a demo script string for state preparation.

Module Contents

class PySparQ.pysparq.algorithms.state_preparation.StatePrepViaQRAM(qram: object, work_qubit: str, data_size: int, rational_size: int)

Quantum state-preparation operator based on QRAM binary-tree decomposition.

clear_conditions() → StatePrepViaQRAM

conditioned_by_all_ones(cond: str | int | list[str | int]) → StatePrepViaQRAM

conditioned_by_bit(reg: str | int, bit: int) → StatePrepViaQRAM

conditioned_by_nonzeros(cond: str | int | list[str | int]) → StatePrepViaQRAM

dag(state: SparseState) → None

addr_size: int

data_size: int

qram: object

rational_size: int

work_qubit: str

class PySparQ.pysparq.algorithms.state_preparation.StatePreparation(qubit_number: int, data_size: int, data_range: int)

High-level wrapper managing the full state-preparation pipeline.

get_fidelity() → float

Compute the fidelity between the prepared state and the target state.

get_real_dist() → list[float]

Return the normalized amplitude distribution as a list of floats.

make_qram() → None

Create a QRAM circuit sized for the tree data.

make_tree() → None

Build the binary tree from the current distribution.

random_distribution() → None

Generate a random amplitude distribution.

run() → None

Run the full state-preparation pipeline.

set_qram() → None

Load the binary-tree data into the QRAM circuit.

show_distribution() → None

Print the raw values and normalized amplitudes of the distribution.

show_tree() → None

Print the binary tree level by level.

data_range: int

data_size: int

dist: list[int]

qram: object | None

qubit_number: int

rational_size: int

tree: list[int]

PySparQ.pysparq.algorithms.state_preparation.create_state_preparation_demo() → str

Return a demo script string for state preparation.