Skip to content

README.md

Latest commit

 

History

History
85 lines (66 loc) · 2.68 KB

README.md

File metadata and controls

85 lines (66 loc) · 2.68 KB
Raw

⚛️ Custom Quantum Gates Simulation

A Streamlit-powered interactive platform to design, simulate, and visualize custom quantum circuits using Qiskit.

📌 Overview

This repository provides a Quantum Circuit Simulation Tool built with Qiskit, Matplotlib, and Streamlit. It allows users to define algorithms in plain text, automatically parse them into quantum circuits, and visualize the simulation results.

✨ Key Features

  • 🖥️ Interactive GUI – Built with Streamlit for seamless user experience.
  • ⚛️ Custom Gate Parsing – Supports Hadamard, Pauli (X, Y, Z), CNOT, and rotation gates (RX, RY, RZ).
  • 📊 Simulation Engine – Uses Qiskit Sampler to evaluate quantum states and probabilities.
  • 📈 Visual Output – Generates bar charts and plots of quantum state distributions.
  • 🔍 Efficiency Metrics – Displays circuit depth as a measure of computational efficiency.
  • 📷 Image Export – Saves simulation results as JPEG for easy sharing and documentation.

🛠️ Tech Stack

  • Languages: Python
  • Libraries: Qiskit, Matplotlib, PIL, Regex
  • Framework: Streamlit (for GUI)

⚙️ Usage

1️⃣ Run the Streamlit App

streamlit run main.py

2️⃣ Enter Algorithm Instructions

Provide quantum gate instructions in text format (semicolon-separated). Examples: 

H 0; CX 0 1; RX(1.57) 2; Measure All

3️⃣ Visualize Results

The app will:

  • Parse instructions into a QuantumCircuit
  • Simulate using Qiskit Sampler
  • Display probability distributions and circuit efficiency
  • Export results as simulation_result.jpeg

📂 Repository Structure

├── main.py                # Core simulation and Streamlit GUI
├── simulation_result.jpeg # Example output image
├── requirements.txt       # Dependencies
└── README.md              # Project documentation

🔮 Future Scope

  • 🤖 Advanced Gate Support – Add Toffoli, SWAP, and parameterized custom gates.
  • 📊 Enhanced Analytics – Provide fidelity, entanglement measures, and performance benchmarks.
  • 🎨 Interactive Visualizations – Real-time circuit diagrams with drag-and-drop gate placement.