qiskit-qward 0.16.0

A framework for analyzing and validating quantum code execution quality on quantum processing units (QPUs)

QWARD - Quantum Circuit Analysis and Runtime Development

QWARD is a comprehensive framework for analyzing quantum circuits and validating quantum code execution quality on quantum processing units (QPUs). It provides tools to analyze circuit complexity, measure performance metrics, and visualize quantum algorithm behavior.

🚀 Quick Start

from qiskit import QuantumCircuit
from qward import Scanner
from qward.metrics import QiskitMetrics, ComplexityMetrics
from qward.visualization import Visualizer

# Create a quantum circuit
circuit = QuantumCircuit(2)
circuit.h(0)
circuit.cx(0, 1)

# Analyze the circuit
scanner = Scanner(circuit=circuit, strategies=[QiskitMetrics, ComplexityMetrics])
metrics = scanner.calculate_metrics()

# Visualize results
visualizer = Visualizer(scanner=scanner)
dashboards = visualizer.create_dashboard(save=True)

📚 Documentation

For Users

• Project Overview - Learn about QWARD's goals and capabilities
• Installation Guide - Get QWARD up and running
• Beginner's Guide - Start here if you're new to QWARD
• Quickstart Guide - Jump right into using QWARD
• Architecture Overview - Understand QWARD's design and components
• Visualization Guide - Learn about QWARD's visualization capabilities

For Developers

• Developer Guide - Development setup and code quality standards
• Technical Documentation - Deep dive into QWARD's implementation
• Contribution Guidelines - How to contribute to QWARD
• API Documentation - Complete API reference

🎯 Key Features

• Circuit Analysis: Comprehensive metrics for quantum circuit complexity and structure
• Performance Monitoring: Track success rates, fidelity, and execution statistics
• Visualization: Rich, interactive plots and dashboards for metric analysis
• Schema Validation: Type-safe metrics with Pydantic-based validation
• Extensible Architecture: Plugin-based system for custom metrics and visualizations
• Multi-Backend Support: Works with Qiskit Aer, IBM Quantum, and other providers

🛠️ Installation

# Install from PyPI (when available)
pip install qward

# Or install from source
git clone https://github.com/your-org/qiskit-qward.git
cd qiskit-qward
pip install -e .

📖 Examples

Explore comprehensive examples in the qward/examples/ directory:

• Basic Usage - Complete workflow examples
• Circuit Performance - Performance analysis
• Visualization Demo - Visualization capabilities
• Aer Integration - Using QWARD with Qiskit Aer

🤝 Contributing

We welcome contributions! Please see our Contribution Guidelines for details on:

• Setting up the development environment
• Code style and quality standards
• Testing requirements
• Submitting pull requests

📄 License

This project is licensed under the Apache License 2.0.

🔗 Links

• Documentation: docs/
• Examples: qward/examples/
• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

QWARD is designed to help quantum developers and researchers understand and optimize their quantum algorithms through comprehensive analysis and visualization tools.