Challenges
Datasets
Workspaces
Papers
Discussions
Leaderboard
Log inSign up
Challenges
Datasets
Workspaces
Papers
Discussions
Leaderboard
Blog
Job Board
Q3AS

© 2026 Aqora Quantum S.A.S.

TermsPrivacyLegal Notice

arXiv:2510.00895 · ACM Transactions on Quantum Computing

Visualizing Quantum Circuits: State Vector Difference Highlighting and the Half-Matrix

Michael J. McGuffin, Jean–Marc Robert

Published Mar 18, 2026• 1 citation
arXivHTMLPDF

Abstract

Existing graphical user interfaces for circuit simulators often show small visual summaries of the reduced state of each qubit, showing the probability, phase, purity, and/or Bloch sphere coordinates associated with each qubit. These necessarily provide an incomplete picture of the quantum state of the qubits, and can sometimes be confusing for students or newcomers to quantum computing. We contribute two novel visual approaches to provide more complete information about small circuits. First, to complement information about each qubit, we show the complete state vector, and illustrate the way that amplitudes change from layer-to-layer under the effect of different gates, by using a small set of colors, arrows, and symbols. We call this “state vector difference highlighting”, and show how it elucidates the effect of Hadamard, X, Y, Z, S, T, Phase, and SWAP gates, where each gate may have an arbitrary combination of control and anticontrol qubits. Second, we display pairwise information about qubits (such as concurrence and correlation) in a triangular “half-matrix” visualization. Our open source software implementation, called MuqcsCraft, is available as a live online demonstration that runs in a web browser without installing any additional software, allowing a user to define a circuit through drag-and-drop actions, and then simulate and visualize it.

DOI
10.1145/3786463

Related papers

QCVis: A Quantum Circuit Visualization and Education Platform for Novices

Milan Marie Williams

QCVis is a quantum circuit visualization and education platform for novices. The rapid growth of the quantum computing field surpasses the educational capacity of existing systems, which makes novices particularly in need of accessible tools. Often, novices struggle to understand two fundamental concepts: how quantum gates affect both qubit and quantum circuit state probabilities over time. QCVis contributes two novel visualizations to develop this intuition. One visualization teaches users about the relationship between gates and single qubit probabilities. This feature integrates stacked bar charts into the traditional quantum circuit diagram to display the state probability of a single qubit after each gate application. The other visualization provides insight into the intermediate steps that contribute to the final state probability distribution. The combination of a radial bar chart and a time slider helps users see the state probability of a quantum circuit at a user-specified execution step and observe how it changes over time. We evaluated the design of QCVis in a user study with novices, who successfully used our interface to understand these key quantum computing concepts.

•Jun 3, 2021•3 citations

How to write a simulator for quantum circuits from scratch: A tutorial

Michael J. McGuffin, Jean-Marc Robert, Kazuki Ikeda

We guide a competent programmer through the programming of a quantum circuit simulator, supporting quantum logic gates with arbitrary control qubits on 20+ qubits, assuming no previous knowledge of quantum computing. We explain qubit-wise multiplication for updating the state vector; how to compute partial traces on arbitrary subsets of qubits to find reduced density matrices; and computing qubit phase and purity. A sample implementation in JavaScript is provided, which also demonstrates how to compute von Neumann entropy, concurrence (to quantify entanglement), and magic, with source code much smaller and easier to study than other popular software packages.

arXiv:2506.08142•SciPost Physics Lecture Notes•Aug 3, 2026•5 citations

A Streamlit-powered System for Simulating and Visualizing Qubit States

thirupathi

Abstract Quantum computing utilizes the concepts of quantum mechanics, including superposition and entanglement, to execute calculations that are impractical for traditional computers. Central to this approach is the qubit, a quantum equivalent of the traditional bit, capable of being in a superposition of states. Nonetheless, the conceptual essence of quantum states renders them hard to visualize and comprehend, particularly for students and professionals who are unfamiliar with the domain. To tackle this issue, we created an interactive qubit visualization tool using Streamlit, enabling real-time exploration of qubit behavior under quantum operations.The app enables users to control qubit states directly by modifying the real and imaginary components of probability amplitudes, guaranteeing the normalization of the state vector. It also incorporates a set of essential quantum gates, including Hadamard, Pauli-X, Pauli-Y, and Pauli-Z, as well as continuous rotation gates (Rx, Ry, Rz). In contrast to distinct button-driven functions, the rotation gates are implemented dynamically via angle sliders, enabling users to witness seamless, real-time updates to the qubit state. This provides an intuitive understanding of qubit evolution as it revolves around the Bloch sphere axes.The tool displays the outcomes in both numerical and graphical formats. Users are able to observe the quantum state vector, as well as the probabilities of obtaining |0⟩ and |1⟩, and visual depictions through probability bar charts and Bloch sphere visualizations. By providing a live, interactive setting, this platform connects the divide between mathematical theory and conceptual grasp of quantum mechanics. It functions as both a learning tool for students and a prototyping support for researchers, rendering quantum computation more approachable and captivating.

•Sep 11, 2025•4 citations

