⚛️ 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.

---