wings-quantum 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. wings_quantum-0.1.0/CHANGELOG.md +67 -0
  2. wings_quantum-0.1.0/DOCUMENTATION.md +901 -0
  3. wings_quantum-0.1.0/LICENSE.txt +21 -0
  4. wings_quantum-0.1.0/MANIFEST.in +35 -0
  5. wings_quantum-0.1.0/Makefile +239 -0
  6. wings_quantum-0.1.0/PKG-INFO +491 -0
  7. wings_quantum-0.1.0/README.md +437 -0
  8. wings_quantum-0.1.0/pyproject.toml +231 -0
  9. wings_quantum-0.1.0/setup.cfg +4 -0
  10. wings_quantum-0.1.0/src/wings/__init__.py +251 -0
  11. wings_quantum-0.1.0/src/wings/adam.py +132 -0
  12. wings_quantum-0.1.0/src/wings/ansatz.py +207 -0
  13. wings_quantum-0.1.0/src/wings/benchmarks.py +605 -0
  14. wings_quantum-0.1.0/src/wings/campaign.py +661 -0
  15. wings_quantum-0.1.0/src/wings/cli.py +377 -0
  16. wings_quantum-0.1.0/src/wings/compat.py +132 -0
  17. wings_quantum-0.1.0/src/wings/config.py +443 -0
  18. wings_quantum-0.1.0/src/wings/convenience.py +259 -0
  19. wings_quantum-0.1.0/src/wings/evaluators/__init__.py +19 -0
  20. wings_quantum-0.1.0/src/wings/evaluators/cpu.py +72 -0
  21. wings_quantum-0.1.0/src/wings/evaluators/custatevec.py +783 -0
  22. wings_quantum-0.1.0/src/wings/evaluators/gpu.py +220 -0
  23. wings_quantum-0.1.0/src/wings/export.py +243 -0
  24. wings_quantum-0.1.0/src/wings/optimizer.py +1898 -0
  25. wings_quantum-0.1.0/src/wings/paths.py +295 -0
  26. wings_quantum-0.1.0/src/wings/py.typed +2 -0
  27. wings_quantum-0.1.0/src/wings/results.py +255 -0
  28. wings_quantum-0.1.0/src/wings/types.py +14 -0
  29. wings_quantum-0.1.0/src/wings_quantum.egg-info/PKG-INFO +491 -0
  30. wings_quantum-0.1.0/src/wings_quantum.egg-info/SOURCES.txt +43 -0
  31. wings_quantum-0.1.0/src/wings_quantum.egg-info/dependency_links.txt +1 -0
  32. wings_quantum-0.1.0/src/wings_quantum.egg-info/entry_points.txt +2 -0
  33. wings_quantum-0.1.0/src/wings_quantum.egg-info/requires.txt +29 -0
  34. wings_quantum-0.1.0/src/wings_quantum.egg-info/top_level.txt +1 -0
  35. wings_quantum-0.1.0/tests/__init__.py +1 -0
  36. wings_quantum-0.1.0/tests/conftest.py +441 -0
  37. wings_quantum-0.1.0/tests/integration/__init__.py +1 -0
  38. wings_quantum-0.1.0/tests/integration/test_integration.py +421 -0
  39. wings_quantum-0.1.0/tests/unit/__init__.py +1 -0
  40. wings_quantum-0.1.0/tests/unit/test_ansatz.py +215 -0
  41. wings_quantum-0.1.0/tests/unit/test_campaign.py +395 -0
  42. wings_quantum-0.1.0/tests/unit/test_config.py +273 -0
  43. wings_quantum-0.1.0/tests/unit/test_evaluators.py +547 -0
  44. wings_quantum-0.1.0/tests/unit/test_export.py +268 -0
  45. wings_quantum-0.1.0/tests/unit/test_optimizer.py +516 -0
wings_quantum-0.1.0/CHANGELOG.md ADDED
@@ -0,0 +1,67 @@
1
+ # Changelog
2
+
3
+ All notable changes to WINGS will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [Unreleased]
9
+
10
+ ### Added
11
+ - Initial public release
12
+
13
+ ## [0.1.0] - 2026-02-03
14
+
15
+ ### Added
16
+
17
+ #### Core Features
18
+ - `GaussianOptimizer` class for variational quantum state preparation
19
+ - Support for multiple target wavefunctions: Gaussian, Lorentzian, hyperbolic secant, and custom functions
20
+ - High-precision optimization achieving fidelities > 0.999999999
21
+ - Parameter-shift rule for exact analytic gradients
22
+
23
+ #### Ansatz Support
24
+ - `DefaultAnsatz` with hardware-efficient RY + CNOT structure
25
+ - `CustomHardwareEfficientAnsatz` with configurable entanglement patterns (linear, circular, full)
26
+ - `AnsatzProtocol` for implementing custom ansatze
27
+
28
+ #### GPU Acceleration
29
+ - NVIDIA cuStateVec integration via cuQuantum
30
+ - Qiskit Aer GPU backend support
31
+ - Multi-GPU parallelization for large-scale optimization
32
+ - Automatic backend selection with fallback
33
+
34
+ #### Optimization Methods
35
+ - L-BFGS-B quasi-Newton optimization
36
+ - Adam optimizer with warm restarts
37
+ - Basin hopping for global optimization
38
+ - Multi-stage adaptive pipelines
39
+
40
+ #### Campaign Management
41
+ - `CampaignConfig` for large-scale optimization campaigns
42
+ - `OptimizationManager` for running thousands of optimizations
43
+ - Automatic checkpointing and resume functionality
44
+ - Configurable strategy distribution
45
+
46
+ #### Utilities
47
+ - Cross-platform path configuration for HPC clusters
48
+ - Comprehensive benchmarking suite
49
+ - Command-line interface (`gso`)
50
+ - Result visualization and export
51
+
52
+ ### Dependencies
53
+ - Qiskit >= 1.0
54
+ - NumPy >= 1.20
55
+ - SciPy >= 1.7
56
+ - Optional: cuQuantum, CuPy for GPU support
57
+
58
+ ---
59
+
60
+ ## Version Numbering
61
+
62
+ - **MAJOR**: Incompatible API changes
63
+ - **MINOR**: New functionality (backward compatible)
64
+ - **PATCH**: Bug fixes (backward compatible)
65
+
66
+ [Unreleased]: https://github.com/yourusername/wings/compare/v0.1.0...HEAD
67
+ [0.1.0]: https://github.com/yourusername/wings/releases/tag/v0.1.0