qutree

plot Bloch Sphere Binary Tree

https://github.com/alice4space/qutree

Keywords

Repository

plot Bloch Sphere Binary Tree

README.rst

qutree
======

.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.7634517.svg
   :target: https://doi.org/10.5281/zenodo.7634517
   :alt: zenodo

.. image:: https://img.shields.io/badge/License-MIT-yellow
    :target: https://github.com/alice4space/qutree/blob/main/LICENSE
    :alt: License: MIT

.. image:: https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow
    :target: https://conventionalcommits.org
    :alt: conventional commit

.. image:: https://img.shields.io/badge/code%20style-black-000000
    :target: https://github.com/psf/black
    :alt: Black badge

.. image:: https://img.shields.io/pypi/v/qutree?color=orange&logo=python&logoColor=white
    :target: https://pypi.org/project/qutree
    :alt: PyPI

.. image:: https://img.shields.io/pypi/dm/qutree?logo=python&logoColor=white
   :target: https://pypi.org/project/qutree
   :alt: PyPI - Downloads

.. image:: https://img.shields.io/github/actions/workflow/status/alice4space/qutree/unit.yaml?logo=github&logoColor=white
    :target: https://github.com/alice4space/qutree/actions/workflows/unit.yaml
    :alt: build

.. image:: https://img.shields.io/codecov/c/github/alice4space/qutree?logo=codecov&logoColor=white
    :target: https://codecov.io/gh/alice4space/qutree
    :alt: Test Coverage

.. image:: https://img.shields.io/codeclimate/maintainability/alice4space/qutree?logo=codeclimate&logoColor=white
    :target: https://codeclimate.com/github/alice4space/qutree/maintainability
    :alt: maintainability

.. image:: https://img.shields.io/readthedocs/pyqutree/latest?logo=readthedocs&logoColor=white
    :target: https://pyqutree.readthedocs.io/en/latest/
    :alt: Documentation Status

.. image:: https://img.shields.io/badge/all_contributors-2-blue
    :target: https://github.com/alice4space/qutree/blob/main/AUTHORS.rst
    :alt: All contributors

.. image:: https://img.shields.io/badge/-open%20in%20colab-blue?logo=googlecolab&labelColor=555&logoColor=white
    :target: https://colab.research.google.com/github/alice4space/qutree/blob/main/docs/source/examples/demo.ipynb
    :alt: colab

.. image:: https://img.shields.io/badge/-open%20in%20mybinder-blue?logo=jupyter&labelColor=555&logoColor=white
    :target: https://mybinder.org/v2/gh/alice4space/qutree/main?labpath=docs%2Fsource%2Fexamples%2Fdemo.ipynb
    :alt: binder


Overview
--------

Plot sets of multiqubit quantum pure states as a binary tree of Bloch spheres.

We present a representation that can display several arbitrary multi-qubit pure states, using a combination of the Bloch Sphere and the Schmidt decomposition.

Our current approaches to visualization of quantum states allow to display:

- several mono-qubit states, using the Bloch sphere
- a single multi-qubit state, sometimes with additional restrictions such as symmetry

Usage
-----

install with pip:

.. code-block:: console

    pip install qutree

And you will be able to produce this type of Bloch sphere's tree:

.. image::  https://raw.githubusercontent.com/alice4space/qutree/main/docs/_static/example.png
    :alt: example tree

More information can be found in our `documentation `__.

Citing
------

If you find qutree useful in your research, please consider citing the following papers to support our work. Thank you for your support.

-   Barthe, A., Grossi, M., Tura, J., and Dunjko, V.. (2023). Bloch Sphere Binary Trees: A method for the visualization of sets of multi-qubit systems pure states.
    https://doi.org/10.48550/arXiv.2302.02957

-   Rambaud, P., Barthe, A.. (2023). qutree. Zenodo. https://doi.org/10.5281/zenodo.7634518

Contribute
----------

If you want to contribute you can fork the project in your own repository and then use it. If you consider working with us, please follow the `contributing guidelines `__.

This package was created with `Copier `__ and the `@12rambau/pypackage `__ 0.1.11 project template.

Owner

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: qutree
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Alice
    family-names: Barthe
    email: alice.barthe@cern.ch
    affiliation: "CERN, Leiden University"
    orcid: "https://orcid.org/0000-0002-1766-188X"
  - given-names: Pierrick
    family-names: Rambaud
    email: pierrick.rambaud@fao.org
    affiliation: FAO
    orcid: "https://orcid.org/0000-0001-8764-5749"
identifiers:
  - type: doi
    value: 10.5281/zenodo.7634517
repository-code: "https://github.com/alice4space/qutree"
url: "https://pyqutree.readthedocs.io/en/stable/"
abstract: >-
  This work presents an extension to the Bloch Sphere that
  allows to represent sets of multi-qubit pure states. The
  code includes the recursive algorithm to derive such
  representation from state vector coordinates, as well as
  associated plotting capacities.
keywords:
  - quantum
  - qubit
  - Bloch
  - visualization
  - python
license: MIT

GitHub Events