Metadata-Version: 2.4
Name: canopy-viewer
Version: 0.1.4
Summary: NiceGUI app for creating canopy figures from JSON config
Author-email: "David M. Belda" <david.belda@kit.edu>, Adrien Damseaux <adrien.damseaux@kit.edu>
License: MPL-2.0
Keywords: canopy,visualization,nicegui,dgvm,lsm
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: nicegui>=1.4.0
Requires-Dist: seaborn>=0.12.0
Requires-Dist: matplotlib>=3.7.0
Requires-Dist: pywebview
Requires-Dist: canopy-tools<0.12.0,>=0.11.0
Provides-Extra: linux-native
Requires-Dist: qtpy; extra == "linux-native"
Requires-Dist: PyQt6; extra == "linux-native"

# Canopy Viewer

NiceGUI app for creating canopy figures from JSON config. Select fields, configure options, and generate maps, time series, distributions, and more.

## Installation

**pip** (recommended):

```bash
pip install canopy-viewer
```

On Linux, add `[linux-native]` for native window support (no system packages needed):

```bash
pip install canopy-viewer[linux-native]
```

## Run

```bash
canopy-viewer
```

### Linux

On Linux, native mode needs Qt or GTK. If you see `WebViewException: You must have either QT or GTK...`:

**Option A – Run in browser** (no extra deps):

```bash
canopy-viewer --browser
```

**Option B – Native window via pip** (recommended):

```bash
pip install canopy-viewer[linux-native]
```
