ket-lang 0.2

Ket Quantum Programming Language interpreter and library.

Ket Quantum Programming Language

Ket is a Python-embedded language for hybridity classical-quantum programming.

Table of contents:

• Code examples
• Usage
• Installation

Code examples

Random Number Generation

# random.ket
def random(n_bits):
  with run():
     q = quant(n_bits)
     H(q)
     return measure(q).get()

n_bits = 32
print(n_bits, 'bits random number:', random(n_bits))

$ ket random.ket
32 bits random number: 3830764503

Quantum Teleportation:

# teleport.ket
def teleport(alice : quant) -> quant:
    alice_b, bob_b = quant(2)
    ctrl(H(alice_b), X, bob_b)

    ctrl(alice, X, alice_b)
    H(alice)

    m0 = measure(alice)
    m1 = measure(alice_b)

    if m1 == 1:
        X(bob_b)
    if m0 == 1:
        Z(bob_b)

    return bob_b

alice = quant(1)         # alice = |0⟩
H(alice)                 # alice = |+⟩
Z(alice)                 # alice = |–⟩
bob = teleport(alice)    # bob  <- alice
H(bob)                   # bob   = |1⟩
bob_m = measure(bob)

print('Expected measure 1, result =', bob_m.get())

$ ket teleport.ket
Expected measure 1, result = 1

Usage

$ ket -h
usage: ket [-h] [--version] [-o OUT] [-s KBW] [-u USER] [-p PORT]
           [-P SSH_PORT] [--seed SEED] [--api-args API_ARGS] [--no-execute]
           [--dump2fs]
           .ket

Ket interpreter

positional arguments:
  .ket                  source code

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -o OUT, --out OUT     KQASM output file
  -s KBW, --kbw KBW     quantum execution (KBW) IP address
  -u USER, --user USER  quantum execution (KBW) SSH user
  -p PORT, --port PORT  quantum execution (KBW) port
  -P SSH_PORT, --ssh-port SSH_PORT
                        quantum execution (KBW) SSH port
  --seed SEED           set RNG seed for quantum execution
  --api-args API_ARGS   additional parameters for quantum execution
  --no-execute          does not execute KQASM, measurements return 0
  --dump2fs             use the filesystem to transfer dump data

Installation

Ket Bitwise Simulator is required for quantum execution. See https://gitlab.com/quantum-ket/kbw#installation for installation instructions.

Available installation methods:

• pip
• Source
• Docker

Install using pip

Installing from PyPI:

$ pip install ket-lang

Installing the last version from git:

$ pip install git+https://gitlab.com/quantum-ket/ket.git

Compiled manylinux wheel available here

Install from source

Install requirements:

• C/C++ compiler
• CMake
• Ninja or GNU Make
• Conan

To install from source runs:

$ git clone --recurse-submodules https://gitlab.com/quantum-ket/ket.git
$ cd ket
$ python setup.py install

Docker with Jupyter Notebook

$ docker run --rm -it -v `pbw`:/home/ket -p 8888:8888 evandrocrr/ket:0.2

---

This project is part of the Ket Quantum Programming, see the documentation for more information https://quantum-ket.gitlab.io.