# numqi: a numpy-based quantum information package
[](https://zenodo.org/doi/10.5281/zenodo.10867067)
[](https://codecov.io/github/numqi/numqi)
WARNING: no backward compatibility guarantee until version `1.0.0`
keyword: quantum information, numpy, pytorch, manifold optimization, trivialization
## Quickstart
more detailed installation instructions see [docs/installation](./docs/installation.md)
```bash
pip install numqi
```
A simple example to detect whether Bell state [wiki](https://en.wikipedia.org/wiki/Bell_state) is entangle or not using positive partial transpose (PPT) criteria.
```Python
import numqi
bell_state = numqi.state.Werner(d=2, alpha=1)
print(bell_state) #a numpy array
# [[ 0. 0. 0. 0. ]
# [ 0. 0.5 -0.5 0. ]
# [ 0. -0.5 0.5 0. ]
# [ 0. 0. 0. 0. ]]
print(numqi.entangle.is_ppt(bell_state, (2,2))) #True if seperable, False if entangled
# False
```
## Module structure
```mermaid
mindmap
root((numqi))
core
manifold
random
optimize
state
gate
pauli
sim
QCircuit simulator
Clifford simulator
dicke
gellmann
channel
matrix space
geometric measure
hierarchical method
group
application
entangle
PureB ext
irrep symext
PPT
CHA
qec
VarQEC
maximum entropy
unique determine
UDA
UDP
query
VarQQA
optimal control
GRAPE
```
core modules
1. `numqi.sim`: numpy based quantum simulator [wiki/quantum-simulator](https://en.wikipedia.org/wiki/Quantum_simulator), support gradient back-propagation and variational quantum circuits, Clifford circuit simulator
2. `numqi.dicke`: Dicke basis, bosonic states
3. `numqi.random`: sample random quantum states, matrices, channels, etc.
4. `numqi.state`: various quantum states, like Werner state, Bell state, etc. and their properties like entanglement measure, etc.
5. `numqi.gate`: various quantum gate [wiki/quantum-logic-gate](https://en.wikipedia.org/wiki/Quantum_logic_gate), like Pauli gate (various representation), Clifford gate, etc.
6. `numqi.gellmann`: convert matrix into gellmann basis and reversally [wiki/gellmann](https://en.wikipedia.org/wiki/Gell-Mann_matrices) [wiki/generalized-gellmann](https://en.wikipedia.org/wiki/Generalizations_of_Pauli_matrices)
7. `numqi.channel`: utilities related to quantum channel, like conversion between different representations of a quantum channel (Kraus operator, super-operator, Choi state, etc.) [wiki/quantum-channel](https://en.wikipedia.org/wiki/Quantum_channel)
8. `numqi.manifold`: trivialzation of various smooth manifolds and quantum objects
* smooth manifold: sphere, positive semi-definite matrix, special orthogonal / unitary group, Stiefel manifold etc.
* quantum object: denotes quantum state, quantum gate, Hamiltonian, quantum channel etc.
9. `numqi.group`: some basic utility for group theory [wiki/group](https://en.wikipedia.org/wiki/Group_(mathematics)), like irreducible representation, symmetric group, Symplectic group over finite field `Sp(2n, F2)`, etc.
10. `numqi.optimize`: wrapper of `scipy.optimize` and `SGD/Adam` optimizers for manifold optimization
11. `numqi.matrix_space`: Numerical range, linear space of matrices, geometric measure, hierarchical method, etc.
* Quantifying Subspace Entanglement with Geometric Measures [arxiv-link](https://arxiv.org/abs/2311.10353)
12. `numqi.utils`: some utility functions, like, calculate fidelity, purity, entropy etc.
application modules
1. `numqi.entangle`: detect entanglement [wiki/quantum-entanglement](https://en.wikipedia.org/wiki/Quantum_entanglement)
* PPT (positive partial transpose)
* convex hull approximation
* Pure Bosonic extension [arxiv-link](https://arxiv.org/abs/2209.10934)
* irreducible representation of symmetric extension [doi-link](https://doi.org/10.3390/e25101425)
* unextendible product state, bound extangled state, etc.
2. `numqi.maximum_entropy`: relation between Hamiltonian, groud state, and marginal problem
* Maximum entropy methods for quantum state compatibility problems [arxiv-link](https://arxiv.org/abs/2207.11645)
3. `numqi.qec`: quantum error correction code (QECC) [wiki](https://en.wikipedia.org/wiki/Quantum_error_correction)
* Variational learning for quantum error-correcting codes [doi-link](https://doi.org/10.22331/q-2022-10-06-828)
* circuits to encode some well-known QECC, like `((5,2,3))`, `((8,8,3))`
4. `numqi.unique_determine`: unique determinedness in quantum state tomography
* Variational Approach to Unique Determinedness in Pure-state Tomography [arxiv-link](https://arxiv.org/abs/2305.10811)
5. `numqi.query`: quantum query
* Variational learning algorithms for quantum query complexity [arxiv-link](https://arxiv.org/abs/2205.07449)
6. `numqi.optimal_control`: optimal control for quantum system, e.g. finding the optimal control pulse to implement a quantum gate
* Gradient ascent pulse engineering algorithm (GRAPE) (gradient ascent pulse engineering)
## Folder structure
1. `python/numqi/`: source code
2. `docs/`: kinds of markdown files for generating website
3. `tests/`: unit tests
4. `examples/`: single file scripts to demonstrate how to use `numqi`
5. `project/`: some projects based on `numqi`, whether finished or not
6. misc
* `README.md`: this file
* `pyproject.toml`: to make a pip-installable package
* `mkdocs.yml`: to generate website
* `LICENSE`
* `.gitignore`
## How to contribute
see [docs/installation](./docs/installation.md) "Guide-for-contributors" section
## mermaid diagram
Since mkdocs-material not supported the mermaid-10.x [mkdocs-material/issue](https://github.com/squidfunk/mkdocs-material/issues/5193), while github web support it, let's put all these mermaid diagram here and make a screenshot on the [mermaid-live-editor](https://mermaid.live/)
```bash
mmdc -i numqi-module.mmd -o numqi-module.png
```
module structure
```mermaid
flowchart TD
id1(density matrix)
id2(((SEP)))
id3(((ENT)))
id4(PPT?)
id5(CHA?)
id6(bosonic extension SDP?)
id7(larger k PureB-ext?)
id8{{dotted line: not guaranteed, probably}}
id1 --> id4
id4 -->|no| id3
id4 -->|yes| id5
id5 -.->|large loss| id3
id5 -->|large loss| id6
id6 -->|no| id3
id6 -->|yes| id7
id7 -.->|zero loss| id2
id7 -.->|large loss| id3
id5 -->|zero loss| id2
```
## Recommended courses
1. point-set topology
* [youtube-link](https://youtube.com/playlist?list=PLd8NbPjkXPliJunBhtDNMuFsnZPeHpm-0&si=Y5-wnge2rWO1HNVb) Marius Furter
2. smooth manifold
* [youtube-link](https://www.youtube.com/playlist?list=PLBh2i93oe2qvRGAtgkTszX7szZDVd6jh1) The Bright Side of Mathematics
* [youtube-link](https://www.youtube.com/playlist?list=PLD2r7XEOtm-AGjr3ynbljbx3oWHdus9Xb) qncubed3
3. Riemannian manifold
4. Differential geometry
5. algebraic topology
* [youtube-link](https://www.youtube.com/playlist?list=PLOROtRhtegr7DmeMyFxfKxsljAVsAn_X4) Presented by Dr. Anthony Bosman.
Raw data
{
"_id": null,
"home_page": null,
"name": "numqi",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "quantum information",
"author": null,
"author_email": "husisy <donot@mail.me>",
"download_url": "https://files.pythonhosted.org/packages/0d/4a/09f75b63b5b3db24a4098e36b3b37844dd85ff44a84249d4e68171887a32/numqi-0.4.0.tar.gz",
"platform": null,
"description": "# numqi: a numpy-based quantum information package\n\n[](https://zenodo.org/doi/10.5281/zenodo.10867067)\n[](https://codecov.io/github/numqi/numqi)\n\nWARNING: no backward compatibility guarantee until version `1.0.0`\n\nkeyword: quantum information, numpy, pytorch, manifold optimization, trivialization\n\n## Quickstart\n\nmore detailed installation instructions see [docs/installation](./docs/installation.md)\n\n```bash\npip install numqi\n```\n\nA simple example to detect whether Bell state [wiki](https://en.wikipedia.org/wiki/Bell_state) is entangle or not using positive partial transpose (PPT) criteria.\n\n```Python\nimport numqi\nbell_state = numqi.state.Werner(d=2, alpha=1)\nprint(bell_state) #a numpy array\n# [[ 0. 0. 0. 0. ]\n# [ 0. 0.5 -0.5 0. ]\n# [ 0. -0.5 0.5 0. ]\n# [ 0. 0. 0. 0. ]]\nprint(numqi.entangle.is_ppt(bell_state, (2,2))) #True if seperable, False if entangled\n# False\n```\n\n## Module structure\n\n```mermaid\nmindmap\n root((numqi))\n core\n manifold\n random\n optimize\n state\n gate\n pauli\n sim\n QCircuit simulator\n Clifford simulator\n dicke\n gellmann\n channel\n matrix space\n geometric measure\n hierarchical method\n group\n application\n entangle\n PureB ext\n irrep symext\n PPT\n CHA\n qec\n VarQEC\n maximum entropy\n unique determine\n UDA\n UDP\n query\n VarQQA\n optimal control\n GRAPE\n```\n\ncore modules\n\n1. `numqi.sim`: numpy based quantum simulator [wiki/quantum-simulator](https://en.wikipedia.org/wiki/Quantum_simulator), support gradient back-propagation and variational quantum circuits, Clifford circuit simulator\n2. `numqi.dicke`: Dicke basis, bosonic states\n3. `numqi.random`: sample random quantum states, matrices, channels, etc.\n4. `numqi.state`: various quantum states, like Werner state, Bell state, etc. and their properties like entanglement measure, etc.\n5. `numqi.gate`: various quantum gate [wiki/quantum-logic-gate](https://en.wikipedia.org/wiki/Quantum_logic_gate), like Pauli gate (various representation), Clifford gate, etc.\n6. `numqi.gellmann`: convert matrix into gellmann basis and reversally [wiki/gellmann](https://en.wikipedia.org/wiki/Gell-Mann_matrices) [wiki/generalized-gellmann](https://en.wikipedia.org/wiki/Generalizations_of_Pauli_matrices)\n7. `numqi.channel`: utilities related to quantum channel, like conversion between different representations of a quantum channel (Kraus operator, super-operator, Choi state, etc.) [wiki/quantum-channel](https://en.wikipedia.org/wiki/Quantum_channel)\n8. `numqi.manifold`: trivialzation of various smooth manifolds and quantum objects\n * smooth manifold: sphere, positive semi-definite matrix, special orthogonal / unitary group, Stiefel manifold etc.\n * quantum object: denotes quantum state, quantum gate, Hamiltonian, quantum channel etc.\n9. `numqi.group`: some basic utility for group theory [wiki/group](https://en.wikipedia.org/wiki/Group_(mathematics)), like irreducible representation, symmetric group, Symplectic group over finite field `Sp(2n, F2)`, etc.\n10. `numqi.optimize`: wrapper of `scipy.optimize` and `SGD/Adam` optimizers for manifold optimization\n11. `numqi.matrix_space`: Numerical range, linear space of matrices, geometric measure, hierarchical method, etc.\n * Quantifying Subspace Entanglement with Geometric Measures [arxiv-link](https://arxiv.org/abs/2311.10353)\n12. `numqi.utils`: some utility functions, like, calculate fidelity, purity, entropy etc.\n\napplication modules\n\n1. `numqi.entangle`: detect entanglement [wiki/quantum-entanglement](https://en.wikipedia.org/wiki/Quantum_entanglement)\n * PPT (positive partial transpose)\n * convex hull approximation\n * Pure Bosonic extension [arxiv-link](https://arxiv.org/abs/2209.10934)\n * irreducible representation of symmetric extension [doi-link](https://doi.org/10.3390/e25101425)\n * unextendible product state, bound extangled state, etc.\n2. `numqi.maximum_entropy`: relation between Hamiltonian, groud state, and marginal problem\n * Maximum entropy methods for quantum state compatibility problems [arxiv-link](https://arxiv.org/abs/2207.11645)\n3. `numqi.qec`: quantum error correction code (QECC) [wiki](https://en.wikipedia.org/wiki/Quantum_error_correction)\n * Variational learning for quantum error-correcting codes [doi-link](https://doi.org/10.22331/q-2022-10-06-828)\n * circuits to encode some well-known QECC, like `((5,2,3))`, `((8,8,3))`\n4. `numqi.unique_determine`: unique determinedness in quantum state tomography\n * Variational Approach to Unique Determinedness in Pure-state Tomography [arxiv-link](https://arxiv.org/abs/2305.10811)\n5. `numqi.query`: quantum query\n * Variational learning algorithms for quantum query complexity [arxiv-link](https://arxiv.org/abs/2205.07449)\n6. `numqi.optimal_control`: optimal control for quantum system, e.g. finding the optimal control pulse to implement a quantum gate\n * Gradient ascent pulse engineering algorithm (GRAPE) (gradient ascent pulse engineering)\n\n## Folder structure\n\n1. `python/numqi/`: source code\n2. `docs/`: kinds of markdown files for generating website\n3. `tests/`: unit tests\n4. `examples/`: single file scripts to demonstrate how to use `numqi`\n5. `project/`: some projects based on `numqi`, whether finished or not\n6. misc\n * `README.md`: this file\n * `pyproject.toml`: to make a pip-installable package\n * `mkdocs.yml`: to generate website\n * `LICENSE`\n * `.gitignore`\n\n## How to contribute\n\nsee [docs/installation](./docs/installation.md) \"Guide-for-contributors\" section\n\n## mermaid diagram\n\nSince mkdocs-material not supported the mermaid-10.x [mkdocs-material/issue](https://github.com/squidfunk/mkdocs-material/issues/5193), while github web support it, let's put all these mermaid diagram here and make a screenshot on the [mermaid-live-editor](https://mermaid.live/)\n\n```bash\nmmdc -i numqi-module.mmd -o numqi-module.png\n```\n\nmodule structure\n\n```mermaid\nflowchart TD\n id1(density matrix)\n id2(((SEP)))\n id3(((ENT)))\n id4(PPT?)\n id5(CHA?)\n id6(bosonic extension SDP?)\n id7(larger k PureB-ext?)\n id8{{dotted line: not guaranteed, probably}}\n id1 --> id4\n id4 -->|no| id3\n id4 -->|yes| id5\n id5 -.->|large loss| id3\n id5 -->|large loss| id6\n id6 -->|no| id3\n id6 -->|yes| id7\n id7 -.->|zero loss| id2\n id7 -.->|large loss| id3\n id5 -->|zero loss| id2\n```\n\n## Recommended courses\n\n1. point-set topology\n * [youtube-link](https://youtube.com/playlist?list=PLd8NbPjkXPliJunBhtDNMuFsnZPeHpm-0&si=Y5-wnge2rWO1HNVb) Marius Furter\n2. smooth manifold\n * [youtube-link](https://www.youtube.com/playlist?list=PLBh2i93oe2qvRGAtgkTszX7szZDVd6jh1) The Bright Side of Mathematics\n * [youtube-link](https://www.youtube.com/playlist?list=PLD2r7XEOtm-AGjr3ynbljbx3oWHdus9Xb) qncubed3\n3. Riemannian manifold\n4. Differential geometry\n5. algebraic topology\n * [youtube-link](https://www.youtube.com/playlist?list=PLOROtRhtegr7DmeMyFxfKxsljAVsAn_X4) Presented by Dr. Anthony Bosman.\n",
"bugtrack_url": null,
"license": "GNU Affero General Public License v3.0",
"summary": "a numpy-based quantum information toolbox",
"version": "0.4.0",
"project_urls": {
"Documentation": "https://numqi.github.io/numqi/",
"Homepage": "https://github.com/numqi/numqi/",
"Issues": "https://github.com/numqi/numqi/issues"
},
"split_keywords": [
"quantum",
"information"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9d0b891ff491e37e6e9727e26e1db018c030d4b2c60197baf83e66849716e5ab",
"md5": "aaa86a732c815456314a8552a73889b9",
"sha256": "7d1e8b67165dfb7655984c4846c0e3525b754e5699e55889d77976379ed45c87"
},
"downloads": -1,
"filename": "numqi-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "aaa86a732c815456314a8552a73889b9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 339941,
"upload_time": "2024-11-09T02:03:37",
"upload_time_iso_8601": "2024-11-09T02:03:37.427822Z",
"url": "https://files.pythonhosted.org/packages/9d/0b/891ff491e37e6e9727e26e1db018c030d4b2c60197baf83e66849716e5ab/numqi-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0d4a09f75b63b5b3db24a4098e36b3b37844dd85ff44a84249d4e68171887a32",
"md5": "9f718bc3eb7ca21d0141b5d13bb7a947",
"sha256": "a6b7376db12257c82a14774790de708de35f1e3fbe53e51eb5a9303b932dbf59"
},
"downloads": -1,
"filename": "numqi-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "9f718bc3eb7ca21d0141b5d13bb7a947",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 4983769,
"upload_time": "2024-11-09T02:03:39",
"upload_time_iso_8601": "2024-11-09T02:03:39.312825Z",
"url": "https://files.pythonhosted.org/packages/0d/4a/09f75b63b5b3db24a4098e36b3b37844dd85ff44a84249d4e68171887a32/numqi-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-09 02:03:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "numqi",
"github_project": "numqi",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "numqi"
}
JSON
