pilot_service 模块

pyqpanda3.pilot_service 模块提供 QPilot OS 集成，用于高级量子云工作流程。它通过 QPilot OS 平台将用户连接到虚拟机集群、超级计算机和真实量子计算设备。

概述

pilot_service 模块提供了比 qcloud 模块更底层的接口，可以对量子任务提交、任务构建、结果解析和后端通信进行精细控制。它面向需要以下高级功能的用户：

• 直接的任务消息构建和提交
• 带轮询的异步任务执行
• 量子态层析（Quantum State Tomography, QST）任务
• 在真实芯片上进行期望值计算
• 错误缓解和噪声学习
• 基于 TCP 的结果检索

典型的工作流程为：

1. 使用 QPilot OS 服务器 URL 和凭据创建 QPilotServiceBase 实例。
2. 使用 run() 或 async_run() 提交量子程序。
3. 使用 query_result() 或 query_task_state_vec() 查询任务状态。
4. 使用 parse_task_result() 或 parse_probability_result() 解析结果。

类

类	描述
QPilotServiceBase	与 QPilot OS 后端交互的主要服务类
PilotNoiseParams	用于基于 pilot 的模拟的噪声参数

枚举

枚举	描述
ErrorCode	QPilot OS 操作返回的错误代码

快速入门

from pyqpanda3.pilot_service import QPilotService
from pyqpanda3.core import QCircuit, H, CNOT, measure

# Connect to QPilot OS
service = QPilotService(
    url="https://qpilot.originquantum.cn",
    api_key="your_api_key"
)

# Create a quantum program
circuit = QCircuit(2)
circuit << H(0) << CNOT(0, 1)
prog = QProg()
prog << circuit << measure([0, 1], [0, 1])

# Run synchronously
result_str = service.run(prog, shot=1000, chip_id="simulation")

# Or run asynchronously
task_id = service.async_run(prog, shot=1000, chip_id="simulation")

# Query the result
state, results, err_code, err_info = service.query_result(task_id)

另见

• qcloud 模块 -- 更高层的云服务接口