microquantum.analytics.result

Standard result contract for microquantum executions and solvers.

Result is the public, serializable schema that represents the outcome of a generic quantum execution or solver run: the computed solution, confidence, fidelity, timing, optional reference baseline, and an execution trace. It is intentionally domain-agnostic — applications may attach their own meaning to the fields without the SDK assuming one.

Module Contents

class microquantum.analytics.result.Result(problem, solution=None, confidence=1.0, fidelity=None, qubit_count=0, runtime_ms=0.0, baseline=None, quantum_trace=None, duration=None, *, decision=_UNSET, classical_baseline=_UNSET)[source]

Standardized outcome of a generic quantum execution / solver run.

Variables:

  • problem – Machine-readable problem identifier.

  • solution – Computed solution produced by the execution.

  • confidence – Confidence score in [0, 1].

  • fidelity – Circuit/quantum fidelity achieved, if measurable.

  • qubit_count – Number of qubits used by the execution.

  • runtime_ms – End-to-end execution runtime in milliseconds.

  • baseline – Reference (classical) result, if available.

  • quantum_trace – Optional execution trace (shots, error budget, etc.).

  • duration – ISO 8601 timestamp of completion.

Parameters:

  • problem (str)

  • solution (Any)

  • confidence (float)

  • fidelity (Optional[float])

  • qubit_count (int)

  • runtime_ms (float)

  • baseline (Any)

  • quantum_trace (Optional[dict[str, Any]])

  • duration (Optional[str])

  • decision (Any)

  • classical_baseline (Any)

problem: str[source]
solution: Any = None[source]
confidence: float = 1.0[source]
fidelity: float | None = None[source]
qubit_count: int = 0[source]
runtime_ms: float = 0.0[source]
baseline: Any = None[source]
quantum_trace: dict[str, Any][source]
duration: str[source]
to_dict()[source]

Serialize to a JSON-safe dictionary.

Return type:

dict[str, Any]

to_json()[source]

Serialize to a JSON string.

Return type:

str

property improved_over_baseline: bool | None[source]

True if the quantum solution beats the reference baseline.

Only meaningful when both solution and baseline are numeric, or quantum_trace carries a comparable metric.

Return type:

Optional[bool]

property improved_over_classical: bool | None[source]

Deprecated alias for improved_over_baseline.

Return type:

Optional[bool]

property decision: Any[source]

Deprecated alias for solution.

Return type:

Any

property classical_baseline: Any[source]

Deprecated alias for baseline.

Return type:

Any