Metadata-Version: 2.4
Name: quantum-data-embedding-suite
Version: 1.0.0
Summary: Advanced classical-to-quantum data embedding techniques for quantum machine learning
Home-page: https://github.com/krish567366/quantum-data-embedding-suite
Author: Krishna Bajpai
Author-email: Krishna Bajpai <bajpaikrishna715@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/krish567366/quantum-data-embedding-suite
Project-URL: Documentation, https://krish567366.github.io/quantum-data-embedding-suite
Project-URL: Repository, https://github.com/krish567366/quantum-data-embedding-suite
Project-URL: Issues, https://github.com/krish567366/quantum-data-embedding-suite/issues
Keywords: quantum,machine learning,embedding,qml,quantum computing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary 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
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: license_info.py
Requires-Dist: qiskit>=0.45.0
Requires-Dist: pennylane>=0.32.0
Requires-Dist: numpy>=1.21.0
Requires-Dist: scipy>=1.7.0
Requires-Dist: scikit-learn>=1.0.0
Requires-Dist: matplotlib>=3.5.0
Requires-Dist: seaborn>=0.11.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: tqdm>=4.62.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: click>=8.0.0
Requires-Dist: jupyter>=1.0.0
Requires-Dist: ipywidgets>=7.6.0
Requires-Dist: plotly>=5.0.0
Requires-Dist: scikit-optimize>=0.9.0
Requires-Dist: quantummeta-license>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov>=3.0; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Requires-Dist: flake8>=4.0; extra == "dev"
Requires-Dist: mypy>=0.950; extra == "dev"
Requires-Dist: pre-commit>=2.15; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.4.0; extra == "docs"
Requires-Dist: mkdocs-material>=8.5.0; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.19.0; extra == "docs"
Requires-Dist: mkdocs-jupyter>=0.21.0; extra == "docs"
Requires-Dist: mkdocs-gallery>=0.7.0; extra == "docs"
Provides-Extra: aws
Requires-Dist: amazon-braket-sdk>=1.50.0; extra == "aws"
Provides-Extra: ibm
Requires-Dist: qiskit-ibm-runtime>=0.15.0; extra == "ibm"
Provides-Extra: ionq
Requires-Dist: cirq-ionq>=1.0.0; extra == "ionq"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Quantum Data Embedding Suite

