# Quantum Programming 101

- Programming, Mathematics

Last revision:

Are you familiar with programming, but know absolutely nothing about quantum mechanics?

This was exactly my case when the IBM Quantum Experience was announced. For the first time, a quantum computer has been made publicly available, and anybody selected to participate could send programs to it.

I applied. I was selected. And then I had a really rough time attempting to decipher the user guide of the IBM 5Q quantum computer I had access to. The IBM staff tried to ease the learning curve, but I felt that the documentation made a lot of assumptions that a non-physicist do not have, and "intuitive" ideas presented to me (like the Bloch sphere) just confused me even more.

Therefore, I decided to compile below a generic introduction on quantum programming designed for classical programmers to ease their learning curve. I hope it will be useful to you and anybody else you share it to.

Be warned however that quantum programming requires some pretty advanced mathematical knowledge, but as long as you're familiar with probability, binary numbers, complex numbers and linear algebra, you should be fine.

## Meet the qubit

The qubit is an extension of the bit. Just like the bit, it returns a value of 0 or 1 when read, and the returned value doesn't change when read multiple times consecutively.

Unlike the bit however, the qubit does not simply store a value of 0 or 1. In fact, its internals cannot be well-defined, as its output is in general dependent on global factors which cannot be fully known. For example, when qubits interact with each other, they may become entangled in a way which causes an operation on one to affect the output of the other regardless of the physical distance between them.

What is possible however is to determine the probability of a qubit returning 0 or 1 based on our partial knowledge of it and all the other qubits it has interacted with during previous operations.

Note that a qubit not guaranteed to return a specific value is said to be in a superposition state.

## Probability amplitudes

A probability amplitude is a complex number directly linked to a possible qubits' output combination. The probability of reading a specific output combination is equal to the square of the absolute value of its probability amplitude.

Therefore, the known state of an entire set of qubits can be stored as a vector of all probability amplitudes of this set. By convention, this vector is a column vector ordered from lowest to highest possible binary outputs. Such a vector is called a quantum state.

Here is an example of a quantum state of 2 entangled qubits, along with its output probabilities:

$\begin{array}{c}\left[\begin{array}{c}{a}_{00}\\ {a}_{01}\\ {a}_{10}\\ {a}_{11}\end{array}\right]=\left[\begin{array}{c}i/\sqrt{2}\\ 0\\ 0\\ -i/\sqrt{2}\end{array}\right]\\ \\ P\left(00\right)={|{a}_{00}|}^{2}={|i/\sqrt{2}|}^{2}=1/2\\ P\left(01\right)={|{a}_{01}|}^{2}={|0|}^{2}=0\\ P\left(10\right)={|{a}_{10}|}^{2}={|0|}^{2}=0\\ P\left(11\right)={|{a}_{11}|}^{2}={|-i/\sqrt{2}|}^{2}=1/2\end{array}$

## Initial state

A standard quantum computer initializes its qubits as independent quantum states with probability amplitudes of 1 for returning 0 and 0 for returning 1:

$\left[\begin{array}{c}1\\ 0\end{array}\right]$

This effectively causes all qubits to always return 0 if immediately read.

## System scaling

Quantum states can be combined as a single quantum state in order to operate on qubits between them. This is done by calculating the Kronecker product of the quantum states:

$\left[\begin{array}{c}1\\ 0\end{array}\right]\otimes \left[\begin{array}{c}1\\ 0\end{array}\right]=\left[\begin{array}{c}1\\ 0\\ 0\\ 0\end{array}\right]$

Note that two groups of different qubits sharing a quantum state are entangled if and only if they cannot be described as independent quantum states.

## Quantum gates

While classical computers uses logic gates to operate on bits, quantum computers uses quantum gates to operate on qubits. A quantum gate can be represented as a unitary matrix of side length of 2 to the power of the number of qubits it operates on.

The effect of a quantum gate is calculated by multiplying the quantum gate matrix with the quantum state of the qubit set going through it. The result is a new quantum state.

Here is an example of a 1-qubit quantum gate applied on an initial quantum state to make it always return 1:

$\begin{array}{c}X=\left[\begin{array}{cc}0& 1\\ 1& 0\end{array}\right]\\ X\left[\begin{array}{c}1\\ 0\end{array}\right]=\left[\begin{array}{cc}0& 1\\ 1& 0\end{array}\right]\left[\begin{array}{c}1\\ 0\end{array}\right]=\left[\begin{array}{c}0\\ 1\end{array}\right]\end{array}$

