Skip to main contentIBM Quantum Documentation Mirror

CircuitItemModel

pydantic model CircuitItemModel

GitHub

Bases: BaseModel

Execution specifications for a single quantum circuit.

The circuit for each item is store separately in QuantumProgramModel.

chunk_size

field

Type: Annotated[int, Field(ge

Default value: 1)] | Literal['auto'] = 'auto'

The maximum number circuit arguments to bind to the circuit per shot loop.

When "auto", the number is chosen server-side with heuristics designed to optimize execution speed. A quantum program must have items where either all chunk sizes are integer-valued, or all chunk sizes are "auto". Integer values are only allowed inside of session exection mode.

circuit_arguments

field

Type: F64TensorModel [Required]

Arguments to the parameters of the circuit.

The last axis is over circuit.parameters. Execution broadcasts over the preceding axes; expect one result per element of the leading shape.

item_type

field

Type: Literal['circuit']

Default value: 'circuit'

The type of quantum program item.

shape

field

Type: list[int] [Required]

The shape of this item.

This shape must extend (via broadcasting) the implicit shape of the :attr:~circuit_arguments`. The non-trivial axes it introduces represent replications.