superquantx 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

superquantx/utils/quantum_utils.py

@@ -5,7 +5,6 @@ including fidelity calculations, quantum distances, and entanglement measures.
 """
 
 import warnings
-from typing import Tuple
 
 import numpy as np
 from scipy.linalg import sqrtm
@@ -17,18 +16,18 @@ def fidelity(
     validate: bool = True
 ) -> float:
     """Calculate quantum fidelity between two quantum states.
-    
+
     For pure states |ψ₁⟩ and |ψ₂⟩:
     F(ψ₁, ψ₂) = |⟨ψ₁|ψ₂⟩|²
-    
+
     For mixed states ρ₁ and ρ₂:
     F(ρ₁, ρ₂) = Tr(√(√ρ₁ ρ₂ √ρ₁))²
-    
+
     Args:
         state1: First quantum state (vector or density matrix)
         state2: Second quantum state (vector or density matrix)
         validate: Whether to validate inputs
-        
+
     Returns:
         Fidelity value between 0 and 1
 
@@ -79,15 +78,15 @@ def trace_distance(
     validate: bool = True
 ) -> float:
     """Calculate trace distance between two quantum states.
-    
+
     For quantum states ρ₁ and ρ₂:
     D(ρ₁, ρ₂) = (1/2) * Tr(|ρ₁ - ρ₂|)
-    
+
     Args:
         state1: First quantum state
-        state2: Second quantum state  
+        state2: Second quantum state
         validate: Whether to validate inputs
-        
+
     Returns:
         Trace distance between 0 and 1
 
@@ -113,20 +112,20 @@ def trace_distance(
 
 def quantum_mutual_information(
     joint_state: np.ndarray,
-    subsystem_dims: Tuple[int, int],
+    subsystem_dims: tuple[int, int],
     validate: bool = True
 ) -> float:
     """Calculate quantum mutual information between two subsystems.
-    
+
     I(A:B) = S(ρₐ) + S(ρᵦ) - S(ρₐᵦ)
-    
+
     where S(ρ) is the von Neumann entropy.
-    
+
     Args:
         joint_state: Joint quantum state of both subsystems
         subsystem_dims: Dimensions of subsystems (dim_A, dim_B)
         validate: Whether to validate inputs
-        
+
     Returns:
         Quantum mutual information
 
