Metadata-Version: 2.4
Name: qphase-viz
Version: 1.0.0
Summary: Visualization plugin for QPhase: Phase Portraits and PSD Analysis
Project-URL: Homepage, https://github.com/PolarisMegrez/qphase
Project-URL: Repository, https://github.com/PolarisMegrez/qphase
Project-URL: Issues, https://github.com/PolarisMegrez/qphase/issues
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: matplotlib>=3.6
Requires-Dist: numpy>=1.23
Requires-Dist: scipy>=1.10
Requires-Dist: qphase>=1.0.0
Requires-Dist: qphase-sde>=1.0.0
Dynamic: license-file

# qphase-viz

**Plotting Utilities for QPhase**

`qphase-viz` provides a set of plotting tools for visualizing data from quantum phase-space simulations. It is designed to work with `qphase` but can also be used independently to generate figures.

## Features

- **Phase Portraits**:
    - **Re-Im Plane**: Visualize distributions in complex phase space.
    - **Abs-Abs Plane**: Analyze amplitude correlations.
    - **Marginal Distributions**: Project dynamics onto axes.
- **Spectral Analysis**:
    - **Power Spectral Density (PSD)**: Compute spectra with windowing.
    - **Log/Linear Scaling**: Flexible axis options.
- **Time Series**:
    - **Trajectory Evolution**: Plot stochastic paths and averages.
    - **Confidence Intervals**: Visualize variance/std-dev.

## Installation

```bash
pip install qphase-viz
```

## Usage

### As a QPhase Plugin
Add a visualization job to your `qphase` configuration:

```yaml
jobs:
  - name: "plot_phase"
    type: "viz"
    dependencies: ["my_simulation"]
    config:
      plots:
        - kind: "phase_plane"
          mode: 0
          style: "density"
        - kind: "spectrum"
          source: "output.npy"
```

### Standalone Usage
```python
from qphase_viz.engine import VizEngine
from qphase_viz.config import PhasePlaneConfig

# Configure and run
config = PhasePlaneConfig(mode=0)
engine = VizEngine()
engine.plot(data, config)
```

## License

MIT License
