文档版本

build_result_view¶

from cascaqit import build_result_view

build_result_view ¶

build_result_view(
    result: ResultIR,
    *,
    artifact_manifest: ArtifactManifestIR | None = None,
    view_id: str | None = None,
) -> ResultViewIR

把 ResultIR 整理为 ResultViewIR，便于应用展示或导出。view_id 可自定义，默认形如 result_view.<result_id>。artifact_manifest 可附带 ArtifactManifestIR 的数量与大小摘要，不读取附件字节。

视图包含 counts、samples、可选概率、观测量批次、位序、测量映射、诊断、状态交接、实际执行配置、积分器记录和附件引用。缺失记录不会由工具推测补出。多个测量寄存器仍在 measurement_results 中分别保存，不能只读取空的顶层 counts。

from cascaqit import Circuit, build_result_view

result = Circuit(1).measure_all().run(shots=8, seed=7)
view = build_result_view(result)
assert view.counts == result.counts
assert view.result_id == result.result_id
assert view.metadata_only and not view.backend_called

该函数不修改原 ResultIR、不重新执行、不访问网络，也不解释结果是否科学正确。错误 result 或 artifact_manifest 类型抛出 TypeError；损坏的嵌套执行记录可能在还原时产生校验错误。完整读取路径见结果与诊断。