iqm.iqm_client.models.RunResult

class iqm.iqm_client.models.RunResult(*, status: Status, measurements: list[dict[str, list[list[int]]]] | None = None, message: str | None = None, metadata: Metadata, warnings: list[str] | None = None)

Bases: BaseModel

Results of the quantum circuit execution job. If the job succeeded, measurements contains the output of the batch of circuits, consisting of the results of the measurement operations in each circuit. It is a list of dictionaries, where each dict maps each measurement key to a 2D array of measurement results, represented as a nested list. RunResult.measurements[circuit_index][key][shot][qubit_index] is the result of measuring the qubit_index’th qubit in measurement operation key in the shot shot in the circuit_index’th circuit of the batch. measurements is present iff the status is 'ready'. message carries additional information for the 'failed' status. If the status is 'pending compilation' or 'pending execution', measurements and message are None.

The results are non-negative integers representing the computational basis state (for qubits, 0 or 1) that was the measurement outcome.

---

Attributes

model_config	Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
status	current status of the job, in {'pending_compilation', 'pending_execution', 'ready', 'failed', 'aborted'}
measurements	if the job has finished successfully, the measurement results for the circuit(s)
message	if the job failed, an error message
metadata	metadata about the job
warnings	list of warning messages

Methods

from_dict(inp)

Parses the result from a dict.

Parameters:

• status (Status)

• measurements (list[dict[str, list[list[int]]]] | None)

• message (str | None)

• metadata (Metadata)

• warnings (list[str] | None)

model_config: ClassVar[ConfigDict] = {}

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

status: Status

current status of the job, in {'pending_compilation', 'pending_execution', 'ready', 'failed', 'aborted'}

measurements: CircuitMeasurementResultsBatch | None

if the job has finished successfully, the measurement results for the circuit(s)

message: str | None

if the job failed, an error message

metadata: Metadata

metadata about the job

warnings: list[str] | None

list of warning messages

static from_dict(inp: dict[str, str | dict | list | None]) → RunResult

Parses the result from a dict.

Parameters:

inp (dict[str, str | dict | list | None]) – value to parse, has to map to RunResult

Returns:

parsed job result

Return type:

RunResult