Diagrams of States in Quantum Information: an Illustrative Tutorial

Sara Felloni, Alberto Leporati, G. Strini

We present "Diagrams of States", a way to graphically represent and analyze how quantum information is elaborated during the execution of quantum circuits. This introductory tutorial illustrates the basics, providing useful examples of quantum computations: elementary operations in single-qubit, two-qubit and three-qubit systems, immersions of gates on higher dimensional spaces, generation of single and multi-qubit states, procedures to synthesize unitary, controlled and diagonal matrices. To perform the analysis of quantum processes, we directly derive diagrams of states from physical implementations of quantum circuits associated to the processes. Complete diagrams are then rearranged into simplified diagrams, to visualize the overall effects of computations. Conversely, diagrams of states help to conceive new quantum algorithms, by schematically describing desired manipulations of quantum information with intuitive diagrams and then by guessing the equivalent complete diagrams, from which the corresponding quantum circuit is obtained effortlessly. Related examples and analysis of complex algorithms will be provided in future works, for whose comprehension this first tutorial offers the necessary introduction.

arXiv:0904.2656•Apr 17, 2009•7 citations

Simulation and Analysis of Bell States via Qiskit Quantum Circuits

Mounaim Hamdoune, Mohammed Daoud A

Abstract The visualization of qubit states plays a fundamental role in understanding quantum information processing. This study explores the use of the Bloch sphere as a geometrical tool for representing and interpreting single-qubit and two-qubit states. Using the Qiskit framework, we simulate quantum circuits to demonstrate the action of quantum gates and the generation of entangled states, such as Bell states. The effects of various gate operations on qubit orientation are analyzed in the Bloch sphere representation. Furthermore, we examine the matrix formalism of quantum states and provide a statistical analysis of measurement outcomes. This work bridges the gap between theoretical quantum mechanics and experimental simulation, offering insights for both educational and research purposes in quantum computing.

•Aug 26, 2025•0 citations

Quantum State Visualizer: An Interactive Tool for Multi-Qubit System Analysis Using Partial Trace and Bloch Sphere Representation

Subhashini Medida, Sai Lakshmi Durga Ankam, Pardha Saradhi Patharlapalli +3 more

Quantum state visualisation remains a significant challenge in quantum computing education and research due to the abstract mathematical properties of quantum mechanics. This paper presents a new Quantum State Visualiser, an interactive web app that tries to bridge the gap between theoretical quantum mechanics and real-world understanding. The proposed solution operates with multi-qubit quantum circuits, employing partial trace operations to derive single-qubit reduced density matrices, which are then depicted as dynamic 3D Bloch sphere representations. The tool helps you understand abstract ideas like superposition, entanglement, and quantum interference by turning hard math into easy-to-understand pictures. This is useful for students, teachers, researchers, and people who work on quantum computers.The prototype uses Qiskit for quantum Traditional quantum co simulation, Python for computational backends, and modern web technologies for interactive visualisation. The system can accurately show quantum states in real time, which means that circuit changes get instant visual feedback. The new thing is that it combines quantum simulation in real time with 3D visualisation that you can interact with. This creates a fun place to learn that helps people understand quantum phenomena faster. This tool fills a big gap in education and could be used in schools, to fix problems with quantum algorithms, and to make quantum circuits work better. In the future, it will be possible to work with bigger qubit systems, connect it to quantum hardware platforms, and add features for augmented reality visualisation

