Document feedback

Question document fragment

When a question document fragment contains a formula, it is displayed as a space.

Submission type

issue

It's a little complicated...

I'd like to ask someone.

Please select the submission type

Problem type

Specifications and Common Mistakes

- Specifications and Common Mistakes:

- Misspellings or punctuation mistakes,incorrect formulas, abnormal display.

- Incorrect links, empty cells, or wrong formats.

- Chinese characters in English context.

- Minor inconsistencies between the UI and descriptions.

- Low writing fluency that does not affect understanding.

- Incorrect version numbers, including software package names and version numbers on the UI.

Usability

- Usability:

- Incorrect or missing key steps.

- Missing main function descriptions, keyword explanation, necessary prerequisites, or precautions.

- Ambiguous descriptions, unclear reference, or contradictory context.

- Unclear logic, such as missing classifications, items, and steps.

Correctness

- Correctness:

- Technical principles, function descriptions, supported platforms, parameter types, or exceptions inconsistent with that of software implementation.

- Incorrect schematic or architecture diagrams.

- Incorrect commands or command parameters.

- Incorrect code.

- Commands inconsistent with the functions.

- Wrong screenshots.

- Sample code running error, or running results inconsistent with the expectation.

Risk Warnings

- Risk Warnings:

- Lack of risk warnings for operations that may damage the system or important data.

Content Compliance

- Content Compliance:

- Contents that may violate applicable laws and regulations or geo-cultural context-sensitive words and expressions.

- Copyright infringement.

Please select the type of question

Problem description

Describe the bug so that we can quickly locate the problem.

Submit

Document feedback

Bloch Sphere

     

Single-qubit State

Unlike classical bits, qubits can be in both the computational basis vector $|0⟩$ state and the $|1⟩$ state, usually expressed as

$$|\psi ⟩=a|0⟩+b|1⟩$$

Here $a$ and $b$ are complex numbers. Due to the normalization condition of the quantum state $⟨\psi |\psi ⟩=1$, therefore

$${\left|a\right|}^2+{\left|b\right|}^2=1$$

For a two-dimensional Hilbert space, we can make the following mapping of the computational basis vector

$$\begin{array}{r}|0⟩=\left(\begin{array}{c}1\\ 0\end{array}\right),|1⟩=\left(\begin{array}{c}0\\ 1\end{array}\right)\end{array}$$

Thus, any single-qubit state can be expressed as

$$\begin{array}{r}|\psi ⟩=\left(\begin{array}{c}a\\ b\end{array}\right)\end{array}$$

In the general case, we do not care about the global phase, so we can assume $a=\cos \left(\theta /2\right),b=e^{i\varphi }\sin \left(\theta /2\right)$：

$$|\psi ⟩=\cos \left(\theta /2\right)|0⟩+e^{i\varphi }\sin \left(\theta /2\right)|1⟩$$

Here we might as well represent that arbitrary quantum state in the unit ball, as follows, taking $\theta$ and $\varphi$ as the elevation and azimuth angles, respectively.

Next we will show how to demonstrate a single-qubit state in MindSpore Quantum and the evolution of the single-qubit state in the form of an animation.

Importing Related Modules

from mindquantum.core.circuit import Circuit
from mindquantum.core.gates import RX, RZ
from mindquantum.io.display import BlochScene

In order to dynamically display quantum states in Jupyter Notebook, we need to run the following command.

%matplotlib ipympl

Building Quantum Circuit

From the above bloch sphere, we can control the elevation angle $\theta$ by the revolving gate RX and the azimuth angle $\varphi$ by RZ. Therefore, we can build the following quantum circuit.

circ = Circuit()               # Build circuit for preparing an arbitrary single-qubit quantum state
circ += RX('theta').on(0)      # Control elevation via RX gate
circ += RZ('phi').on(0)        # Control azimuth via RZ gate
circ.svg()

Here we might as well take $\theta =\pi /4,\varphi =\pi /4$ and calculate the corresponding quantum state.

import numpy as np

state1 = circ.get_qs(pr={'theta': np.pi/4, 'phi': np.pi/4})
print(state1)

[0.85355339-0.35355339j 0.14644661-0.35355339j]

Displaying the Quantum State

In MindSpore Quantum, BlochScene is the module used to display the Bloch sphere. We can add as many single-qubit states as we want to the BlochScene and also animate the evolution of the single-qubit quantum states.

scene = BlochScene()                       # Create Bloch drawing scene
fig, ax = scene.create_scene()             # Initialize the scene
state_obj1 = scene.add_state(ax, state1)   # Add a quantum state to the scene

In addition, we can also show the Bloch sphere in dark mode, as follows.

scene = BlochScene('dark')                       # Create Bloch drawing scene
fig, ax = scene.create_scene()                   # Initialize the scene
state_obj1 = scene.add_state(ax, state1)         # Add a quantum state to the scene

Displaying the Evolution of the Quantum State

We can also create animations in the Bloch scene when the quantum state is a time-dependent quantum state. Here we may assume that the elevation $\theta$ and azimuthal $\varphi$ are time-dependent and we can obtain the quantum states for all time.

t = np.linspace(0, 10, 500)
all_theta = 4 * np.sin(2 * t)
all_phi = 5 * np.cos(3 * t)
states = []
for theta, phi in zip(all_theta, all_phi):
    states.append(circ.get_qs(pr={'theta': theta, 'phi': phi}))
states = np.array(states)

In the following, we create a dark Bloch scene and initialize the scene with the first one of the evolved quantum states.

scene = BlochScene('dark')                          # Create Bloch drawing scene
fig, ax = scene.create_scene()                      # Initialize the scene
state_obj = scene.add_state(ax, states[0])          # Add a quantum state to the scene

To be able to display dynamically the evolution of quantum states, we create an animated object from the Bloch scene.

anim = scene.animation(fig, ax, state_obj, states)

From this, we can see that the quantum state of a single qubit has moved in the Bloch sphere.

from mindquantum.utils.show_info import InfoTable

InfoTable('mindquantum', 'scipy', 'numpy')

Software	Version
mindquantum	0.9.11
scipy	1.10.1
numpy	1.24.4
System	Info
Python	3.8.17
OS	Linux x86_64
Memory	16.62 GB
CPU Max Thread	16
Date	Tue Jan 2 14:38:36 2024