[![PyPI - Version](https://img.shields.io/pypi/v/quantum-data-embedding-suite?color=purple&label=PyPI&logo=pypi)](https://pypi.org/project/quantum-data-embedding-suite/)
[![PyPI Downloads](https://static.pepy.tech/badge/quantum-data-embedding-suite)](https://pepy.tech/projects/quantum-data-embedding-suite)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blacksvg)](https://www.python.org/downloads/)
[![License: Commercial](https://img.shields.io/badge/license-commercial-blueviolet?logo=briefcase)](https://krish567366.github.io/license-server/)
[![Docs](https://img.shields.io/badge/docs-online-blue?logo=readthedocs)](https://krish567366.github.io/quantum-data-embedding-suite/)


A comprehensive Python package for advanced classical-to-quantum data embedding techniques designed to maximize quantum advantage in machine learning applications.

## 🚀 Features

- **Flexible Quantum Feature Maps**: Angle encoding, amplitude encoding, IQP circuits, data re-uploading, and Hamiltonian-based embeddings
- **Quantum Kernel Computation**: Advanced kernel methods with visualization capabilities
- **Comprehensive Metrics**: Expressibility, trainability, and curvature analysis
- **Dimensionality Reduction**: qPCA, quantum SVD, and entanglement-preserving methods
- **Multi-Backend Support**: Qiskit, PennyLane with real QPU compatibility (IBM, IonQ, AWS Braket)
- **Benchmarking Tools**: Performance evaluation across different embedding strategies
- **Interactive CLI**: Rapid experimentation with `qdes-cli`
- **Extensible Architecture**: Plugin support for custom ansätze and optimizers

## 📦 Installation

```bash
pip install quantum-data-embedding-suite
```

For development installation:

```bash
git clone https://github.com/krish567366/quantum-data-embedding-suite.git
cd quantum-data-embedding-suite
pip install -e ".[dev,docs]"
```

## 🎯 Quick Start

```python
from quantum_data_embedding_suite import QuantumEmbeddingPipeline
from sklearn.datasets import load_iris
import numpy as np

# Load data
X, y = load_iris(return_X_y=True)
X = X[:50, :2]  # Use first 50 samples, 2 features

# Create embedding pipeline
pipeline = QuantumEmbeddingPipeline(
    embedding_type="angle",
    n_qubits=4,
    backend="qiskit"
)

# Embed data and compute quantum kernel
quantum_kernel = pipeline.fit_transform(X)

# Evaluate embedding quality
metrics = pipeline.evaluate_embedding(X)
print(f"Expressibility: {metrics['expressibility']:.3f}")
print(f"Trainability: {metrics['trainability']:.3f}")
```

## 🛠️ CLI Usage

```bash
# Quick benchmark on sample data
qdes-cli benchmark --dataset iris --embedding angle --n-qubits 4

# Generate embedding comparison report
qdes-cli compare --embeddings angle,amplitude,iqp --dataset wine

# Visualize quantum kernel
qdes-cli visualize --embedding angle --data my_data.csv --output kernel_plot.png
```

## 📚 Core Components

### Embeddings

- **AngleEmbedding**: Encodes features as rotation angles
- **AmplitudeEmbedding**: Encodes features in quantum state amplitudes
- **IQPEmbedding**: Instantaneous Quantum Polynomial circuits
- **DataReuploadingEmbedding**: Multi-layer feature encoding
- **HamiltonianEmbedding**: Physics-inspired feature maps

### Quantum Kernels

- Fidelity-based kernels
- Projected quantum kernels
- Trainable quantum kernels

### Metrics & Analysis

- Expressibility measurement
- Gradient variance (barren plateau detection)
- Geometric curvature analysis
- Entanglement spectrum analysis

### Dimensionality Reduction

- Quantum Principal Component Analysis (qPCA)
- Quantum Singular Value Decomposition
- Entanglement-preserving projections

## 🎓 Examples

Explore our comprehensive Jupyter notebook examples:

1. **Basic Embeddings**: Introduction to quantum feature maps
2. **Kernel Comparison**: Classical vs quantum kernel performance
3. **Expressibility Analysis**: Understanding embedding expressiveness
4. **Real QPU Usage**: Running on IBM Quantum and IonQ devices
5. **Custom Ansätze**: Building domain-specific embeddings

## 🔧 Advanced Configuration

### Custom Ansatz via YAML

```yaml
ansatz:
  name: "custom_variational"
  layers: 3
  entangling_gates: ["cx", "cz"]
  rotation_gates: ["rx", "ry", "rz"]
  parameter_sharing: "layer_wise"
  
optimization:
  method: "bayesian"
  acquisition: "ei"
  n_calls: 100
```

### Backend Configuration

```python
from quantum_data_embedding_suite.backends import IBMBackend

backend = IBMBackend(
    device="ibmq_qasm_simulator",
    shots=1024,
    optimization_level=3
)
```

## 📊 Benchmarking Results

Our benchmarking suite demonstrates quantum advantage across various datasets:

| Dataset | Classical SVM | Quantum SVM (Angle) | Quantum SVM (IQP) | Improvement |
|---------|---------------|---------------------|-------------------|-------------|
| Iris    | 0.953        | 0.967              | 0.973            | +2.1%       |
| Wine    | 0.944        | 0.961              | 0.956            | +1.8%       |
| Breast Cancer | 0.956   | 0.971              | 0.978            | +2.3%       |

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- Quantum computing frameworks: Qiskit, PennyLane
- Research inspiration from quantum machine learning literature
- Community feedback and contributions

## 📞 Support

- **Documentation**: [Full Documentation](https://krish567366.github.io/quantum-data-embedding-suite)
- **Issues**: [GitHub Issues](https://github.com/krish567366/quantum-data-embedding-suite/issues)
- **Discussions**: [GitHub Discussions](https://github.com/krish567366/quantum-data-embedding-suite/discussions)

---

**Author**: Krishna Bajpai (bajpaikrishna715@gmail.com)  
**Maintainer**: Krishna Bajpai  
**Version**: 0.1.0
