quantum-debugger 0.1.1__py3-none-any.whl

quantum_debugger/visualization/state_viz.py

@@ -0,0 +1,205 @@
+"""
+Quantum state visualization
+"""
+
+import numpy as np
+import matplotlib.pyplot as plt
+from typing import Optional
+from quantum_debugger.core.quantum_state import QuantumState
+
+
+class StateVisualizer:
+    """Visualize quantum states"""
+    
+    @staticmethod
+    def plot_state_vector(state: QuantumState, show_phase: bool = True, 
+                         figsize: tuple = (12, 5)):
+        """
+        Plot state vector amplitudes and phases
+        
+        Args:
+            state: Quantum state to visualize
+            show_phase: Whether to show phase information
+            figsize: Figure size
+        """
+        probabilities = state.get_probabilities()
+        amplitudes = np.abs(state.state_vector)
+        phases = np.angle(state.state_vector)
+        
+        # Basis state labels
+        labels = [format(i, f'0{state.num_qubits}b') for i in range(state.dim)]
+        x = np.arange(state.dim)
+        
+        if show_phase:
+            fig, (ax1, ax2) = plt.subplots(1, 2, figsize=figsize)
+            
+            # Amplitudes
+            ax1.bar(x, amplitudes, color='steelblue', alpha=0.7)
+            ax1.set_xlabel('Basis State')
+            ax1.set_ylabel('Amplitude')
+            ax1.set_title('State Vector Amplitudes')
+            ax1.set_xticks(x)
+            ax1.set_xticklabels(labels, rotation=45, ha='right')
+            ax1.grid(True, alpha=0.3)
+            
+            # Phases
+            colors = plt.cm.hsv(phases / (2 * np.pi) + 0.5)
+            ax2.bar(x, amplitudes, color=colors, alpha=0.7)
+            ax2.set_xlabel('Basis State')
+            ax2.set_ylabel('Amplitude')
+            ax2.set_title('Phases (color-coded)')
+            ax2.set_xticks(x)
+            ax2.set_xticklabels(labels, rotation=45, ha='right')
+            ax2.grid(True, alpha=0.3)
+            
+        else:
+            fig, ax = plt.subplots(figsize=(figsize[0]//2, figsize[1]))
+            ax.bar(x, amplitudes, color='steelblue', alpha=0.7)
+            ax.set_xlabel('Basis State')
+            ax.set_ylabel('Amplitude')
+            ax.set_title('State Vector Amplitudes')
+            ax.set_xticks(x)
+            ax.set_xticklabels(labels, rotation=45, ha='right')
+            ax.grid(True, alpha=0.3)
+        
+        plt.tight_layout()
+        plt.show()
+    
+    @staticmethod
+    def plot_probabilities(state: QuantumState, figsize: tuple = (10, 6)):
+        """
+        Plot measurement probabilities
+        
+        Args:
+            state: Quantum state
+            figsize: Figure size
+        """
+        probabilities = state.get_probabilities()
+        labels = [format(i, f'0{state.num_qubits}b') for i in range(state.dim)]
+        x = np.arange(state.dim)
+        
+        plt.figure(figsize=figsize)
+        bars = plt.bar(x, probabilities, color='coral', alpha=0.7, edgecolor='darkred')
+        
+        # Highlight most probable states
+        max_prob = np.max(probabilities)
+        for i, (bar, prob) in enumerate(zip(bars, probabilities)):
+            if prob > max_prob * 0.9:
+                bar.set_color('darkred')
+                bar.set_alpha(0.9)
+        
+        plt.xlabel('Basis State', fontsize=12)
+        plt.ylabel('Probability', fontsize=12)
+        plt.title('Measurement Probabilities', fontsize=14, fontweight='bold')
+        plt.xticks(x, labels, rotation=45, ha='right')
+        plt.ylim(0, 1)
+        plt.grid(True, alpha=0.3, axis='y')
+        plt.tight_layout()
+        plt.show()
+    
+    @staticmethod
+    def plot_density_matrix(state: QuantumState, figsize: tuple = (10, 8)):
+        """
+        Plot density matrix representation
+        
+        Args:
+            state: Quantum state
+            figsize: Figure size
+        """
+        # Create density matrix
+        rho = np.outer(state.state_vector, state.state_vector.conj())
+        
+        fig, (ax1, ax2) = plt.subplots(1, 2, figsize=figsize)
+        
+        # Real part
+        im1 = ax1.imshow(np.real(rho), cmap='RdBu', vmin=-1, vmax=1)
+        ax1.set_title('Density Matrix (Real Part)')
+        ax1.set_xlabel('Basis State')
+        ax1.set_ylabel('Basis State')
+        plt.colorbar(im1, ax=ax1)
+        
+        # Imaginary part
+        im2 = ax2.imshow(np.imag(rho), cmap='RdBu', vmin=-1, vmax=1)
+        ax2.set_title('Density Matrix (Imaginary Part)')
+        ax2.set_xlabel('Basis State')
+        ax2.set_ylabel('Basis State')
+        plt.colorbar(im2, ax=ax2)
+        
+        plt.tight_layout()
+        plt.show()
+    
+    @staticmethod
+    def plot_qubit_probabilities(state: QuantumState, figsize: tuple = (10, 6)):
+        """
+        Plot per-qubit measurement probabilities
+        
+        Args:
+            state: Quantum state
+            figsize: Figure size
+        """
+        qubits = range(state.num_qubits)
+        prob_0 = []
+        prob_1 = []
+        
+        for q in qubits:
+            p0 = state.get_measurement_probability(q, 0)
+            p1 = state.get_measurement_probability(q, 1)
+            prob_0.append(p0)
+            prob_1.append(p1)
+        
+        x = np.arange(state.num_qubits)
+        width = 0.35
+        
+        fig, ax = plt.subplots(figsize=figsize)
+        ax.bar(x - width/2, prob_0, width, label='|0⟩', color='steelblue', alpha=0.8)
+        ax.bar(x + width/2, prob_1, width, label='|1⟩', color='coral', alpha=0.8)
+        
+        ax.set_xlabel('Qubit Index', fontsize=12)
+        ax.set_ylabel('Probability', fontsize=12)
+        ax.set_title('Per-Qubit Measurement Probabilities', fontsize=14, fontweight='bold')
+        ax.set_xticks(x)
+        ax.set_xticklabels([f'q{i}' for i in qubits])
+        ax.legend()
+        ax.set_ylim(0, 1)
+        ax.grid(True, alpha=0.3, axis='y')
+        
+        plt.tight_layout()
+        plt.show()
+    
+    @staticmethod
+    def plot_state_comparison(state1: QuantumState, state2: QuantumState,
+                             labels: tuple = ('State 1', 'State 2'),
+                             figsize: tuple = (12, 6)):
+        """
+        Compare two quantum states
+        
+        Args:
+            state1: First quantum state
+            state2: Second quantum state
+            labels: Labels for the states
+            figsize: Figure size
+        """
+        if state1.num_qubits != state2.num_qubits:
+            raise ValueError("States must have same number of qubits")
+        
+        prob1 = state1.get_probabilities()
+        prob2 = state2.get_probabilities()
+        
+        basis_labels = [format(i, f'0{state1.num_qubits}b') for i in range(state1.dim)]
+        x = np.arange(state1.dim)
+        width = 0.35
+        
+        fig, ax = plt.subplots(figsize=figsize)
+        ax.bar(x - width/2, prob1, width, label=labels[0], alpha=0.8)
+        ax.bar(x + width/2, prob2, width, label=labels[1], alpha=0.8)
+        
+        ax.set_xlabel('Basis State')
+        ax.set_ylabel('Probability')
+        ax.set_title('State Comparison')
+        ax.set_xticks(x)
+        ax.set_xticklabels(basis_labels, rotation=45, ha='right')
+        ax.legend()
+        ax.grid(True, alpha=0.3, axis='y')
+        
+        plt.tight_layout()
+        plt.show()

quantum_debugger-0.1.1.dist-info/METADATA

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: quantum-debugger
+Version: 0.1.1
+Summary: Interactive debugger and profiler for quantum circuits
+Home-page: https://github.com/yourusername/quantum-debugger
+Author: warlord9004
+Author-email: your.email@example.com
+Project-URL: Bug Reports, https://github.com/yourusername/quantum-debugger/issues
+Project-URL: Source, https://github.com/yourusername/quantum-debugger
+Project-URL: Documentation, https://quantum-debugger.readthedocs.io
+Keywords: quantum computing debugging profiling quantum-circuit visualization
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: matplotlib>=3.5.0
+Requires-Dist: scipy>=1.7.0
+Provides-Extra: qiskit
+Requires-Dist: qiskit>=0.39.0; extra == "qiskit"
+Provides-Extra: cirq
+Requires-Dist: cirq>=1.0.0; extra == "cirq"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=3.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=4.0.0; extra == "dev"
+Requires-Dist: sphinx>=4.5.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# QuantumDebugger 🔬
+
+A powerful Python library for **interactive debugging and profiling of quantum circuits** with step-through execution, state visualization, and performance analysis.
+
+## 🌟 Features
+
+### 🐛 Interactive Debugging
+- **Step-through execution**: Execute quantum circuits gate-by-gate
+- **Breakpoints**: Set breakpoints at specific gates or conditions
+- **State inspection**: Examine quantum state at any point in execution
+- **Execution history**: Track and replay circuit execution
+- **Rewind capability**: Step backwards through circuit execution
+
+### 📊 Visualization
+- **State vector plots**: Visualize quantum state amplitudes and phases
+- **Probability distributions**: See measurement probabilities
+- **Bloch sphere**: 3D visualization for single qubit states
+- **Circuit diagrams**: ASCII and graphical circuit representations
+
+### 📈 Performance Profiling
+- **Gate depth analysis**: Measure circuit depth and critical paths
+- **Complexity metrics**: Gate counts, T-count, CNOT count
+- **Performance estimation**: Predict execution time on quantum hardware
+- **Optimization suggestions**: Get recommendations for circuit improvements
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install quantum-debugger
+```
+
+### Basic Usage
+
+```python
+from quantum_debugger import QuantumCircuit, QuantumDebugger
+
+# Create a Bell state circuit
+qc = QuantumCircuit(2)
+qc.h(0)
+qc.cnot(0, 1)
+
+# Debug the circuit
+debugger = QuantumDebugger(qc)
+
+# Step through execution
+debugger.step()  # Apply H gate
+debugger.inspect_state()  # Examine current state
+debugger.visualize()  # Show state visualization
+
+debugger.step()  # Apply CNOT
+debugger.inspect_state()  # See entangled state
+```
+
+### Setting Breakpoints
+
+```python
+# Set breakpoint at gate 5
+debugger.set_breakpoint(gate=5)
+
+# Run until breakpoint
+debugger.run_until_breakpoint()
+
+# Conditional breakpoint
+debugger.set_breakpoint(condition=lambda state: state.is_entangled())
+```
+
+### Profiling
+
+```python
+from quantum_debugger import CircuitProfiler
+
+profiler = CircuitProfiler(qc)
+report = profiler.analyze()
+
+print(f"Gate depth: {report.depth}")
+print(f"Total gates: {report.gate_count}")
+print(f"CNOT count: {report.cnot_count}")
+```
+
+## 📚 Examples
+
+Check out the `examples/` directory for:
+- **Bell State Debugging**: Step-by-step entanglement creation
+- **Grover's Algorithm**: Profiling and optimization
+- **Interactive Demo**: Full feature showcase
+
+## 🛠️ Requirements
+
+- Python 3.8+
+- NumPy
+- Matplotlib
+- (Optional) Qiskit/Cirq for integration
+
+## 🤝 Contributing
+
+Contributions welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT License - feel free to use in your quantum computing projects!
+
+## 🎯 Why QuantumDebugger?
+
+Unlike existing quantum libraries that focus on circuit creation and execution, **QuantumDebugger** is specifically designed for:
+- **Learning**: Understand how quantum algorithms work step-by-step
+- **Development**: Debug complex quantum circuits efficiently
+- **Research**: Analyze and optimize quantum algorithms
+- **Teaching**: Demonstrate quantum concepts interactively
+
+## 📖 Documentation
+
+Full documentation available at: [quantum-debugger.readthedocs.io](https://quantum-debugger.readthedocs.io)
+
+## 🌐 Links
+
+- **GitHub**: [github.com/yourusername/quantum-debugger](https://github.com/yourusername/quantum-debugger)
+- **PyPI**: [pypi.org/project/quantum-debugger](https://pypi.org/project/quantum-debugger)
+- **Issues**: [Report bugs](https://github.com/yourusername/quantum-debugger/issues)
+
+---
+
+Made with ❤️ for the quantum computing community

quantum_debugger-0.1.1.dist-info/RECORD

@@ -0,0 +1,20 @@
+quantum_debugger/__init__.py,sha256=UTj22gMwrBYuWDBmvtHtdgT0WZ_ylQ6OCqG_-zNUCSI,640
+quantum_debugger/core/__init__.py,sha256=ojMpqbMRSQdiRpF2iAOUM3D_negdLOvy1VQ1wFW8tLs,279
+quantum_debugger/core/circuit.py,sha256=f-MRmWAuT8x4fk8eVp7qpm6fCSB-oHJYxkgrhHC_xlQ,9193
+quantum_debugger/core/gates.py,sha256=cw63ZZkl-MXhMw3WfBcqg5k9UxaXDpf6VN3nSnjn23g,5061
+quantum_debugger/core/quantum_state.py,sha256=hdpHEdjfIt7Felw--RfekbEdPY_FU0Ibh7O4VMpt5Pk,11279
+quantum_debugger/debugger/__init__.py,sha256=VC6euTgiCvO_UDrpxoHuCz31o0JXqfroLrxxRMCii8c,337
+quantum_debugger/debugger/breakpoints.py,sha256=lM8Z9NSFrybKwMyYLPlqWJRC6Is3MmxlbF5y6fDBcD4,4101
+quantum_debugger/debugger/debugger.py,sha256=ueztgZ478hLFBB-xtbIoMK2rzkQxh1puoYhABPy4ujY,7878
+quantum_debugger/debugger/inspector.py,sha256=7k-nAFUJA8nm9VQ0cpbe7Vrto-OO5DM7jfQ9ZnQieKM,7565
+quantum_debugger/profiler/__init__.py,sha256=ZYbtYEaVgijT2i076h1BGfR_DnGitGSCEclh7OrmcF4,231
+quantum_debugger/profiler/metrics.py,sha256=mxttKr2dwYwnWyZdR3oJeY5U2ELKeGOKDUyK52YtmGU,4604
+quantum_debugger/profiler/profiler.py,sha256=lXDsMu9Kj6cOrUJGfCoI7939NPgLYdmDlqC_LpyRzVI,6539
+quantum_debugger/visualization/__init__.py,sha256=qeIFZMT1BMWVAaX9f_kcmIEA3CzndgVA0ngdmAvXuv0,249
+quantum_debugger/visualization/bloch_sphere.py,sha256=CNV6ALN3S6bLY5AAuB8ds9fz-Xt2u7hnX-ja_pfuuvs,5867
+quantum_debugger/visualization/state_viz.py,sha256=Cu3qufFmXTpFXDivEZmo8B5sVLjCDewlQZ-1GeKKkyg,7303
+quantum_debugger-0.1.1.dist-info/licenses/LICENSE,sha256=r3tw9CUJkHJY5tPgcdr3ayN_GerX51xh9LglroEYJRE,1106
+quantum_debugger-0.1.1.dist-info/METADATA,sha256=9O59sTEErZVj9YAAvPkhMLC2xgEatRVruX0qmQzgkPE,5719
+quantum_debugger-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+quantum_debugger-0.1.1.dist-info/top_level.txt,sha256=DkmRIw_4yddkQwWfzQYDUJrWsjgU84PG_zMXiYmQmjQ,17
+quantum_debugger-0.1.1.dist-info/RECORD,,

quantum_debugger-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

quantum_debugger-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 QuantumDebugger Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

quantum_debugger-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+quantum_debugger