quantum-debugger 0.2.2__tar.gz → 0.3.0__tar.gz

{quantum_debugger-0.2.2/quantum_debugger.egg-info → quantum_debugger-0.3.0}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: quantum-debugger
-Version: 0.2.2
-Summary: Interactive debugger and profiler for quantum circuits
-Home-page: https://github.com/yourusername/quantum-debugger
+Version: 0.3.0
+Summary: Interactive debugger and profiler for quantum circuits with realistic noise simulation
+Home-page: https://github.com/Raunakg2005/quantum-debugger
 Author: warlord9004
 Author-email: your.email@example.com
 Project-URL: Bug Reports, https://github.com/Raunakg2005/quantum-debugger/issues
 Project-URL: Source, https://github.com/Raunakg2005/quantum-debugger
 Project-URL: Documentation, https://quantum-debugger.readthedocs.io/
-Keywords: quantum computing debugging profiling quantum-circuit visualization
+Keywords: quantum computing debugging profiling quantum-circuit visualization noise-simulation
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Developers
@@ -61,18 +61,42 @@ Dynamic: summary
 [![Documentation](https://img.shields.io/badge/docs-readthedocs-blue)](https://quantum-debugger.readthedocs.io/)
 
 
-A powerful Python library for step-through debugging, state inspection, and performance analysis of quantum circuits. Now with **production-grade Qiskit integration**!
+A powerful Python library for step-through debugging, state inspection, and performance analysis of quantum circuits. Now with **realistic noise simulation** and **production-grade Qiskit integration**!
 
-## ✨ Features
+## Features
 
-- 🐛 **Step-through Debugging** - Execute circuits gate-by-gate with breakpoints
-- 🔍 **State Inspection** - Analyze quantum states at any point
-- 📊 **Circuit Profiling** - Depth analysis, gate statistics, optimization suggestions  
-- 🎨 **Visualization** - State vectors, Bloch spheres, and more
-- 🔗 **Qiskit Integration** - Import/export circuits from Qiskit (NEW in v0.2.0!)
-- ✅ **100% Tested** - 88 comprehensive tests, production-ready
+- Step-through Debugging - Execute circuits gate-by-gate with breakpoints
+- State Inspection - Analyze quantum states at any point
+- Circuit Profiling - Depth analysis, gate statistics, optimization suggestions  
+- Visualization - State vectors, Bloch spheres, and more
+- **Noise Simulation** - Realistic hardware noise models (NEW in v0.3.0!)
+- Qiskit Integration - Import/export circuits from Qiskit
+- 100% Tested - 177 comprehensive tests, production-ready
 
-## 🚀 Quick Start
+##What's New in v0.3.0
+
+**Realistic Quantum Noise Simulation**
+
+```python
+from quantum_debugger import QuantumCircuit
+from quantum_debugger.noise import IBM_PERTH_2025
+
+# Simulate on IBM hardware
+qc = QuantumCircuit(2, noise_model=IBM_PERTH_2025.noise_model)
+qc.h(0).cnot(0, 1)
+results = qc.run(shots=1000)
+print(f"Fidelity: {results['fidelity']:.4f}")  # ~0.995
+```
+
+**Features:**
+- 4 noise models (Depolarizing, Amplitude/Phase Damping, Thermal Relaxation)
+- 4 hardware profiles (IBM, Google, IonQ, Rigetti with 2025 specs)
+- Automatic fidelity tracking
+- Validated against Qiskit Aer
+
+See [NOISE_TUTORIAL.md](NOISE_TUTORIAL.md) and [DOCUMENTATION.md](DOCUMENTATION.md).
+
+## Quick Start
 
 ### Installation
 
@@ -183,12 +207,12 @@ for suggestion in profiler.get_optimization_suggestions():
     print(f"  • {suggestion}")
 ```
 
-## 📊 Testing & Quality
+## Testing & Quality
 
-- **88/88 tests passing** (100%)
+- **177/177 tests passing** (100%)
 - Validated up to **12 qubits** (4,096-D state space)
 - **100+ gate circuits** tested
-- Perfect Qiskit integration fidelity
+- Qiskit Aer validation complete
 - Numerical precision < 1e-10
 
 See [TEST_SUMMARY.md](TEST_SUMMARY.md) for details.
@@ -216,17 +240,23 @@ Contributions welcome! See [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
 
 MIT License - see [LICENSE](LICENSE) file.
 
-## 🌟 What's New in v0.2.0
+## What's New
+
+**v0.3.0** (December 2024)
+- Realistic noise simulation (4 models)
+- Hardware profiles (IBM, Google, IonQ, Rigetti)
+- Qiskit Aer validation
+- 89 new tests
 
-- ✨ **Qiskit Integration** - Bidirectional circuit conversion
-- ✨ **CP Gate** - Controlled-phase gate support  
-- ✨ **19 New Tests** - Qiskit integration fully validated
-- ✨ **12-Qubit Support** - Tested on extreme-scale circuits
-- 🐛 **Bug Fixes** - Improved debugger API compatibility
+**v0.2.0**
+- Qiskit Integration - Bidirectional circuit conversion
+- CP Gate - Controlled-phase gate support  
+- 19 New Tests - Qiskit integration fully validated
+- 12-Qubit Support - Tested on extreme-scale circuits
 
-## 🚀 Roadmap
+## Roadmap
 
-- [ ] Noise simulation
+- [x] Noise simulation (v0.3.0)
 - [ ] Web-based debugger UI
 - [ ] Cirq integration
 - [ ] Hardware backend support
@@ -235,5 +265,6 @@ MIT License - see [LICENSE](LICENSE) file.
 ---
 
 **PyPI**: https://pypi.org/project/quantum-debugger/  
+**Documentation**: [DOCUMENTATION.md](DOCUMENTATION.md)  
 **Author**: warlord9004  
-**Version**: 0.2.0
+**Version**: 0.3.0

{quantum_debugger-0.2.2 → quantum_debugger-0.3.0}/README.md

@@ -9,18 +9,42 @@
 [![Documentation](https://img.shields.io/badge/docs-readthedocs-blue)](https://quantum-debugger.readthedocs.io/)
 
 
-A powerful Python library for step-through debugging, state inspection, and performance analysis of quantum circuits. Now with **production-grade Qiskit integration**!
+A powerful Python library for step-through debugging, state inspection, and performance analysis of quantum circuits. Now with **realistic noise simulation** and **production-grade Qiskit integration**!
 
-## ✨ Features
+## Features
 
-- 🐛 **Step-through Debugging** - Execute circuits gate-by-gate with breakpoints
-- 🔍 **State Inspection** - Analyze quantum states at any point
-- 📊 **Circuit Profiling** - Depth analysis, gate statistics, optimization suggestions  
-- 🎨 **Visualization** - State vectors, Bloch spheres, and more
-- 🔗 **Qiskit Integration** - Import/export circuits from Qiskit (NEW in v0.2.0!)
-- ✅ **100% Tested** - 88 comprehensive tests, production-ready
+- Step-through Debugging - Execute circuits gate-by-gate with breakpoints
+- State Inspection - Analyze quantum states at any point
+- Circuit Profiling - Depth analysis, gate statistics, optimization suggestions  
+- Visualization - State vectors, Bloch spheres, and more
+- **Noise Simulation** - Realistic hardware noise models (NEW in v0.3.0!)
+- Qiskit Integration - Import/export circuits from Qiskit
+- 100% Tested - 177 comprehensive tests, production-ready
 
-## 🚀 Quick Start
+##What's New in v0.3.0
+
+**Realistic Quantum Noise Simulation**
+
+```python
+from quantum_debugger import QuantumCircuit
+from quantum_debugger.noise import IBM_PERTH_2025
+
+# Simulate on IBM hardware
+qc = QuantumCircuit(2, noise_model=IBM_PERTH_2025.noise_model)
+qc.h(0).cnot(0, 1)
+results = qc.run(shots=1000)
+print(f"Fidelity: {results['fidelity']:.4f}")  # ~0.995
+```
+
+**Features:**
+- 4 noise models (Depolarizing, Amplitude/Phase Damping, Thermal Relaxation)
+- 4 hardware profiles (IBM, Google, IonQ, Rigetti with 2025 specs)
+- Automatic fidelity tracking
+- Validated against Qiskit Aer
+
+See [NOISE_TUTORIAL.md](NOISE_TUTORIAL.md) and [DOCUMENTATION.md](DOCUMENTATION.md).
+
+## Quick Start
 
 ### Installation
 
@@ -131,12 +155,12 @@ for suggestion in profiler.get_optimization_suggestions():
     print(f"  • {suggestion}")
 ```
 
-## 📊 Testing & Quality
+## Testing & Quality
 
-- **88/88 tests passing** (100%)
+- **177/177 tests passing** (100%)
 - Validated up to **12 qubits** (4,096-D state space)
 - **100+ gate circuits** tested
-- Perfect Qiskit integration fidelity
+- Qiskit Aer validation complete
 - Numerical precision < 1e-10
 
 See [TEST_SUMMARY.md](TEST_SUMMARY.md) for details.
@@ -164,17 +188,23 @@ Contributions welcome! See [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
 
 MIT License - see [LICENSE](LICENSE) file.
 
-## 🌟 What's New in v0.2.0
+## What's New
+
+**v0.3.0** (December 2024)
+- Realistic noise simulation (4 models)
+- Hardware profiles (IBM, Google, IonQ, Rigetti)
+- Qiskit Aer validation
+- 89 new tests
 
-- ✨ **Qiskit Integration** - Bidirectional circuit conversion
-- ✨ **CP Gate** - Controlled-phase gate support  
-- ✨ **19 New Tests** - Qiskit integration fully validated
-- ✨ **12-Qubit Support** - Tested on extreme-scale circuits
-- 🐛 **Bug Fixes** - Improved debugger API compatibility
+**v0.2.0**
+- Qiskit Integration - Bidirectional circuit conversion
+- CP Gate - Controlled-phase gate support  
+- 19 New Tests - Qiskit integration fully validated
+- 12-Qubit Support - Tested on extreme-scale circuits
 
-## 🚀 Roadmap
+## Roadmap
 
-- [ ] Noise simulation
+- [x] Noise simulation (v0.3.0)
 - [ ] Web-based debugger UI
 - [ ] Cirq integration
 - [ ] Hardware backend support
@@ -183,5 +213,6 @@ MIT License - see [LICENSE](LICENSE) file.
 ---
 
 **PyPI**: https://pypi.org/project/quantum-debugger/  
+**Documentation**: [DOCUMENTATION.md](DOCUMENTATION.md)  
 **Author**: warlord9004  
-**Version**: 0.2.0
+**Version**: 0.3.0

{quantum_debugger-0.2.2 → quantum_debugger-0.3.0}/quantum_debugger/core/circuit.py

@@ -3,7 +3,8 @@ Quantum circuit representation and execution
 """
 
 import numpy as np
-from typing import List, Optional, Union
+import warnings
+from typing import List, Optional, Union, Any
 from quantum_debugger.core.quantum_state import QuantumState
 from quantum_debugger.core.gates import GateLibrary, Gate
 
@@ -11,19 +12,61 @@ from quantum_debugger.core.gates import GateLibrary, Gate
 class QuantumCircuit:
     """Quantum circuit with gate operations"""
     
-    def __init__(self, num_qubits: int, num_classical: int = 0):
+    def __init__(self, num_qubits: int, num_classical: int = 0, 
+                 noise_model: Optional[Any] = None,
+                 noise_simulation_method: str = 'density_matrix'):
         """
         Initialize a quantum circuit
         
         Args:
             num_qubits: Number of quantum bits
             num_classical: Number of classical bits for measurements
+            noise_model: Optional noise model (NoiseModel or HardwareProfile)
+            noise_simulation_method: 'density_matrix', 'stochastic', or 'approximate'
         """
         self.num_qubits = num_qubits
         self.num_classical = num_classical if num_classical > 0 else num_qubits
         self.gates: List[Gate] = []
         self.measurements: List[tuple] = []
         self._initial_state = QuantumState(num_qubits)
+        
+        # Noise configuration
+        self.noise_model = noise_model
+        self.noise_simulation_method = noise_simulation_method
+        self.apply_noise = noise_model is not None
+        
+        # Memory warning for large circuits with density matrices
+        if self.apply_noise and num_qubits > 10 and noise_simulation_method == 'density_matrix':
+            memory_mb = (2**num_qubits)**2 * 16 / (1024**2)  # complex128 = 16 bytes
+            warnings.warn(
+                f"Density matrix for {num_qubits} qubits requires ~{memory_mb:.1f}MB memory. "
+                f"Consider noise_simulation_method='stochastic' for circuits with >10 qubits.",
+                ResourceWarning,
+                stacklevel=2
+            )
+    
+    def set_noise_model(self, noise_model: Optional[Any], 
+                        noise_simulation_method: str = 'density_matrix'):
+        """
+        Set or update noise model for the circuit
+        
+        Args:
+            noise_model: NoiseModel instance, HardwareProfile, or None to disable
+            noise_simulation_method: 'density_matrix', 'stochastic', or 'approximate'
+        """
+        self.noise_model = noise_model
+        self.noise_simulation_method = noise_simulation_method
+        self.apply_noise = noise_model is not None
+        
+        # Update memory warning if needed
+        if self.apply_noise and self.num_qubits > 10 and noise_simulation_method == 'density_matrix':
+            memory_mb = (2**self.num_qubits)**2 * 16 / (1024**2)
+            warnings.warn(
+                f"Density matrix for {self.num_qubits} qubits requires ~{memory_mb:.1f}MB memory. "
+                f"Consider noise_simulation_method='stochastic' for circuits with >10 qubits.",
+                ResourceWarning,
+                stacklevel=2
+            )
     
     def _add_gate(self, name: str, matrix: np.ndarray, qubits: Union[int, List[int]], params: dict = None):
         """Add a gate to the circuit"""
@@ -166,11 +209,16 @@ class QuantumCircuit:
         
         Args:
             shots: Number of times to run the circuit
-            initial_state: Optional initial state (defaults to |0...0>)
+            initial_state: Optional initial state (defaults to |0...0⟩)
             
         Returns:
             Dictionary with measurement results and statistics
         """
+        # Route to noisy execution if noise model is enabled
+        if self.apply_noise:
+            return self._run_with_noise(shots, initial_state)
+        
+        # Standard noiseless execution
         results = []
         
         for _ in range(shots):
@@ -199,6 +247,76 @@ class QuantumCircuit:
             'shots': shots
         }
     
+    def _run_with_noise(self, shots: int, initial_state: Optional[QuantumState]) -> dict:
+        """
+        Execute circuit with noise simulation
+        
+        Args:
+            shots: Number of times to run the circuit
+            initial_state: Optional initial state
+            
+        Returns:
+            Dictionary with measurement results, statistics, and fidelity
+        """
+        from quantum_debugger.noise import QuantumState as NoisyQuantumState
+        
+        results = []
+        fidelities = []
+        
+        for _ in range(shots):
+            # Initialize with density matrix
+            if initial_state:
+                # Convert existing state to density matrix if needed
+                if hasattr(initial_state, 'density_matrix') and initial_state.density_matrix is not None:
+                    state = initial_state.copy()
+                else:
+                    state = NoisyQuantumState(self.num_qubits, 
+                                            state_vector=initial_state.state_vector, 
+                                            use_density_matrix=True)
+            else:
+                state = NoisyQuantumState(self.num_qubits, use_density_matrix=True)
+            
+            # Store reference state for fidelity calculation
+            reference_state = NoisyQuantumState(self.num_qubits, use_density_matrix=True)
+            for gate in self.gates:
+                reference_state.apply_gate(gate.matrix, gate.qubits)
+            
+            # Apply gates with noise
+            for gate in self.gates:
+                # Apply the gate
+                state.apply_gate(gate.matrix, gate.qubits)
+                
+                # Apply noise after the gate
+                if self.noise_model:
+                    self.noise_model.apply(state, qubits=gate.qubits)
+            
+            # Calculate fidelity
+            if hasattr(state, 'density_matrix') and state.density_matrix is not None:
+                # Fidelity = Tr(ρ_ideal * ρ_noisy)
+                fidelity = np.trace(reference_state.density_matrix @ state.density_matrix).real
+                fidelities.append(fidelity)
+            
+            # Perform measurements
+            classical_bits = [0] * self.num_classical
+            for qubit, classical_bit in self.measurements:
+                classical_bits[classical_bit] = state.measure(qubit)
+            
+            results.append(classical_bits)
+        
+        # Analyze results
+        counts = {}
+        for result in results:
+            key = ''.join(map(str, result))
+            counts[key] = counts.get(key, 0) + 1
+        
+        return {
+            'counts': counts,
+            'results': results,
+            'shots': shots,
+            'fidelity': np.mean(fidelities) if fidelities else 1.0,
+            'fidelity_std': np.std(fidelities) if fidelities else 0.0
+        }
+    
     def get_statevector(self, initial_state: Optional[QuantumState] = None) -> QuantumState:
         """
         Get final state vector without measurements

quantum_debugger-0.3.0/quantum_debugger/noise/__init__.py

@@ -0,0 +1,47 @@
+"""
+Quantum noise simulation module
+"""
+
+from quantum_debugger.noise.noise_models import (
+    NoiseModel,
+    DepolarizingNoise,
+    AmplitudeDamping,
+    PhaseDamping,
+    ThermalRelaxation
+)
+
+from quantum_debugger.noise.noise_helpers import QuantumState
+
+from quantum_debugger.noise.composite_noise import CompositeNoise
+
+from quantum_debugger.noise.hardware_profiles import (
+    HardwareProfile,
+    IBM_PERTH_2025,
+    GOOGLE_SYCAMORE_2025,
+    IONQ_ARIA_2025,
+    RIGETTI_ASPEN_2025,
+    HARDWARE_PROFILES,
+    get_hardware_profile,
+    list_hardware_profiles
+)
+
+__all__ = [
+    # Noise models
+    'NoiseModel',
+    'DepolarizingNoise',
+    'AmplitudeDamping',
+    'PhaseDamping',
+    'ThermalRelaxation',
+    'CompositeNoise',
+    # State wrapper
+    'QuantumState',
+    # Hardware profiles
+    'HardwareProfile',
+    'IBM_PERTH_2025',
+    'GOOGLE_SYCAMORE_2025',
+    'IONQ_ARIA_2025',
+    'RIGETTI_ASPEN_2025',
+    'HARDWARE_PROFILES',
+    'get_hardware_profile',
+    'list_hardware_profiles',
+]

quantum_debugger-0.3.0/quantum_debugger/noise/composite_noise.py

@@ -0,0 +1,54 @@
+"""
+Composite noise model for combining multiple noise sources
+"""
+
+import numpy as np
+from typing import List, Optional
+from quantum_debugger.noise.noise_models import NoiseModel
+
+
+class CompositeNoise(NoiseModel):
+    """
+    Composite noise model that applies multiple noise sources sequentially
+    
+    Allows realistic simulation by combining different noise types:
+    - Thermal relaxation (T1/T2)
+    - Depolarizing errors
+    - Readout errors
+    - etc.
+    
+    Example:
+        >>> thermal = ThermalRelaxation(t1=100e-6, t2=80e-6, gate_time=50e-9)
+        >>> depol = DepolarizingNoise(0.001)
+        >>> composite = CompositeNoise([thermal, depol])
+    """
+    
+    def __init__(self, noise_models: List[NoiseModel]):
+        """
+        Initialize composite noise model
+        
+        Args:
+            noise_models: List of NoiseModel instances to apply sequentially
+        """
+        if not noise_models:
+            raise ValueError("CompositeNoise requires at least one noise model")
+        
+        self.noise_models = noise_models
+    
+    def apply(self, state, qubits: Optional[list] = None):
+        """
+        Apply all noise models sequentially
+        
+        Args:
+            state: QuantumState to apply noise to
+            qubits: Optional list of qubits (None = all qubits)
+        """
+        for noise_model in self.noise_models:
+            noise_model.apply(state, qubits)
+    
+    def __repr__(self):
+        models_str = ", ".join(repr(m) for m in self.noise_models)
+        return f"CompositeNoise([{models_str}])"
+    
+    def __str__(self):
+        return f"CompositeNoise with {len(self.noise_models)} noise sources"