QuantumProgramItem

class samplomatic.quantum_program.QuantumProgramItem(circuit: QuantumCircuit, chunk_size: int | None = None)

Bases: ABC

An item of a QuantumProgram.

Each item has a shape that determines the number of circuit executions. This shape is computed by broadcasting the extrinsic shapes of all input arrays. Input arrays have both extrinsic axes (leftmost, defining the sweep grid) and intrinsic axes (rightmost, determined by the data type). For example, circuit_arguments for a circuit with n parameters has intrinsic shape (n,), so an array of shape (5, 3, n) has extrinsic shape (5, 3).

Output arrays should follow the same convention: extrinsic axes match the item’s shape, and intrinsic axes are determined by the output type (e.g., (num_shots, creg_size) for classical register data).

Parameters:

• circuit – The circuit to be executed.

• chunk_size – The maximum number of bound circuits in each shot loop execution, or None to use a server-side heuristic to optimize speed. When not executing in a session, the server-side heuristic is always used and this value is ignored.

Attributes Summary

shape

The extrinsic shape of this item, i.e. the broadcasted extrinsic shapes of all inputs.

Methods Summary

size()

Return the total number elements in this item.

Attributes Documentation

shape

The extrinsic shape of this item, i.e. the broadcasted extrinsic shapes of all inputs.

Methods Documentation

size() → int

Return the total number elements in this item.

The size is calculated as the product of the entries of shape.