PostJobsRequest

class PostJobsRequest(*, circuits, calibration_set_id=None, qubit_mapping=None, shots=1, max_circuit_duration_over_t2=None, heralding_mode=HeraldingMode.NONE, move_gate_validation=MoveGateValidationMode.STRICT, move_gate_frame_tracking=MoveGateFrameTrackingMode.FULL, active_reset_cycles=None, dd_mode=DDMode.DISABLED, dd_strategy=None)

Bases: PydanticBase

Request to Station Control run a job that executes a batch of quantum circuits.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

Module: iqm.station_control.interface.models.circuit

Attributes

model_config	Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
move_gate_frame_tracking_mode
move_validation_mode
circuits	Batch of quantum circuit(s) to execute.
calibration_set_id	ID of the calibration set to use, or None to use the current default calibration set.
qubit_mapping	Mapping from logical qubit names to physical qubit names, or None if circuits use physical qubit names.
shots	How many times to execute each circuit in the batch, must be greater than zero.
max_circuit_duration_over_t2	Circuits are disqualified on the server if they are longer than this fraction of the T2 time of the worst qubit used.
heralding_mode	Which heralding mode to use during the execution of circuits in this request.
move_gate_validation	Which method of MOVE gate validation to use in circuit compilation.
move_gate_frame_tracking	Which method of MOVE gate frame tracking to use for circuit compilation.
active_reset_cycles	Number of active reset operations inserted at the beginning of each circuit for each active qubit.
dd_mode	Whether dynamical decoupling is enabled or disabled during the execution.
dd_strategy	Dynamical decoupling strategy to be used during the execution, if DD is enabled.

Methods

Parameters:

• circuits (list[Circuit | _Circuit | str])

• calibration_set_id (UUID | None)

• qubit_mapping (dict[str, str] | None)

• shots (int)

• max_circuit_duration_over_t2 (float | None)

• heralding_mode (HeraldingMode)

• move_gate_validation (MoveGateValidationMode)

• move_gate_frame_tracking (MoveGateFrameTrackingMode)

• active_reset_cycles (int | None)

• dd_mode (DDMode)

• dd_strategy (DDStrategy | None)

model_config: ClassVar[ConfigDict] = {'extra': 'ignore', 'ser_json_inf_nan': 'constants', 'validate_assignment': True, 'validate_default': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

circuits: CircuitBatch

Batch of quantum circuit(s) to execute.

calibration_set_id: UUID | None

ID of the calibration set to use, or None to use the current default calibration set.

qubit_mapping: QubitMapping | None

Mapping from logical qubit names to physical qubit names, or None if circuits use physical qubit names.

shots: int

How many times to execute each circuit in the batch, must be greater than zero.

max_circuit_duration_over_t2: float | None

Circuits are disqualified on the server if they are longer than this fraction of the T2 time of the worst qubit used. If set to 0.0, no circuits are disqualified. If set to None the server default value is used.

heralding_mode: HeraldingMode

Which heralding mode to use during the execution of circuits in this request.

move_gate_validation: MoveGateValidationMode

Which method of MOVE gate validation to use in circuit compilation.

move_gate_frame_tracking: MoveGateFrameTrackingMode

Which method of MOVE gate frame tracking to use for circuit compilation.

active_reset_cycles: int | None

Number of active reset operations inserted at the beginning of each circuit for each active qubit. None means active reset is not used but instead reset is done by waiting (relaxation). Integer values smaller than 1 result in neither active nor reset by wait being used, in which case any reset operations must be explicitly added in the circuit.

dd_mode: DDMode

Whether dynamical decoupling is enabled or disabled during the execution.

dd_strategy: DDStrategy | None

Dynamical decoupling strategy to be used during the execution, if DD is enabled. If None, use the server default strategy.