qcloud 模块

pyqpanda3.qcloud 模块提供量子云计算服务，用于将量子程序提交到 OriginQ 云后端，包括模拟器、超算集群和真实量子处理器（QPU）。

概述

qcloud 模块是与 OriginQ 量子云平台交互的主要接口。它提供了用于管理云服务、提交量子任务、检索结果以及配置噪声模型以进行真实模拟的类。

典型的工作流程为：

1. 使用您的 API 密钥创建 QCloudService 实例。
2. 使用 backends() 列出可用后端，并通过 backend() 选择一个后端。
3. 通过 QCloudBackend.run() 提交量子程序。
4. 通过 QCloudJob 监控任务状态。
5. 从 QCloudResult 获取测量结果。

类

类	描述
QCloudService	连接量子云平台和管理后端的主要入口
QCloudBackend	表示一个特定的量子后端（模拟器或真实芯片），用于运行程序
QCloudJob	表示一个已提交的量子任务，提供状态跟踪和结果检索方法
QCloudResult	包含量子任务的执行结果，包括概率、计数和振幅
QCloudOptions	云任务执行的配置选项，如映射、优化和修正
QCloudNoiseModel	用于云端含噪模拟的噪声模型配置
ChipInfo	量子芯片信息，包括量子比特属性和拓扑结构
ChipBackend	底层芯片后端配置，包括拓扑边和门时序
SingleQubitInfo	芯片上单个量子比特的属性（保真度、T1、T2、频率）
DoubleQubitsInfo	量子比特对的属性（门保真度）

枚举

枚举	描述
JobStatus	云任务的状态（WAITING, COMPUTING, FINISHED, FAILED, QUEUING）
DataFormat	量子线路导出的数据格式（DEFAULT, BINARY, INSTRUCTION_SET）
DataBase	测量结果的进制表示（Binary, Hex）
NOISE_MODEL	量子噪声模型类型（比特翻转、阻尼、退相干等）
LogLevel	日志详细程度（CLOUD_INFO, CLOUD_DEBUG, CLOUD_WARNING, CLOUD_ERROR）
LogOutput	日志输出目标（CONSOLE, FILE）

快速入门

from pyqpanda3.qcloud import QCloudService, QCloudNoiseModel
from pyqpanda3.core import QCircuit, H, CNOT, measure

# Connect to the cloud service
service = QCloudService(api_key="your_api_key")

# List available backends
backend_names = service.backends()
print("Available backends:", backend_names)

# Select a backend
backend = service.backend("backend_name")

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

# Run on the backend
job = backend.run(prog, shots=1000)

# Get the result
result = job.result()
probs = result.get_probs()
print("Probabilities:", probs)

另见

• pilot_service 模块 -- 底层 QPilot OS 集成