@@ -154,18 +153,18 @@ def quantum_mutual_information(
 
 def entanglement_measure(
     state: np.ndarray,
-    subsystem_dims: Tuple[int, int],
+    subsystem_dims: tuple[int, int],
     measure: str = 'negativity',
     validate: bool = True
 ) -> float:
     """Calculate entanglement measure for a bipartite quantum state.
-    
+
     Args:
         state: Quantum state (pure or mixed)
         subsystem_dims: Dimensions of subsystems (dim_A, dim_B)
         measure: Type of measure ('negativity', 'concurrence', 'entropy')
         validate: Whether to validate inputs
-        
+
     Returns:
         Entanglement measure value
 
@@ -185,19 +184,19 @@ def entanglement_measure(
 
 def negativity(
     state: np.ndarray,
-    subsystem_dims: Tuple[int, int]
+    subsystem_dims: tuple[int, int]
 ) -> float:
     """Calculate negativity entanglement measure.
-    
+
     Negativity is defined as:
     N(ρ) = (||ρᵀᴬ||₁ - 1) / 2
-    
+
     where ρᵀᴬ is the partial transpose with respect to subsystem A.
-    
+
     Args:
         state: Quantum state
         subsystem_dims: Dimensions of subsystems
-        
+
     Returns:
         Negativity value
 
@@ -216,16 +215,16 @@ def negativity(
 
 def concurrence(
     state: np.ndarray,
-    subsystem_dims: Tuple[int, int]
+    subsystem_dims: tuple[int, int]
 ) -> float:
     """Calculate concurrence for two-qubit systems.
-    
+
     Note: This implementation is only valid for 2×2 systems.
-    
+
     Args:
         state: Two-qubit quantum state
         subsystem_dims: Should be (2, 2) for two qubits
-        
+
     Returns:
         Concurrence value
 
@@ -259,14 +258,14 @@ def concurrence(
 
 def entanglement_entropy(
     state: np.ndarray,
-    subsystem_dims: Tuple[int, int]
+    subsystem_dims: tuple[int, int]
 ) -> float:
     """Calculate entanglement entropy (von Neumann entropy of reduced state).
-    
+
     Args:
         state: Quantum state
         subsystem_dims: Dimensions of subsystems
-        
+
     Returns:
         Entanglement entropy
 
@@ -281,12 +280,12 @@ def entanglement_entropy(
 
 def von_neumann_entropy(rho: np.ndarray) -> float:
     """Calculate von Neumann entropy of a quantum state.
-    
+
     S(ρ) = -Tr(ρ log ρ)
-    
+
     Args:
         rho: Density matrix
-        
+
     Returns:
         von Neumann entropy
 
@@ -304,16 +303,16 @@ def von_neumann_entropy(rho: np.ndarray) -> float:
 
 def partial_trace(
     rho: np.ndarray,
-    subsystem_dims: Tuple[int, int],
+    subsystem_dims: tuple[int, int],
     trace_out: int
 ) -> np.ndarray:
     """Compute partial trace of a density matrix.
-    
+
     Args:
         rho: Density matrix
         subsystem_dims: Dimensions of subsystems (dim_A, dim_B)
         trace_out: Which subsystem to trace out (0 for A, 1 for B)
-        
+
     Returns:
         Reduced density matrix
 
@@ -345,16 +344,16 @@ def partial_trace(
 
 def partial_transpose(
     rho: np.ndarray,
-    subsystem_dims: Tuple[int, int],
+    subsystem_dims: tuple[int, int],
     transpose_subsystem: int
 ) -> np.ndarray:
     """Compute partial transpose of a density matrix.
-    
+
     Args:
         rho: Density matrix
         subsystem_dims: Dimensions of subsystems
         transpose_subsystem: Which subsystem to transpose (0 for A, 1 for B)
-        
+
     Returns:
         Partially transposed density matrix
 
@@ -367,9 +366,9 @@ def partial_transpose(
         for i in range(dim_A):
             for j in range(dim_A):
                 for k in range(dim_B):
-                    for l in range(dim_B):
+                    for m in range(dim_B):
                         # Transpose indices for subsystem A
-                        rho_TA[i*dim_B + k, j*dim_B + l] = rho[j*dim_B + k, i*dim_B + l]
+                        rho_TA[i*dim_B + k, j*dim_B + m] = rho[j*dim_B + k, i*dim_B + m]
         return rho_TA
 
     elif transpose_subsystem == 1:
@@ -378,9 +377,9 @@ def partial_transpose(
         for i in range(dim_A):
             for j in range(dim_A):
                 for k in range(dim_B):
-                    for l in range(dim_B):
+                    for m in range(dim_B):
                         # Transpose indices for subsystem B
-                        rho_TB[i*dim_B + k, j*dim_B + l] = rho[i*dim_B + l, j*dim_B + k]
+                        rho_TB[i*dim_B + k, j*dim_B + m] = rho[i*dim_B + m, j*dim_B + k]
         return rho_TB
 
     else:
@@ -392,7 +391,7 @@ def _validate_quantum_state(state: np.ndarray) -> None:
     if len(state.shape) == 1:
         # Pure state vector
         if not np.isclose(np.linalg.norm(state), 1.0, atol=1e-10):
-            warnings.warn("State vector is not normalized")
+            warnings.warn("State vector is not normalized", stacklevel=2)
 
     elif len(state.shape) == 2:
         # Density matrix
@@ -401,16 +400,16 @@ def _validate_quantum_state(state: np.ndarray) -> None:
 
         # Check if Hermitian
         if not np.allclose(state, np.conj(state.T), atol=1e-10):
-            warnings.warn("Density matrix is not Hermitian")
+            warnings.warn("Density matrix is not Hermitian", stacklevel=2)
 
         # Check if positive semidefinite
         eigenvals = np.linalg.eigvals(state)
         if np.any(eigenvals < -1e-10):
-            warnings.warn("Density matrix is not positive semidefinite")
+            warnings.warn("Density matrix is not positive semidefinite", stacklevel=2)
 
         # Check trace
         if not np.isclose(np.trace(state), 1.0, atol=1e-10):
-            warnings.warn("Density matrix trace is not 1")
+            warnings.warn("Density matrix trace is not 1", stacklevel=2)
 
     else:
         raise ValueError("Invalid quantum state format")
@@ -433,12 +432,12 @@ def quantum_state_distance(
     metric: str = 'fidelity'
 ) -> float:
     """Calculate distance between quantum states using various metrics.
-    
+
     Args:
         state1: First quantum state
         state2: Second quantum state
         metric: Distance metric ('fidelity', 'trace_distance', 'hilbert_schmidt')
-        
+
     Returns:
         Distance value
 

superquantx/utils/visualization.py

@@ -4,7 +4,7 @@ This module provides functions to visualize quantum circuits, optimization resul
 quantum states, and other quantum machine learning concepts.
 """
 
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 import numpy as np
 
@@ -28,14 +28,14 @@ except ImportError:
 
 
 def visualize_results(
-    results: Dict[str, Any],
+    results: dict[str, Any],
     plot_type: str = 'optimization',
     backend: str = 'matplotlib',
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Visualize quantum machine learning results.
-    
+
     Args:
         results: Results dictionary from algorithm execution
         plot_type: Type of plot ('optimization', 'classification', 'regression')
@@ -60,13 +60,13 @@ def visualize_results(
 
 
 def plot_optimization_history(
-    results: Dict[str, Any],
+    results: dict[str, Any],
     backend: str = 'matplotlib',
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot optimization history from algorithm results.
-    
+
     Args:
         results: Results containing 'cost_history' or similar
         backend: Plotting backend
@@ -95,13 +95,13 @@ def plot_optimization_history(
 
 
 def plot_circuit(
-    circuit_data: Dict[str, Any],
+    circuit_data: dict[str, Any],
     backend: str = 'matplotlib',
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot quantum circuit diagram.
-    
+
     Args:
         circuit_data: Circuit information dictionary
         backend: Plotting backend
@@ -121,11 +121,11 @@ def plot_quantum_state(
     state_vector: np.ndarray,
     backend: str = 'matplotlib',
     representation: str = 'bar',
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot quantum state vector.
-    
+
     Args:
         state_vector: Complex quantum state vector
         backend: Plotting backend
@@ -145,11 +145,11 @@ def plot_quantum_state(
 def plot_bloch_sphere(
     state_vector: np.ndarray,
     backend: str = 'matplotlib',
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot quantum state on Bloch sphere (for single qubit states).
-    
+
     Args:
         state_vector: Single qubit state vector [α, β]
         backend: Plotting backend
@@ -172,9 +172,9 @@ def plot_bloch_sphere(
 
 
 def plot_classification_results(
-    results: Dict[str, Any],
+    results: dict[str, Any],
     backend: str = 'matplotlib',
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot classification results including confusion matrix and metrics."""
@@ -187,9 +187,9 @@ def plot_classification_results(
 
 
 def plot_regression_results(
-    results: Dict[str, Any],
+    results: dict[str, Any],
     backend: str = 'matplotlib',
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot regression results including predictions vs actual."""
@@ -203,8 +203,8 @@ def plot_regression_results(
 
 # Matplotlib implementations
 def _plot_optimization_matplotlib(
-    cost_history: List[float],
-    save_path: Optional[str] = None,
+    cost_history: list[float],
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot optimization history using matplotlib."""
@@ -222,8 +222,8 @@ def _plot_optimization_matplotlib(
 
 
 def _plot_circuit_matplotlib(
-    circuit_data: Dict[str, Any],
-    save_path: Optional[str] = None,
+    circuit_data: dict[str, Any],
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot circuit diagram using matplotlib."""
@@ -240,7 +240,7 @@ def _plot_circuit_matplotlib(
     # Draw gates (simplified representation)
     gate_positions = np.linspace(1, 9, len(gates)) if gates else []
 
-    for pos, gate in zip(gate_positions, gates):
+    for pos, gate in zip(gate_positions, gates, strict=False):
         gate_type = gate.get('type', 'X')
         qubit = gate.get('qubit', 0)
 
@@ -269,7 +269,7 @@ def _plot_circuit_matplotlib(
 def _plot_state_matplotlib(
     state_vector: np.ndarray,
     representation: str,
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot quantum state using matplotlib."""
@@ -298,13 +298,13 @@ def _plot_state_matplotlib(
         phases = np.angle(state_vector)
 
         plt.figure(figsize=(10, 8))
-        scatter = plt.scatter(phases, amplitudes, s=100, alpha=0.7)
+        plt.scatter(phases, amplitudes, s=100, alpha=0.7)
         plt.xlabel('Phase (radians)')
         plt.ylabel('Amplitude')
         plt.title('Quantum State (Phase-Amplitude)')
 
         # Add state labels
-        for i, (phase, amp) in enumerate(zip(phases, amplitudes)):
+        for i, (phase, amp) in enumerate(zip(phases, amplitudes, strict=False)):
             if amp > 0.01:  # Only label significant amplitudes
                 plt.annotate(f'|{i}⟩', (phase, amp), xytext=(5, 5),
                            textcoords='offset points')
@@ -317,7 +317,7 @@ def _plot_state_matplotlib(
 
 def _plot_bloch_matplotlib(
     bloch_vector: np.ndarray,
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot Bloch sphere using matplotlib."""
@@ -360,8 +360,8 @@ def _plot_bloch_matplotlib(
 
 
 def _plot_classification_matplotlib(
-    results: Dict[str, Any],
-    save_path: Optional[str] = None,
+    results: dict[str, Any],
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot classification results using matplotlib."""
@@ -410,8 +410,8 @@ def _plot_classification_matplotlib(
 
 
 def _plot_regression_matplotlib(
-    results: Dict[str, Any],
-    save_path: Optional[str] = None,
+    results: dict[str, Any],
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot regression results using matplotlib."""
@@ -465,8 +465,8 @@ def _plot_regression_matplotlib(
 
 # Plotly implementations (simplified)
 def _plot_optimization_plotly(
-    cost_history: List[float],
-    save_path: Optional[str] = None,
+    cost_history: list[float],
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot optimization history using plotly."""
@@ -475,7 +475,7 @@ def _plot_optimization_plotly(
         y=cost_history,
         mode='lines',
         name='Cost',
-        line=dict(width=3)
+        line={'width': 3}
     ))
     fig.update_layout(
         title='Optimization History',
@@ -490,8 +490,8 @@ def _plot_optimization_plotly(
 
 
 def _plot_circuit_plotly(
-    circuit_data: Dict[str, Any],
-    save_path: Optional[str] = None,
+    circuit_data: dict[str, Any],
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot circuit using plotly (simplified)."""
@@ -514,7 +514,7 @@ def _plot_circuit_plotly(
 def _plot_state_plotly(
     state_vector: np.ndarray,
     representation: str,
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot state using plotly."""
@@ -537,7 +537,7 @@ def _plot_state_plotly(
 
 def _plot_bloch_plotly(
     bloch_vector: np.ndarray,
-    save_path: Optional[str] = None,
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot Bloch sphere using plotly."""
@@ -562,17 +562,17 @@ def _plot_bloch_plotly(
     fig.add_trace(go.Scatter3d(
         x=[0, x], y=[0, y], z=[0, z],
         mode='lines+markers',
-        line=dict(width=5, color='red'),
-        marker=dict(size=8, color='red')
+        line={'width': 5, 'color': 'red'},
+        marker={'size': 8, 'color': 'red'}
     ))
 
     fig.update_layout(
         title='Bloch Sphere',
-        scene=dict(
-            xaxis_title='X',
-            yaxis_title='Y',
-            zaxis_title='Z'
-        )
+        scene={
+            'xaxis_title': 'X',
+            'yaxis_title': 'Y',
+            'zaxis_title': 'Z'
+        }
     )
 
     if save_path:
@@ -582,8 +582,8 @@ def _plot_bloch_plotly(
 
 
 def _plot_classification_plotly(
-    results: Dict[str, Any],
-    save_path: Optional[str] = None,
+    results: dict[str, Any],
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot classification results using plotly."""
@@ -605,8 +605,8 @@ def _plot_classification_plotly(
 
 
 def _plot_regression_plotly(
-    results: Dict[str, Any],
-    save_path: Optional[str] = None,
+    results: dict[str, Any],
+    save_path: str | None = None,
     **kwargs
 ) -> None:
     """Plot regression results using plotly."""

superquantx/version.py

@@ -1,10 +1,10 @@
 """Version information for SuperQuantX."""
 
-__version__ = "0.1.0"
-__version_info__ = (0, 1, 0)
+__version__ = "0.1.1"
+__version_info__ = (0, 1, 1)
 
 # Release information
-__release_date__ = "2024-09-06"
+__release_date__ = "2025-09-11"
 __release_name__ = "Agentic AI Genesis"
 
 # Build information - will be updated during CI/CD

{superquantx-0.1.0.dist-info → superquantx-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superquantx
-Version: 0.1.0
+Version: 0.1.1
 Summary: Quantum AI Research Platform - Unified API for QuantumAgentic AIsystems research
 Project-URL: Homepage, https://github.com/SuperagenticAI/superquantx
 Project-URL: Documentation, https://superagenticai.github.io/superquantx
@@ -8,10 +8,8 @@ Project-URL: Repository, https://github.com/SuperagenticAI/superquantx
 Project-URL: Bug Tracker, https://github.com/SuperagenticAI/superquantx/issues
 Project-URL: Source Code, https://github.com/SuperagenticAI/superquantx
 Project-URL: Changelog, https://github.com/SuperagenticAI/superquantx/blob/main/CHANGELOG.md
-Project-URL: Discussions, https://github.com/SuperagenticAI/superquantx/discussions
-Project-URL: Funding, https://github.com/sponsors/SuperagenticAI
 Author-email: Shashi Jagtap <shashi@super-agentic.ai>, Shashi Jagtap <shashikant.jagtap@icloud.com>, SuperXLab Research Team <research@super-agentic.ai>
-Maintainer-email: Shashi Jagtap <shashi@super-agentic.ai>, Shashi Jagtap <shashikant.jagtap@icloud.com>, SuperXLab Research Team <research@super-agentic.ai>
+Maintainer-email: Shashi Jagtap <shashi@super-agentic.ai>, Shashi Jagtap <shashikant.jagtap@icloud.com>, Superagentic AI Research Team <research@super-agentic.ai>
 License: Apache-2.0
 License-File: LICENSE
 Keywords: agentic-ai,braket,cirq,experimental,pennylane,qiskit,quantum-agents,quantum-algorithms,quantum-computing,quantum-machine-learning,research-platform,unified-api
@@ -123,20 +121,18 @@ Requires-Dist: pytket-qiskit>=0.50.0; extra == 'tket'
 Requires-Dist: pytket>=1.25.0; extra == 'tket'
 Description-Content-Type: text/markdown
 
-<div align="center">
-  <img src="resources/logo.png" alt="SuperQuantX Logo" width="600"/>
-</div>
-
-# SuperQuantX
-
 [![PyPI - Version](https://img.shields.io/pypi/v/superquantx)](https://pypi.org/project/superquantx/)
 [![Python Version](https://img.shields.io/pypi/pyversions/superquantx)](https://pypi.org/project/superquantx/)
-[![License](https://img.shields.io/github/license/SuperagenticAI/superquantx)](https://github.com/SuperagenticAI/superquantx/blob/main/LICENSE)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![Tests](https://github.com/SuperagenticAI/superquantx/workflows/Tests/badge.svg)](https://github.com/SuperagenticAI/superquantx/actions)
-[![Documentation](https://img.shields.io/badge/docs-mkdocs-blue)](#-documentation)
+[![Documentation](https://img.shields.io/badge/docs-mkdocs-blue)](https://superagenticai.github.io/superquantx)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
+# SuperQuantX
+### The foundation for the future of Agentic and Quantum AI
+SuperQuantX unified API for the next wave of Quantum AI. It's a foundation to build powerful Quantum Agentic AI systems with a single interface to Qiskit, Cirq, PennyLane, and more. SuperQuantX is your launchpad into the world of Quantum + Agentic AI.
+
 **Unified Quantum Computing Platform - Building autonomous quantum-enhanced AI systems**
 
 > 📖 **[Read the Full Documentation →](https://superagenticai.github.io/superquantx/)**
@@ -152,6 +148,12 @@ SuperQuantX is a **unified quantum computing platform** that makes quantum algor
 - **🧠 Quantum ML** - Advanced quantum machine learning algorithms and neural networks
 - **⚡ Easy Setup** - Get started in minutes with comprehensive documentation
 
+<div align="center">
+  <a href="https://super-agentic.ai" target="_blank">
+    <img src="resources/logo.png" alt="SuperQuantX Logo" width="500">
+  </a>
+</div>
+
 ## ✨ Key Features
 
 ### **🔗 Universal Quantum Backend Support**
@@ -236,7 +238,7 @@ solution = qaoa.solve()
 The documentation includes comprehensive guides for getting started, detailed API references, tutorials, and examples for all supported quantum backends. Visit the documentation site for:
 
 - **Getting Started** - Installation, configuration, and your first quantum program
-- **User Guides** - Platform overview, backends, and algorithms  
+- **User Guides** - Platform overview, backends, and algorithms
 - **Tutorials** - Hands-on quantum computing and machine learning examples
 - **API Reference** - Complete API documentation with examples
 - **Development** - Contributing guidelines, architecture, and testing
@@ -330,7 +332,7 @@ Help improve our documentation:
 
 ## 📄 License
 
-SuperQuantX is released under the [MIT License](LICENSE). Feel free to use it in your projects, research, and commercial applications.
+SuperQuantX is released under the [Apache License 2.0](LICENSE). Feel free to use it in your projects, research, and commercial applications.
 
 ---
 
@@ -350,13 +352,13 @@ print('✅ SuperQuantX is ready!')
 
 **Ready to explore quantum computing?**
 
-👉 **[Start with the Quick Start Guide →](docs/getting-started/quickstart.md)**
+👉 **[Start with the Quick Start Guide →](https://superagenticai.github.io/superquantx/)**
 
 ---
 
 <div align="center">
 
-**SuperQuantX: Making Quantum Computing Accessible**
+**SuperQuantX: Making Quantum Computing Accessible to all**
 
 *Built with ❤️ by [Superagentic AI](https://super-agentic.ai)*