In the case where a quantum gate operates on a subset of the total number of entangled qubits, the Kronecker product can again be used to expand the quantum gate matrix with a 2 by 2 identity matrix per qubit. This allows quantum computers to execute some programs significantly faster on average than what is possible on classical computers, since the execution time to apply a specific quantum gate instruction is constant.

For example, here is a 2-qubit quantum gate that reverses the least significant qubit's output only if the most significant qubit would return 1. It is expanded as a 3-qubit operator in a way that applies the gate on the two most significant qubits. It is then applied on a quantum state that always returns 100 to make it always return 110 instead:

$\begin{array}{c}\mathit{CNOT}=\left[\begin{array}{cccc}1& 0& 0& 0\\ 0& 1& 0& 0\\ 0& 0& 0& 1\\ 0& 0& 1& 0\end{array}\right]\\ \left(\mathit{CNOT}\otimes {I}_{2}\right)\left[\begin{array}{c}0\\ 0\\ 0\\ 0\\ 1\\ 0\\ 0\\ 0\end{array}\right]=\left(\left[\begin{array}{cccc}1& 0& 0& 0\\ 0& 1& 0& 0\\ 0& 0& 0& 1\\ 0& 0& 1& 0\end{array}\right]\otimes \left[\begin{array}{cc}1& 0\\ 0& 1\end{array}\right]\right)\left[\begin{array}{c}0\\ 0\\ 0\\ 0\\ 1\\ 0\\ 0\\ 0\end{array}\right]=\left[\begin{array}{c}0\\ 0\\ 0\\ 0\\ 0\\ 0\\ 1\\ 0\end{array}\right]\end{array}$

Note that a quantum gate's matrix may require a change of basis (through standard linear algebra) if the order of qubits we want to operate on do not match those of the quantum state. This also applies for expanded quantum gate matrices.

## Programming

After considering the limitations of the architecture of the quantum computer used, the only thing left is to write a desired quantum program in a compatible programming language, just like any classical program,

Here is an example of a program written in IBM's QASM assembly language:

//IBMQASM 1.1
qreg q,5;
gate h, [[0.7071067811865476,0.7071067811865476],[0.7071067811865476,-0.7071067811865476]];
gate cx, [[1,0,0,0],[0,1,0,0],[0,0,0,1],[0,0,1,0]];
h q[1];
cx q[1], q[2];
measure q[1];
measure q[2];


This example sets two qubits in a popular quantum state (the Bell state) before measuring them. The expected output is 00 with 1/2 probability and 11 with 1/2 probability.

## Hardware errors

One major problem in current quantum computers is the instability of qubits, and the process of error injections in a quantum state is called decoherence. In addition, qubit measurement devices also have error biases as well.

Until technology is perfected to reduce these errors to a trivial level, a quantum programmer should take into consideration error probabilities of the computer's architecture, and apply error correction algorithms to its programs when necessary.

Describing a mixed state of probabilities due to these error sources can be done with a density matrix, which is out of scope of this post.

## To be continued?

I hope that my explanation was clear enough for you to be able to design your own quantum programs. Quantum programming is a young science so there's still plenty to discover, but you may want to look at some existing quantum algorithms for inspiration.

Special thanks to the entire IBM Quantum staff for introducing me to quantum computers and answering my technical questions!

## Bonus content!

### bra-ket notation

During my research, I often stumbled on quantum states defined in bra-ket notation. Here is what you should know if you would like to read other sources on the subject.

By definition:

$\begin{array}{c}\mathit{bra}\mathrm{:}⟨x|\\ \mathit{ket}\mathrm{:}|x⟩\\ \\ |0⟩=\left[\begin{array}{c}1\\ 0\end{array}\right]\\ |1⟩=\left[\begin{array}{c}0\\ 1\end{array}\right]\\ |+⟩=\frac{1}{\sqrt{2}}\left[\begin{array}{c}1\\ 1\end{array}\right]\\ |-⟩=\frac{1}{\sqrt{2}}\left[\begin{array}{c}1\\ -1\end{array}\right]\\ |+i⟩=\frac{1}{\sqrt{2}}\left[\begin{array}{c}1\\ i\end{array}\right]\\ |-i⟩=\frac{1}{\sqrt{2}}\left[\begin{array}{c}1\\ -i\end{array}\right]\\ \\ ⟨x|={|x⟩}^{H}={\stackrel{¯}{|x⟩}}^{T}\\ ⟨x|y⟩=⟨x||y⟩\\ |x⟩|y⟩=|x⟩\otimes |y⟩\\ |\mathit{xy}⟩=|x⟩\otimes |y⟩\end{array}$

