Skip to content

Visualization of Quantum Programs

The Classiq analyzer application helps you visualize and analyze quantum programs. The input to the application is a quantum program synthesized by the Classiq synthesis engine, or an OpenQASM quantum program.

Accessing the Quantum Program Visualization Tool

There are 3 ways to view a quantum program using the visualization tool:

  • Through the Classiq Python SDK

  • Direct access via the Classiq IDE

  • Direct access via the Classiq Studio

Classiq Python SDK

  • Synthesize your model using synthesize() to obtain a quantum program, and pass it as a parameter to the function show(). Here is an example with a trivial model:
from classiq import qfunc, Output, QBit, synthesize, show, allocate


@qfunc
def main(res: Output[QBit]) -> None:
    allocate(1, res)


qprog = synthesize(main)
show(qprog)

Direct Access

  • Synthesizing a quantum program using the IDE https://platform.classiq.io/synthesis automatically redirects you to the visualization tool.
  • Upload (drag and drop) a file that contains a quantum program synthesized using the Classiq engine (either synthesized and downloaded from the IDE or obtained from the python SDK using qprog.save_result("file-name")) into https://platform.classiq.io/circuit/.

upload_qp

Visualization in the Classiq Studio

  • Follow the same steps as in Classiq Python SDK. The visualization tool can be directly rendered in the notebook:

studio_vis

Using Visualization Tool

The Quantum Program visualization bridges the high-level algorithm descriptions (as it is captured in Qmod) with their quantum implementations (as synthesized by the Classiq engine). The tool offers two key innovations: functional block hierarchies and quantum data flow representations.

The quantum data flow view lets users track quantum variables, including higher-level types like numbers, arrays, and structs, along with their qubit allocations. This aids in understanding data flow and memory allocation within quantum algorithms.

Functional block hierarchies enable navigation between different levels of abstraction, from high-level functional blocks to individual quantum gates, offering a more thorough exploration of the algorithm's structure.

The QP visualization tool provides an interactive way to analyze quantum programs by focusing on the quantum data-flow between functional blocks. Here’s a breakdown of its key features and functionality:

Purpose

  • Analyze the implementation of the quantum model (Qmod) as synthesized by the Classiq engine.
  • Verify the data flow within the quantum program, enabling debugging and deeper analysis

Hierarchical Structure

  • Allows users to traverse different levels of the quantum model implementation, from high-level Qmod functions down to atomic functions.

    Double clicking a function block opens and collapses the internal hierarchies:

hierarchies

Color Coding

The visualization uses colors to help distinguish different block categories:

  • Yellow: Represents Qmod function blocks (either written by the user or taken from the Classiq library).
  • Turquoise: Represents Qmod statement blocks (such as: control, invert, power, within-apply, assignment).
  • Grey: Represents built-in functional blocks (generated by the Classiq engine during synthesis).

Data Flow Analysis

Data flow between functional blocks is presented in terms of the Qmod variables:

  • Purple lines represent the flow of quantum variables throughout the program.
  • The purple dot marks where a variable is initialized.
  • When variables split or merge (via slicing or the bind operation), the purple lines update to show the changes.
  • The variable’s name and size are also displayed along the purple lines, making it easier to track their initialization, usage and transformations.

This structured approach allows for a clear understanding of the program’s execution, providing users with a tool to validate the accuracy and efficiency of their quantum programs.

Task Bar

On the top right is the analyzer task bar:

taskbar

The taskbar contain several groups of buttons, arranged from left to right:

  1. Search tool: Allows you to search through the building blocks of a quantum program to quickly locate specific elements.
  2. Hierarchical View: Provides options to expand all functions and gates, revealing the most detailed level of analysis for the quantum gates used in your algorithm. You can also collapse everything to return to the original, simplified view displayed when the quantum program was first loaded, where a single bar represents the entire algorithm.
  3. Navigation and Zoom: This group includes map controls for navigating across different parts of the quantum program chart, enabling you to focus on gates and functions that are currently outside the visible area. It also includes zoom controls to:
    • Reset the chart to its default scale (currently 90%),
    • Zoom out,
    • Adjust the zoom level manually,
    • Or zoom in for a closer view.

Variables View

Within the Quantum Program page you can also toggle the Variables View option:

toggle_versions

Variables View provides a simplified, high-level visualization of how quantum data flows through a program. Instead of showing individual qubits, it highlights logical quantum variables and their transformations, making it easier to understand complex algorithms and trace data flow across different parts of the program. As quantum algorithms increase in scale and sophistication, traditional visualization techniques become cluttered and difficult to interpret, making it difficult to see the bigger picture. Classiq Qmod language addresses this by allowing users to design algorithms using high-level elements organized into modular functional blocks. Building on this, Variables View focuses on the logical units, making complex workflows far easier to follow.

In the example below, the Variables View shows a simplified implementation of the discrete logarithm algorithm [1]. Notice how purple lines trace the flow of logical variables, with dots indicating initialization points. As the algorithm progresses, variables are split and merged, providing an intuitive understanding of the quantum algorithm.

variables_view

Sharing your Quantum Program Visualization

You can easily share your Quantum Program visualization with anyone, even those who haven’t signed up for the Classiq platform. It’s simple:

  • Copy the Quantum Program URL directly from your browser and share it.
  • Alternatively, click the "Share" button on the Quantum Program page, choose a social media to share in or copy the generated link, and share it with anyone.

qp_sharing_link

[1]: Michael A. Nielsen and Isaac L. Chuang. 2011. Quantum Computation and Quantum Information: 10th Anniversary Edition, Cambridge University Press, New York, NY, USA.