Metadata-Version: 2.4
Name: quantumclouds
Version: 0.1.0
Summary: A GPU-accelerated 3D atomic orbital visualizer using VisPy and Matplotlib
Author-email: Your Name <your.email@example.com>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.22.0
Requires-Dist: matplotlib>=3.5.0
Requires-Dist: vispy>=0.14.0
Requires-Dist: pyqt6>=6.4.0

# quantumclouds

A high-performance, GPU-accelerated 3D atomic orbital visualizer built entirely in Python using VisPy and Matplotlib.

`quantumclouds` solves the time-independent Schrödinger equation for hydrogen-like atoms analytically, computes the
quantum probability density grids across various subshells, and uses advanced OpenGL blending profiles to render
organic, glowing electron probability clouds that simulate actual quantum behaviors smoothly.

---

## ✨ Features

* **GPU-Accelerated Point Clouds:** Utilizes `VisPy` and custom OpenGL blending equations to render hundreds of
  thousands of probability coordinate points interactively at ultra-high frame rates.
* **Organic Vector Jittering:** Implements real-time coordinates micro-jittering to eliminate artificial box/grid
  banding artifacts, creating perfectly organic-looking orbital shapes.
* **Dynamic Node Phase Animation:** Animates probability cloud frame transitions using quantum azimuthal phase
  velocities based on the magnetic quantum number ($m$).
* **Cross-Section Analysis:** Built-in `plot2d` engine to cut flat slices straight through the 3D grid space for
  classical, precise probability density tracking.
* **Optimized Deep Space Aesthetics:** Defaults completely to the dark, high-contrast `magma` color spectrum to
  emphasize multi-lobed structures cleanly against a space-charcoal backdrop.

---

## 🛠️ Installation

### Prerequisites

* **Python:** `>= 3.9`
* **Operating System:** macOS (Optimized for Apple Silicon / M-Series via PyQt6), Windows, or Linux.

### Installing From PyPI

Once the package is released to the public, you can install it globally with a single command:

```bash
pip install quantumclouds