One big advantage of this notation is to be able to perform the following decomposition of any quantum state, which can help designing and analyzing programs:

$\left[\begin{array}{c}{a}_{0\cdots 000}\\ {a}_{0\cdots 001}\\ {a}_{0\cdots 010}\\ {a}_{0\cdots 011}\\ ⋮\\ {a}_{1\cdots 111}\end{array}\right]=\sum _{k}{a}_{k}|k⟩$

### Common quantum gates

Note that the U gate below is an implementation of the universal unitary quantum gate.

$\begin{array}{c}X=\left[\begin{array}{cc}0& 1\\ 1& 0\end{array}\right]\\ Z=\left[\begin{array}{cc}1& 0\\ 0& -1\end{array}\right]\\ Y=\left[\begin{array}{cc}0& -i\\ i& 0\end{array}\right]\\ H=\frac{1}{\sqrt{2}}\left[\begin{array}{cc}1& 1\\ 1& -1\end{array}\right]\\ S=\left[\begin{array}{cc}1& 0\\ 0& i\end{array}\right]\\ {S}^{†}=\left[\begin{array}{cc}1& 0\\ 0& -i\end{array}\right]\\ T=\left[\begin{array}{cc}1& 0\\ 0& \frac{1+i}{\sqrt{2}}\end{array}\right]\\ {T}^{†}=\left[\begin{array}{cc}1& 0\\ 0& \frac{1-i}{\sqrt{2}}\end{array}\right]\\ \mathit{CNOT}=\left[\begin{array}{cccc}1& 0& 0& 0\\ 0& 1& 0& 0\\ 0& 0& 0& 1\\ 0& 0& 1& 0\end{array}\right]\\ \\ P\left(\lambda \right)=\left[\begin{array}{cc}1& 0\\ 0& {e}^{i\lambda }\end{array}\right]\\ \mathit{RZ}\left(\lambda \right)=\left[\begin{array}{cc}{e}^{-i\lambda /2}& 0\\ 0& {e}^{i\lambda /2}\end{array}\right]\\ U\left(\theta ,\varphi ,\lambda \right)=\left[\begin{array}{cc}\mathrm{cos}\left(\frac{\theta }{2}\right)& -{e}^{i\lambda }\mathrm{sin}\left(\frac{\theta }{2}\right)\\ {e}^{i\varphi }\mathrm{sin}\left(\frac{\theta }{2}\right)& {e}^{i\left(\lambda +\varphi \right)}\mathrm{cos}\left(\frac{\theta }{2}\right)\end{array}\right]\end{array}$

You may also want to refer to the full list of quantum gates supported by the IBM Quantum Experience.

### Gate equivalences

Note that 𝜏 = 2𝜋.

$\begin{array}{c}\mathit{XZ}=Y\\ \\ T=P\left(\frac{\tau }{8}\right)\\ {T}^{2}=S\\ {T}^{4}=Z\\ {T}^{6}={S}^{†}\\ {T}^{7}={T}^{†}\\ {T}^{8}={I}_{2}\\ \\ P\left(\lambda \right)={e}^{i\lambda /2}\mathit{RZ}\left(\lambda \right)\\ P\left(\lambda \right)=U\left(0,0,\lambda \right)\end{array}$

## Validating and Viewing OpenAPI Definitions with Docker

- Quality Assurance, Programming

Here are a few commands I crafted to validate and easily read API definitions in the OpenAPI format, using Docker and open source tools provided by Swagger. I have yet to convert them into proper shell scripts, but I hope these will be helpful nonetheless. The commands are designed to be run in a…

## Essential International Standards and Registries for Web Developers

- Programming, Quality Assurance, Security

The following is a collection of free international standards, registries and references that I collected throughout the years while developing websites and web services. These references, while very precise and technical by their nature, are extremely useful in order to ensure that a specific…

## A Universe and World Creation Script for Mongoose Traveller 2nd Edition

- Tabletop RPGs, Programming

The following is a Python script developed by yours truly to generate a sector according to the core rulebook of the Mongoose Traveller 2nd Edition tabletop RPG, exactly as described in the Universe and World Creation chapter. It is designed to describe worlds in human-readable format as much as…

## Deep Learning in Python with PyTorch - Tutorial and Demo

- Programming, Mathematics

As I am continuing my personal journey into deep learning research and development, I wanted to try out PyTorch, a machine learning framework with GPU acceleration primarily designed for the Python programming language. However, I couldn't find any good introductory resource online for it. So I read…