quantum-debugger 0.4.0__tar.gz → 0.4.2__tar.gz

quantum_debugger-0.4.2/CHANGELOG.md

@@ -0,0 +1,110 @@
+# Changelog
+
+All notable changes to QuantumDebugger will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.4.2] - 2025-12-22
+
+### Added
+- **Complete pytest migration**: All 200 legacy script-style tests converted to pytest format
+- **Hardware profiles extended**: AWS Braket, Azure Quantum provider support
+- **2025 hardware updates**: IBM Heron, Google Willow, IonQ Forte profiles
+- **Advanced backend tests**: 8 edge case and performance tests
+- **GPU backend support**: CuPy backend availability testing
+- **Enhanced test coverage**: 656 comprehensive tests (all passing ✅)
+
+### Changed
+- Migrated all legacy test files from script execution to pytest format
+- Updated test structure for better CI/CD compatibility
+- Enhanced backend validation with 6 comprehensive backend tests
+- Improved hardware profile testing (18 tests total)
+
+### Fixed
+- Test suite compatibility issues
+- Backend detection for GPU/CuPy
+- Hardware profile version tracking
+
+### Documentation
+- Updated README.md with v0.4.2 features and test count
+- Added comprehensive testing section in README
+- Created FINAL_TEST_SUMMARY.md with complete 656 test breakdown
+- Fixed all documentation links (tutorials, examples, LICENSE)
+- Updated version numbers across all files
+
+### Testing
+- **656 total tests** (all passing ✅)
+- All script-style tests converted to pytest
+- Complete test coverage documentation
+
+## [0.4.1] - 2024-12-XX
+
+### Added
+- Additional QML features and optimizations
+- Performance improvements
+
+## [0.4.0] - 2024-12-XX
+
+### Added
+- **Quantum Machine Learning Module**
+- Parameterized gates (RX, RY, RZ with trainable parameters)
+- VQE algorithm for molecular chemistry
+- QAOA for combinatorial optimization
+- Training framework with 4 optimizers (Adam, SGD, SPSA, RMSprop)
+- Gradient computation (parameter shift rule, finite differences)
+- 316 comprehensive tests
+- 3 tutorials, 4 example scripts
+
+### Changed
+- Enhanced circuit profiling
+- Improved state visualization
+
+## [0.3.0] - 2024-12-XX
+
+### Added
+- Realistic noise models (4 types)
+- Hardware profiles (IBM, Google, IonQ, Rigetti)
+- Qiskit Aer validation
+- 89 new tests
+
+## [0.2.0] - 2024-XX-XX
+
+### Added
+- Bidirectional circuit conversion with Qiskit
+- CP gate support
+- 12-qubit support
+
+## [0.1.1] - 2024-12-03
+
+### Fixed
+- Fixed SWAP gate matrix for little-endian qubit ordering
+- Fixed CNOT gate matrix for little-endian qubit ordering
+- Fixed Toffoli gate matrix for little-endian qubit ordering
+- Fixed entanglement detection for Bell states
+- Rewrote multi-qubit gate expansion algorithm using tensor products
+
+### Added
+- 69 comprehensive tests (100% pass rate)
+- Test suites: quickstart, advanced, comprehensive, extreme, validation, production, edge cases
+- Numerical stability tests (100+ consecutive operations)
+- Quantum mechanics validation tests
+- Production readiness tests
+
+### Changed
+- Improved gate expansion algorithm for better accuracy
+- Enhanced test coverage to 69 tests across 7 test suites
+
+## [0.1.0] - 2024-11-30
+
+### Added
+- Initial release
+- Core quantum state representation
+- 15+ quantum gates (H, X, Y, Z, S, T, RX, RY, RZ, PHASE, CNOT, CZ, SWAP, Toffoli)
+- Step-through debugger with breakpoints
+- Circuit profiler with optimization suggestions
+- State visualization tools
+- Bloch sphere representation
+- Support for up to 15 qubits
+- Example circuits and demos
+- Comprehensive documentation

{quantum_debugger-0.4.0/quantum_debugger.egg-info → quantum_debugger-0.4.2}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: quantum-debugger
-Version: 0.4.0
+Version: 0.4.2
 Summary: Interactive quantum circuit debugger and Quantum Machine Learning library with VQE, QAOA, and parameterized gates
 Home-page: https://github.com/Raunakg2005/quantum-debugger
