Pre-release
This release is a pre-release and may not be stable for production use.
Cqlib-QML
英文版见 English version。
本项目是基于 Cqlib 的量子机器学习 Python 工具包，提供经典数据量子编码、参数化量子线路、纯量子与混合量子—经典神经网络、量子核方法及模型训练组件。
安装说明
环境要求：Python 3.11 及以上版本，cqlib 2.0.0b3 及以上版本。
从源码安装：
git clone https://github.com/cq-lib/cqlib-qml.git
cd cqlib-qml
pip install .
发布到 PyPI 后，也可以直接安装：
pip install cqlib-qml
开发环境安装：
pip install -r requirements-dev.txt
pip install -e .
主要功能
- encoder：将经典向量和图像编码为量子线路，支持振幅编码、角度编码、基态编码、FRQI、NEQR、Qubit Lattice 和 ZZ Feature Map。
- ansatz：参数化量子线路，包含硬件高效线路、BasicQNN、CRADL 和 CRAML。
- models：纯量子神经网络
QNN、混合量子—经典神经网络HQNN，以及用于组合量子与经典组件的Module。 - algorithms：量子核方法
QKM、量子支持向量机QSVM和兼容 scikit-learn 接口的变分量子分类器VQC。 - differentiator：伴随法和参数偏移法量子梯度计算。
- layer：全连接层与常用激活函数，用于构建混合模型的经典部分。
- data：数据集、批加载和图像数据预处理工具。
- loss / optimizer / scheduler：常用损失函数、参数优化器和学习率调度器。
- utils：量子门梯度矩阵等辅助工具。
快速开始
下面使用角度编码和量子核构造核矩阵：
import numpy as np
from cqlib_qml.algorithms import QKM
from cqlib_qml.encoder import AngleEncoder
encoder = AngleEncoder(mode="classical")
kernel = QKM(encoder=encoder)
samples = np.array([
[0.1, 0.2],
[0.3, 0.4],
[0.5, 0.6],
])
kernel_matrix = kernel.kernel(samples)
print(kernel_matrix)
构建量子神经网络：
from cqlib_qml.ansatz import HEAnsatz
from cqlib_qml.models import QNN
ansatz = HEAnsatz(n_qubits=4, d=2, layers=["RY", "CX"])
ansatz.set_measurement(readouts=[0])
model = QNN(ansatz=ansatz)
更多说明参见 docs/tutorials。
测试
pytest
License
Apache License 2.0，详见 LICENSE。
Contributing
欢迎贡献！如需改进功能或修复缺陷，请提交 Issue 或发起 Pull Request。
1 maintainer
Metadata
1 maintainer
Release files for cqlib-qml 0.1.0b1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cqlib_qml-0.1.0b1.tar.gz | 172.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cqlib_qml-0.1.0b1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 287.3 kB
Release files / cqlib_qml-0.1.0b1.tar.gz
| Download URL | cqlib_qml-0.1.0b1.tar.gz |
|---|---|
| Size | 172.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d515dd11a6410f6069b2a1f2bf36d577e341bd1dadd40cc990ec478967fc5292
|
|
BLAKE2b-256 checksum How to use checksums |
6a725dc542168a2bd0fd74d258cdc625658ca964f3a8f45abbd7a45a63e990a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.20
|
Release files / cqlib_qml-0.1.0b1-py3-none-any.whl
| Download URL | cqlib_qml-0.1.0b1-py3-none-any.whl |
|---|---|
| Size | 114.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6c5ba39d97676ec295720e18f90cf3d55fbdada53d2ba45e3206cb37052317cb
|
|
BLAKE2b-256 checksum How to use checksums |
fbbd3092987949d3e55bdaa43f8c2c6cfb8dc9588181d112d77e5c6338eb3c08
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.20
|
