smandra/hybridq-baseline

HybridQ: 混合量子电路模拟器

镜像概述和主要用途

HybridQ是一个高度可扩展的平台，旨在提供通用框架整合多种先进技术，以在各类硬件上模拟大规模量子电路。该平台提供工具用于操作、开发和扩展适用于不同硬件架构的无噪声和有噪声电路，同时支持大规模高性能计算（HPC）模拟，通过自动平衡处理器节点工作负载及启用多后端使用以最大化并行效率。其核心通过简单且富有表达力的语言整合所有功能，实现技术与硬件间的无缝切换，无需编写冗长转换代码，大幅简化新型混合算法和技术的开发。

核心功能和特性

• 高度可扩展性：设计灵活，支持集成新的模拟技术和硬件后端
• 多技术整合：整合多种最先进的模拟技术，提供统一模拟框架
• 电路操作支持：提供工具用于操作、开发和扩展无噪声及有噪声量子电路
• 多硬件适配：支持在不同硬件架构上运行模拟
• HPC模拟能力：支持大规模高性能计算模拟，自动平衡节点工作负载
• 并行效率优化：启用多后端使用以最大化并行计算效率
• 无缝切换能力：通过简单表达语言实现技术与硬件间的无缝切换，减少转换代码编写

使用场景和适用范围

• 量子算法开发：简化新型混合量子算法的设计与测试
• 大规模量子电路模拟：模拟大型量子电路在不同硬件环境下的行为
• 多硬件架构测试：在多种硬件架构上验证量子电路性能
• HPC环境应用：利用高性能计算集群进行大规模量子模拟研究
• 噪声电路研究：开发和测试适用于有噪声量子硬件的电路技术

使用方法和配置说明

基本使用

通过Docker运行HybridQ镜像的基本命令：

bash
docker run -it docker.xuanyuan.run/smandra/hybridq

挂载本地目录

如需使用本地文件或保存模拟结果，可挂载本地目录：

bash
docker run -it -v /本地路径:/容器内路径 docker.xuanyuan.run/smandra/hybridq

配置HPC环境

在HPC环境中使用时，可通过环境变量配置节点和后端参数：

bash
docker run -it -e HPC_NODES=4 -e BACKEND=mpi docker.xuanyuan.run/smandra/hybridq

环境变量说明

示例：运行量子电路模拟

进入容器后，可通过HybridQ提供的命令行工具或API进行量子电路模拟。以下为简单示例：

python
# 导入HybridQ库
import hybridq

# 创建量子电路
circuit = hybridq.Circuit(nqubits=2)

# 添加量子门
circuit.add_gate('H', qubits=0)
circuit.add_gate('CNOT', qubits=[0, 1])

# 模拟电路
result = hybridq.simulate(circuit)

# 输出结果
print(result)