-Author: warlord9004
-Author-email: your.email@example.com
+Author: Raunak Kumar Gupta
+Author-email: raunak.gupta@somaiya.edu
 Project-URL: Bug Reports, https://github.com/Raunakg2005/quantum-debugger/issues
 Project-URL: Source, https://github.com/Raunakg2005/quantum-debugger
 Project-URL: Documentation, https://github.com/Raunakg2005/quantum-debugger#readme
@@ -55,13 +55,13 @@ Dynamic: summary
 **Interactive debugger, profiler, and quantum machine learning library for quantum circuits**
 
 [![PyPI version](https://badge.fury.io/py/quantum-debugger.svg)](https://pypi.org/project/quantum-debugger/)
-[![Tests](https://img.shields.io/badge/tests-316%2F316%20passing-brightgreen)]()
+[![Tests](https://img.shields.io/badge/tests-656%20passing-brightgreen)](./tests/FINAL_TEST_SUMMARY.md)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue)]()
 [![License](https://img.shields.io/badge/license-MIT-green)]()
 
 A powerful Python library for quantum circuit debugging, state inspection, performance analysis, and **quantum machine learning**. Now with VQE, QAOA, and parameterized quantum circuits!
 
-## ✨ What's New in v0.4.0
+## ✨ What's New in v0.4.2
 
 **Quantum Machine Learning Module** 🚀
 
@@ -82,7 +82,10 @@ print(f"Ground state energy: {result['ground_state_energy']:.6f} Hartree")
 - ✅ **QAOA** (Quantum optimization for MaxCut problems)
 - ✅ **Training Framework** (Adam, SGD, SPSA, RMSprop optimizers)
 - ✅ **Gradient Computation** (Parameter shift rule, finite differences)
-- ✅ **316 comprehensive tests** (100% passing)
+- ✅ **656 comprehensive tests** (all passing ✅)
+- ✅ **Complete pytest migration** (all legacy scripts converted)
+- ✅ **Hardware profiles** (AWS Braket, Azure Quantum, 2025 updates)
+- ✅ **Enhanced backends** (Advanced validation, GPU support)
 
 See full [QML Documentation](#quantum-machine-learning-v040) below.
 
@@ -96,7 +99,7 @@ See full [QML Documentation](#quantum-machine-learning-v040) below.
 - **Noise Simulation** - Realistic hardware noise models
 - **Qiskit Integration** - Import/export circuits from Qiskit
 
-### Quantum Machine Learning (NEW v0.4.0)
+### Quantum Machine Learning (v0.4.0+)
 - **Parameterized Circuits** - Trainable quantum gates
 - **VQE** - Molecular ground state finding
 - **QAOA** - Combinatorial optimization
@@ -361,14 +364,16 @@ See [test files](.) for details.
 ## 📖 Documentation
 
 - **Tutorials:**
-  - [Parameterized Gates Tutorial](tutorials/parameterized_gates_tutorial.md)
-  - [VQE Preparation Guide](tutorials/vqe_preparation.md)
-  - [QAOA Tutorial](tutorials/qaoa_tutorial.md)
+  - [Parameterized Gates Tutorial](./tutorials/parameterized_gates_tutorial.md)
+  - [VQE Preparation Guide](./tutorials/vqe_preparation.md)
+  - [QAOA Tutorial](./tutorials/qaoa_tutorial.md)
+  - [Noise Tutorial](./tutorials/noise_tutorial.md)
+  - [ZNE Tutorial](./tutorials/zne_tutorial.md)
 
 - **Examples:**
-  - [VQE H2 Molecule](examples/vqe_h2_example.py)
-  - [QAOA MaxCut](examples/qaoa_maxcut_example.py)
-  - [Performance Benchmarks](examples/benchmarks.py)
+  - [VQE H2 Molecule](./examples/vqe_h2_example.py)
+  - [QAOA MaxCut](./examples/qaoa_maxcut_example.py)
+  - [QML Basic Example](./examples/qml_basic_example.py)
 
 ## 📈 Version History
 
@@ -410,21 +415,74 @@ See [test files](.) for details.
 - [ ] Quantum error correction tools
 - [ ] Production deployment tools
 
+## 🧪 Testing
+
+**v0.4.2: 656 Comprehensive Tests** ✅
+
+### Test Suite Coverage
+- **Core Tests**: 441 tests (quantum operations, circuits, debugging)
+- **QML Tests**: 139 tests (VQE, QAOA, training, parameterized gates)
+- **Integration**: 76 tests (Cirq, Qiskit, backend validation)
+- **All test files converted to pytest format**
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Run specific test suites
+pytest tests/unit/ -v          # Core unit tests
+pytest tests/cirq/ -v          # Cirq integration
+pytest tests/qiskit/ -v        # Qiskit integration
+pytest tests/qml/ -v           # QML tests
+
+# Run with coverage
+pytest tests/ --cov=quantum_debugger --cov-report=html
+
+# Run specific converted tests
+pytest tests/unit/test_backends_advanced.py -v
+pytest tests/unit/test_hardware_profiles_phase3.py -v
+```
+
+### Test Documentation
+- 📊 [Complete Test Summary](./tests/FINAL_TEST_SUMMARY.md) - Full breakdown of all 656 tests
+- 📁 [Test Structure](./tests/README.md) - Organization and conventions
+
+### Test Categories
+1. **Backend Tests** (59 tests) - NumPy, Sparse, GPU backends
+2. **Noise Tests** (64 tests) - Noise models, hardware profiles
+3. **Mitigation Tests** (28 tests) - ZNE, error mitigation
+4. **Hardware Profiles** (18 tests) - AWS Braket, Azure Quantum, 2025 updates
+5. **QML Tests** (139 tests) - VQE, QAOA, training framework
+6. **Integration Tests** (76 tests) - Cirq, Qiskit compatibility
+
 ## 🤝 Contributing
 
 Contributions welcome! Please ensure tests pass:
 
 ```bash
-pytest test_*.py -v
+pytest tests/ -v --tb=short
 ```
 
+See [Testing Section](#testing) for details.
+
 ## 📄 License
 
-MIT License - see [LICENSE](LICENSE) file.
+MIT License - see [LICENSE](./LICENSE) file.
+
+---
+
+## 🙏 Acknowledgments
+
+**Author:** Raunak Kumar Gupta  
+**Supervised by:** Dr. Vaibhav Prakash Vasani  
+**Institution:** K.J. Somaiya School of Engineering
 
 ---
 
 **PyPI:** https://pypi.org/project/quantum-debugger/  
-**Author:** warlord9004  
-**Version:** 0.4.0  
+**Author:** Raunak Kumar Gupta  
+**Institution:** K.J. Somaiya School of Engineering  
+**Version:** 0.4.2  
 **Python:** 3.9+

{quantum_debugger-0.4.0 → quantum_debugger-0.4.2}/README.md

@@ -3,13 +3,13 @@
 **Interactive debugger, profiler, and quantum machine learning library for quantum circuits**
 
 [![PyPI version](https://badge.fury.io/py/quantum-debugger.svg)](https://pypi.org/project/quantum-debugger/)
-[![Tests](https://img.shields.io/badge/tests-316%2F316%20passing-brightgreen)]()
+[![Tests](https://img.shields.io/badge/tests-656%20passing-brightgreen)](./tests/FINAL_TEST_SUMMARY.md)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue)]()
 [![License](https://img.shields.io/badge/license-MIT-green)]()
 
 A powerful Python library for quantum circuit debugging, state inspection, performance analysis, and **quantum machine learning**. Now with VQE, QAOA, and parameterized quantum circuits!
 
-## ✨ What's New in v0.4.0
+## ✨ What's New in v0.4.2
 
 **Quantum Machine Learning Module** 🚀
 
@@ -30,7 +30,10 @@ print(f"Ground state energy: {result['ground_state_energy']:.6f} Hartree")
 - ✅ **QAOA** (Quantum optimization for MaxCut problems)
 - ✅ **Training Framework** (Adam, SGD, SPSA, RMSprop optimizers)
 - ✅ **Gradient Computation** (Parameter shift rule, finite differences)
-- ✅ **316 comprehensive tests** (100% passing)
+- ✅ **656 comprehensive tests** (all passing ✅)
+- ✅ **Complete pytest migration** (all legacy scripts converted)
+- ✅ **Hardware profiles** (AWS Braket, Azure Quantum, 2025 updates)
+- ✅ **Enhanced backends** (Advanced validation, GPU support)
 
 See full [QML Documentation](#quantum-machine-learning-v040) below.
 
@@ -44,7 +47,7 @@ See full [QML Documentation](#quantum-machine-learning-v040) below.
 - **Noise Simulation** - Realistic hardware noise models
 - **Qiskit Integration** - Import/export circuits from Qiskit
 
-### Quantum Machine Learning (NEW v0.4.0)
+### Quantum Machine Learning (v0.4.0+)
 - **Parameterized Circuits** - Trainable quantum gates
 - **VQE** - Molecular ground state finding
 - **QAOA** - Combinatorial optimization
@@ -309,14 +312,16 @@ See [test files](.) for details.
 ## 📖 Documentation
 
 - **Tutorials:**
-  - [Parameterized Gates Tutorial](tutorials/parameterized_gates_tutorial.md)
-  - [VQE Preparation Guide](tutorials/vqe_preparation.md)
-  - [QAOA Tutorial](tutorials/qaoa_tutorial.md)
+  - [Parameterized Gates Tutorial](./tutorials/parameterized_gates_tutorial.md)
+  - [VQE Preparation Guide](./tutorials/vqe_preparation.md)
+  - [QAOA Tutorial](./tutorials/qaoa_tutorial.md)
+  - [Noise Tutorial](./tutorials/noise_tutorial.md)
+  - [ZNE Tutorial](./tutorials/zne_tutorial.md)
 
 - **Examples:**
-  - [VQE H2 Molecule](examples/vqe_h2_example.py)
-  - [QAOA MaxCut](examples/qaoa_maxcut_example.py)
-  - [Performance Benchmarks](examples/benchmarks.py)
+  - [VQE H2 Molecule](./examples/vqe_h2_example.py)
+  - [QAOA MaxCut](./examples/qaoa_maxcut_example.py)
+  - [QML Basic Example](./examples/qml_basic_example.py)
 
 ## 📈 Version History
 
@@ -358,21 +363,74 @@ See [test files](.) for details.
 - [ ] Quantum error correction tools
 - [ ] Production deployment tools
 
+## 🧪 Testing
+
+**v0.4.2: 656 Comprehensive Tests** ✅
+
+### Test Suite Coverage
+- **Core Tests**: 441 tests (quantum operations, circuits, debugging)
+- **QML Tests**: 139 tests (VQE, QAOA, training, parameterized gates)
+- **Integration**: 76 tests (Cirq, Qiskit, backend validation)
+- **All test files converted to pytest format**
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Run specific test suites
+pytest tests/unit/ -v          # Core unit tests
+pytest tests/cirq/ -v          # Cirq integration
+pytest tests/qiskit/ -v        # Qiskit integration
+pytest tests/qml/ -v           # QML tests
+
+# Run with coverage
+pytest tests/ --cov=quantum_debugger --cov-report=html
+
+# Run specific converted tests
+pytest tests/unit/test_backends_advanced.py -v
+pytest tests/unit/test_hardware_profiles_phase3.py -v
+```
+
+### Test Documentation
+- 📊 [Complete Test Summary](./tests/FINAL_TEST_SUMMARY.md) - Full breakdown of all 656 tests
+- 📁 [Test Structure](./tests/README.md) - Organization and conventions
+
+### Test Categories
+1. **Backend Tests** (59 tests) - NumPy, Sparse, GPU backends
+2. **Noise Tests** (64 tests) - Noise models, hardware profiles
+3. **Mitigation Tests** (28 tests) - ZNE, error mitigation
+4. **Hardware Profiles** (18 tests) - AWS Braket, Azure Quantum, 2025 updates
+5. **QML Tests** (139 tests) - VQE, QAOA, training framework
+6. **Integration Tests** (76 tests) - Cirq, Qiskit compatibility
+
 ## 🤝 Contributing
 
 Contributions welcome! Please ensure tests pass:
 
 ```bash
-pytest test_*.py -v
+pytest tests/ -v --tb=short
 ```
 
+See [Testing Section](#testing) for details.
+
 ## 📄 License
 
-MIT License - see [LICENSE](LICENSE) file.
+MIT License - see [LICENSE](./LICENSE) file.
+
+---
+
+## 🙏 Acknowledgments
+
+**Author:** Raunak Kumar Gupta  
+**Supervised by:** Dr. Vaibhav Prakash Vasani  
+**Institution:** K.J. Somaiya School of Engineering
 
 ---
 
 **PyPI:** https://pypi.org/project/quantum-debugger/  
-**Author:** warlord9004  
-**Version:** 0.4.0  
+**Author:** Raunak Kumar Gupta  
+**Institution:** K.J. Somaiya School of Engineering  
+**Version:** 0.4.2  
 **Python:** 3.9+

{quantum_debugger-0.4.0 → quantum_debugger-0.4.2}/quantum_debugger/__init__.py

@@ -15,7 +15,7 @@ Features:
 Version: 0.4.0-dev
 """
 
-__version__ = "0.4.0-dev"
+__version__ = "0.4.2"
 __author__ = "warlord9004"
 __license__ = "MIT"
 

quantum_debugger-0.4.2/quantum_debugger/integrations/__init__.py

@@ -0,0 +1,8 @@
+"""
+Integration modules for connecting with other quantum frameworks
+"""
+
+from .qiskit_adapter import QiskitAdapter
+from .cirq_adapter import CirqAdapter
+
+__all__ = ['QiskitAdapter', 'CirqAdapter']

quantum_debugger-0.4.2/quantum_debugger/integrations/cirq_adapter.py

@@ -0,0 +1,270 @@
+"""
+Cirq Adapter - Convert between Cirq and QuantumDebugger circuits
+
+This module provides bidirectional conversion:
+- Import Cirq Circuit → QuantumDebugger circuit
+- Export QuantumDebugger circuit → Cirq Circuit
+"""
+
+import numpy as np
+from typing import Optional, List, Tuple
+
+try:
+    import cirq
+    CIRQ_AVAILABLE = True
+except ImportError:
+    CIRQ_AVAILABLE = False
+    cirq = None
+
+from ..core.circuit import QuantumCircuit as QDCircuit
+
+
+class CirqAdapter:
+    """Adapter for converting between Cirq and QuantumDebugger circuits"""
+    
+    # Gate name mapping: Cirq → QuantumDebugger
+    GATE_MAP = {
+        'H': 'h',
+        'X': 'x',
+        'Y': 'y',
+        'Z': 'z',
+        'S': 's',
+        'T': 't',
+        'CNOT': 'cnot',
+        'CX': 'cnot',
+        'CZ': 'cz',
+        'SWAP': 'swap',
+        'TOFFOLI': 'toffoli',
+        'CCX': 'toffoli',
+        'Rx': 'rx',
+        'Ry': 'ry',
+        'Rz': 'rz',
+    }
+    
+    @staticmethod
+    def check_cirq_available():
+        """Check if Cirq is installed"""
+        if not CIRQ_AVAILABLE:
+            raise ImportError(
+                "Cirq is not installed. Install with: pip install cirq"
+            )
+    
+    @classmethod
+    def from_cirq(cls, cirq_circuit: 'cirq.Circuit') -> QDCircuit:
+        """
+        Convert a Cirq Circuit to QuantumDebugger circuit
+        
+        Args:
+            cirq_circuit: Cirq Circuit to convert
+            
+        Returns:
+            QuantumDebugger QuantumCircuit
+            
+        Example:
+            >>> import cirq
+            >>> q0, q1 = cirq.LineQubit.range(2)
+            >>> cirq_circuit = cirq.Circuit()
+            >>> cirq_circuit.append([cirq.H(q0), cirq.CNOT(q0, q1)])
+            >>> qd_circuit = CirqAdapter.from_cirq(cirq_circuit)
+        """
+        cls.check_cirq_available()
+        
+        # Get all qubits and create mapping
+        qubits = sorted(cirq_circuit.all_qubits())
+        qubit_map = {q: i for i, q in enumerate(qubits)}
+        num_qubits = len(qubits)
+        
+        # Create QuantumDebugger circuit
+        qd_circuit = QDCircuit(num_qubits)
+        
+        # Convert each operation
+        for moment in cirq_circuit:
+            for operation in moment:
+                gate = operation.gate
+                gate_qubits = operation.qubits
+                
+                # Get qubit indices
+                qubit_indices = [qubit_map[q] for q in gate_qubits]
+                
+                # Determine gate type using string comparison (more reliable)
+                gate_str = str(gate).upper()
+                gate_name = None
+                params = []
+                
+                # Check gates by string representation
+                if 'H' == gate_str:
+                    gate_name = 'h'
+                elif 'X' == gate_str:
+                    gate_name = 'x'
+                elif 'Y' == gate_str:
+                    gate_name = 'y'
+                elif 'Z' == gate_str:
+                    gate_name = 'z'
+                elif 'S' == gate_str:
+                    gate_name = 's'
+                elif 'T' == gate_str:
+                    gate_name = 't'
+                elif 'CNOT' in gate_str or 'CX' in gate_str:
+                    gate_name = 'cnot'
+                elif 'CZ' == gate_str:
+                    gate_name = 'cz'
+                elif 'SWAP' in gate_str:
+                    gate_name = 'swap'
+                elif 'CCX' in gate_str or 'TOFFOLI' in gate_str:
+                    gate_name = 'toffoli'
+                elif gate_str.startswith('RX'):
+                    gate_name = 'rx'
+                    # Extract angle from gate
+                    if hasattr(gate, 'exponent'):
+                        params = [gate.exponent * np.pi]
+                    elif hasattr(gate, '_rads'):
+                        params = [gate._rads]
+                elif gate_str.startswith('RY'):
+                    gate_name = 'ry'
+                    if hasattr(gate, 'exponent'):
+                        params = [gate.exponent * np.pi]
+                    elif hasattr(gate, '_rads'):
+                        params = [gate._rads]
+                elif gate_str.startswith('RZ'):
+                    gate_name = 'rz'
+                    if hasattr(gate, 'exponent'):
+                        params = [gate.exponent * np.pi]
+                    elif hasattr(gate, '_rads'):
+                        params = [gate._rads]
+                
+                # Apply gate to QuantumDebugger circuit
+                if gate_name:
+                    gate_method = getattr(qd_circuit, gate_name)
+                    if params:
+                        # Parameterized gate
+                        gate_method(*params, *qubit_indices)
+                    else:
+                        # Standard gate
+                        gate_method(*qubit_indices)
+                else:
+                    print(f"Warning: Gate '{gate_str}' not supported in QuantumDebugger, skipping")
+        
+        return qd_circuit
+    
+    @classmethod
+    def to_cirq(cls, qd_circuit: QDCircuit, qubits: Optional[List['cirq.Qubit']] = None) -> 'cirq.Circuit':
+        """
+        Convert a QuantumDebugger circuit to Cirq Circuit
+        
+        Args:
+            qd_circuit: QuantumDebugger circuit to convert
+            qubits: Optional list of Cirq qubits to use. If None, LineQubits are created.
+            
+        Returns:
+            Cirq Circuit
+            
+        Example:
+            >>> from quantum_debugger import QuantumCircuit
+            >>> qd_circuit = QuantumCircuit(2)
+            >>> qd_circuit.h(0)
+            >>> qd_circuit.cnot(0, 1)
+            >>> cirq_circuit = CirqAdapter.to_cirq(qd_circuit)
+        """
+        cls.check_cirq_available()
+        
+        # Create qubits if not provided
+        if qubits is None:
+            qubits = [cirq.LineQubit(i) for i in range(qd_circuit.num_qubits)]
+        elif len(qubits) != qd_circuit.num_qubits:
+            raise ValueError(f"Number of qubits ({len(qubits)}) doesn't match circuit ({qd_circuit.num_qubits})")
+        
+        # Create Cirq circuit
+        cirq_circuit = cirq.Circuit()
+        
+        # Convert each gate
+        for gate in qd_circuit.gates:
+            gate_name = gate.name.lower()
+            gate_qubits = [qubits[i] for i in gate.qubits]
+            params = gate.params if gate.params else {}
+            
+            # Map to Cirq gates
+            if gate_name == 'h':
+                cirq_circuit.append(cirq.H(gate_qubits[0]))
+            elif gate_name == 'x':
+                cirq_circuit.append(cirq.X(gate_qubits[0]))
+            elif gate_name == 'y':
+                cirq_circuit.append(cirq.Y(gate_qubits[0]))
+            elif gate_name == 'z':
+                cirq_circuit.append(cirq.Z(gate_qubits[0]))
+            elif gate_name == 's':
+                cirq_circuit.append(cirq.S(gate_qubits[0]))
+            elif gate_name == 't':
+                cirq_circuit.append(cirq.T(gate_qubits[0]))
+            elif gate_name == 'cnot':
+                cirq_circuit.append(cirq.CNOT(gate_qubits[0], gate_qubits[1]))
+            elif gate_name == 'cz':
+                cirq_circuit.append(cirq.CZ(gate_qubits[0], gate_qubits[1]))
+            elif gate_name == 'swap':
+                cirq_circuit.append(cirq.SWAP(gate_qubits[0], gate_qubits[1]))
+            elif gate_name == 'toffoli':
+                cirq_circuit.append(cirq.CCX(gate_qubits[0], gate_qubits[1], gate_qubits[2]))
+            elif gate_name == 'rx' and 'theta' in params:
+                # Convert radians to Cirq exponent
+                exponent = params['theta'] / np.pi
+                cirq_circuit.append(cirq.Rx(rads=params['theta'])(gate_qubits[0]))
+            elif gate_name == 'ry' and 'theta' in params:
+                cirq_circuit.append(cirq.Ry(rads=params['theta'])(gate_qubits[0]))
+            elif gate_name == 'rz' and 'theta' in params:
+                cirq_circuit.append(cirq.Rz(rads=params['theta'])(gate_qubits[0]))
+            elif gate_name == 'cp' and 'theta' in params:
+                # Controlled phase
+                cirq_circuit.append(cirq.CZPowGate(exponent=params['theta']/np.pi)(gate_qubits[0], gate_qubits[1]))
+            elif gate_name == 'phase' and 'theta' in params:
+                # Phase gate
+                cirq_circuit.append(cirq.ZPowGate(exponent=params['theta']/np.pi)(gate_qubits[0]))
+            else:
+                print(f"Warning: Gate '{gate_name}' not recognized for Cirq conversion, skipping")
+        
+        return cirq_circuit
+    
+    @classmethod
+    def compare_circuits(cls, cirq_circuit: 'cirq.Circuit', qd_circuit: QDCircuit) -> dict:
+        """
+        Compare a Cirq circuit with a QuantumDebugger circuit
+        
+        Returns:
+            Dictionary with comparison results
+        """
+        cls.check_cirq_available()
+        
+        cirq_num_qubits = len(cirq_circuit.all_qubits())
+        cirq_num_ops = sum(len(moment) for moment in cirq_circuit)
+        
+        return {
+            'num_qubits_match': cirq_num_qubits == qd_circuit.num_qubits,
+            'num_gates_match': cirq_num_ops == len(qd_circuit.gates),
+            'cirq_qubits': cirq_num_qubits,
+            'qd_qubits': qd_circuit.num_qubits,
+            'cirq_gates': cirq_num_ops,
+            'qd_gates': len(qd_circuit.gates),
+        }
+    
+    @classmethod
+    def simulate_cirq(cls, qd_circuit: QDCircuit) -> dict:
+        """
+        Simulate a QuantumDebugger circuit using Cirq's simulator
+        
+        Args:
+            qd_circuit: QuantumDebugger circuit to simulate
+            
+        Returns:
+            Dictionary with simulation results
+        """
+        cls.check_cirq_available()
+        
+        # Convert to Cirq
+        cirq_circuit = cls.to_cirq(qd_circuit)
+        
+        # Simulate
+        simulator = cirq.Simulator()
+        result = simulator.simulate(cirq_circuit)
+        
+        return {
+            'state_vector': result.final_state_vector,
+            'measurements': result.measurements if hasattr(result, 'measurements') else None,
+        }