Skip to content

harui2019/qurry_preview

Repository files navigation

Qurry 🍛 - The Quantum Experiment Manager for Qiskit and The Measuring Tool for Renyi Entropy, Wave Function Overlap, and More

This is a tool to measure the Renyi entropy, Wave Function Overlap, and Magnetization Squared of given wave function. Running on IBM Qiskit with the function from constructing experiment object to pending the jobs to IBMQ automatically.


Acknowledgments

It's a great thanks for National Chengchi University, NSTC-Quantum Virtual Machine project, and National Center for Theoretical Sciences, Physics Division located National Taiwan University , which funded the development of this tool during the author @harui2019 worked at this institution as Research Assistiant, and i also a great thanks for IBM Quantum Hub at National Taiwan University providing the access right of IBM Quantum, let us can fully test this tool and execute our experiments.

National Chengchi University

NSTC

National Center for Theoretical Sciences, Physics Division

IBM Quantum Hub at National Taiwan University


Environment

We currently ONLY SUPPORT qiskit up to 0.46.0, qiskit 1.0.0+ is not supported yet.

Available Python Version

Available System Available System

Available System Available System

  • Ubuntu 18.04+ LTS (All ManyLinux 2014 compatible distro)

    • on x86_64 (recommended)
    • on x86_64 Windows 10/11 WSL2 (recommended)
    • on aarch64
    • We strongly recommend to use Linux based system, due to Python multiprocessing may exist some unknown issue on Windows and the GPU acceleration of Qiskit, qiskit-aer-gpu only works with Nvidia CUDA on Linux.
  • Windows 10/11

    • on x86_64
  • MacOS 11+

    • on aarch64 (Apple Silicon, M1/M2/M3 chips) (recommended)
    • on x86_64 (Intel chips)
  • with required modules:

    • qiskit, qiskit-aer, tqdm, requests
  • with optional modules:

    • qiskit-aer-gpu: when use Linux
    • qiskit-ibm-provider: when use IBM Quantum
    • qiskit-ibmq-provider: when use IBM Quantum, the deprecated version of qiskit-ibm-provider

Install

By PyPI

Not available now, but coming soon

By TestPyPI

pip install qiskit qiskit-aer tqdm requests 
# the installation from testPyPI can' t find these dependencies
pip install -i https://test.pypi.org/simple/ qurry

Maually by Git

This method is installed from source, since we introduce Rust, it will require "Rust complier" you need to install first.

You can install rust quickly by the following command:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then, you can install qurry by the following command:

git clone https://github.com/harui2019/qurry.git --recursive
cd qurry
pip install -e .

We have pytest for testing, you can run the following command to test:

pytest

After you finish the installation and want to comfirm the installation.


Measurement

qurrent - The Renyi Entropy Measurement

The main function to measure the entropy. The following is the methods used to measure.

  • Hadamard Test

    • Used in: Entanglement spectroscopy on a quantum computer - Sonika Johri, Damian S. Steiger, and Matthias Troyer, PhysRevB.96.195136
  • Haar Randomized Measure

    • From: Statistical correlations between locally randomized measurements: A toolbox for probing entanglement in many-body quantum states - A. Elben, B. Vermersch, C. F. Roos, and P. Zoller, PhysRevA.99.052323

qurrech - The Wave Function Overlap Measurement

It's similar to qurrent.

  • Hadamard Test

    • Used in: Entanglement spectroscopy on a quantum computer - Sonika Johri, Damian S. Steiger, and Matthias Troyer, PhysRevB.96.195136
  • Haar Randomized Measure

    • From: Statistical correlations between locally randomized measurements: A toolbox for probing entanglement in many-body quantum states - A. Elben, B. Vermersch, C. F. Roos, and P. Zoller, PhysRevA.99.052323
  • More wait for adding...