•Jul 27, 2026•0 citations
Existing graphical user interfaces for circuit simulators often show small visual summaries of the reduced state of each qubit, showing the probability, phase, purity, and/or Bloch sphere coordinates associated with each qubit. These necessarily provide an incomplete picture of the quantum state of the qubits, and can sometimes be confusing for students or newcomers to quantum computing. We contribute two novel visual approaches to provide more complete information about small circuits. First, to complement information about each qubit, we show the complete state vector, and illustrate the way that amplitudes change from layer-to-layer under the effect of different gates, by using a small set of colors, arrows, and symbols. We call this “state vector difference highlighting”, and show how it elucidates the effect of Hadamard, X, Y, Z, S, T, Phase, and SWAP gates, where each gate may have an arbitrary combination of control and anticontrol qubits. Second, we display pairwise information about qubits (such as concurrence and correlation) in a triangular “half-matrix” visualization. Our open source software implementation, called MuqcsCraft, is available as a live online demonstration that runs in a web browser without installing any additional software, allowing a user to define a circuit through drag-and-drop actions, and then simulate and visualize it.
QCVis is a quantum circuit visualization and education platform for novices. The rapid growth of the quantum computing field surpasses the educational capacity of existing systems, which makes novices particularly in need of accessible tools. Often, novices struggle to understand two fundamental concepts: how quantum gates affect both qubit and quantum circuit state probabilities over time. QCVis contributes two novel visualizations to develop this intuition. One visualization teaches users about the relationship between gates and single qubit probabilities. This feature integrates stacked bar charts into the traditional quantum circuit diagram to display the state probability of a single qubit after each gate application. The other visualization provides insight into the intermediate steps that contribute to the final state probability distribution. The combination of a radial bar chart and a time slider helps users see the state probability of a quantum circuit at a user-specified execution step and observe how it changes over time. We evaluated the design of QCVis in a user study with novices, who successfully used our interface to understand these key quantum computing concepts.
We guide a competent programmer through the programming of a quantum circuit simulator, supporting quantum logic gates with arbitrary control qubits on 20+ qubits, assuming no previous knowledge of quantum computing. We explain qubit-wise multiplication for updating the state vector; how to compute partial traces on arbitrary subsets of qubits to find reduced density matrices; and computing qubit phase and purity. A sample implementation in JavaScript is provided, which also demonstrates how to compute von Neumann entropy, concurrence (to quantify entanglement), and magic, with source code much smaller and easier to study than other popular software packages.
Abstract Quantum computing utilizes the concepts of quantum mechanics, including superposition and entanglement, to execute calculations that are impractical for traditional computers. Central to this approach is the qubit, a quantum equivalent of the traditional bit, capable of being in a superposition of states. Nonetheless, the conceptual essence of quantum states renders them hard to visualize and comprehend, particularly for students and professionals who are unfamiliar with the domain. To tackle this issue, we created an interactive qubit visualization tool using Streamlit, enabling real-time exploration of qubit behavior under quantum operations.The app enables users to control qubit states directly by modifying the real and imaginary components of probability amplitudes, guaranteeing the normalization of the state vector. It also incorporates a set of essential quantum gates, including Hadamard, Pauli-X, Pauli-Y, and Pauli-Z, as well as continuous rotation gates (Rx, Ry, Rz). In contrast to distinct button-driven functions, the rotation gates are implemented dynamically via angle sliders, enabling users to witness seamless, real-time updates to the qubit state. This provides an intuitive understanding of qubit evolution as it revolves around the Bloch sphere axes.The tool displays the outcomes in both numerical and graphical formats. Users are able to observe the quantum state vector, as well as the probabilities of obtaining |0⟩ and |1⟩, and visual depictions through probability bar charts and Bloch sphere visualizations. By providing a live, interactive setting, this platform connects the divide between mathematical theory and conceptual grasp of quantum mechanics. It functions as both a learning tool for students and a prototyping support for researchers, rendering quantum computation more approachable and captivating.
We present "Diagrams of States", a way to graphically represent and analyze how quantum information is elaborated during the execution of quantum circuits. This introductory tutorial illustrates the basics, providing useful examples of quantum computations: elementary operations in single-qubit, two-qubit and three-qubit systems, immersions of gates on higher dimensional spaces, generation of single and multi-qubit states, procedures to synthesize unitary, controlled and diagonal matrices. To perform the analysis of quantum processes, we directly derive diagrams of states from physical implementations of quantum circuits associated to the processes. Complete diagrams are then rearranged into simplified diagrams, to visualize the overall effects of computations. Conversely, diagrams of states help to conceive new quantum algorithms, by schematically describing desired manipulations of quantum information with intuitive diagrams and then by guessing the equivalent complete diagrams, from which the corresponding quantum circuit is obtained effortlessly. Related examples and analysis of complex algorithms will be provided in future works, for whose comprehension this first tutorial offers the necessary introduction.
Abstract The visualization of qubit states plays a fundamental role in understanding quantum information processing. This study explores the use of the Bloch sphere as a geometrical tool for representing and interpreting single-qubit and two-qubit states. Using the Qiskit framework, we simulate quantum circuits to demonstrate the action of quantum gates and the generation of entangled states, such as Bell states. The effects of various gate operations on qubit orientation are analyzed in the Bloch sphere representation. Furthermore, we examine the matrix formalism of quantum states and provide a statistical analysis of measurement outcomes. This work bridges the gap between theoretical quantum mechanics and experimental simulation, offering insights for both educational and research purposes in quantum computing.
Quantum state visualisation remains a significant challenge in quantum computing education and research due to the abstract mathematical properties of quantum mechanics. This paper presents a new Quantum State Visualiser, an interactive web app that tries to bridge the gap between theoretical quantum mechanics and real-world understanding. The proposed solution operates with multi-qubit quantum circuits, employing partial trace operations to derive single-qubit reduced density matrices, which are then depicted as dynamic 3D Bloch sphere representations. The tool helps you understand abstract ideas like superposition, entanglement, and quantum interference by turning hard math into easy-to-understand pictures. This is useful for students, teachers, researchers, and people who work on quantum computers.The prototype uses Qiskit for quantum Traditional quantum co simulation, Python for computational backends, and modern web technologies for interactive visualisation. The system can accurately show quantum states in real time, which means that circuit changes get instant visual feedback. The new thing is that it combines quantum simulation in real time with 3D visualisation that you can interact with. This creates a fun place to learn that helps people understand quantum phenomena faster. This tool fills a big gap in education and could be used in schools, to fix problems with quantum algorithms, and to make quantum circuits work better. In the future, it will be possible to work with bigger qubit systems, connect it to quantum hardware platforms, and add features for augmented reality visualisation