xarray-graph 0.2.5__tar.gz → 2026.7.1__tar.gz

xarray_graph-2026.7.1/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.3
+Name: xarray-graph
+Version: 2026.7.1
+Summary: PyQt UIs for Xarray DataTree including tree view and DataArray slice graphing and processing.
+Keywords: xarray,DataTree,tree,PyQt,PySide,pyqtgraph,graph,plot,signal processing,n-dimensional
+Author: Marcel Goldschen-Ohm
+Author-email: Marcel Goldschen-Ohm <goldschen-ohm@utexas.edu>
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Dist: xarray>=2025.3.1
+Requires-Dist: h5netcdf
+Requires-Dist: zarr
+Requires-Dist: scipy
+Requires-Dist: pint
+Requires-Dist: lmfit
+Requires-Dist: qtpy
+Requires-Dist: qtawesome
+Requires-Dist: pyqtgraph
+Requires-Dist: qtconsole
+Requires-Dist: cmap
+Requires-Dist: requests
+Requires-Dist: pint-xarray>=0.5.1
+Requires-Dist: cf-xarray>=0.10.6
+Requires-Dist: cftime
+Requires-Python: >=3.10
+Project-URL: homepage, https://github.com/marcel-goldschen-ohm/xarray-graph
+Project-URL: repository, https://github.com/marcel-goldschen-ohm/xarray-graph
+Project-URL: issues, https://github.com/marcel-goldschen-ohm/xarray-graph/issues
+Description-Content-Type: text/markdown
+
+# xarray-graph
+PyQt UIs for Xarray DataTree including tree view and DataArray slice graphing and processing.
+
+![GitHub Tag](https://img.shields.io/github/v/tag/marcel-goldschen-ohm/xarray-graph?cacheSeconds=1)
+![build-test](https://github.com/marcel-goldschen-ohm/xarray-graph/actions/workflows/build-test.yml/badge.svg)
+![GitHub Release](https://img.shields.io/github/v/release/marcel-goldschen-ohm/xarray-graph?include_prereleases&cacheSeconds=1)
+![publish](https://github.com/marcel-goldschen-ohm/xarray-graph/actions/workflows/publish.yml/badge.svg)
+
+:construction: YouTube videos for tree and graph apps
+
+## Contents
+- [Install](#install)
+- Apps
+    - [XarrayDataTreeViewer](#xarraydatatreeviewer): Tree UI for an Xarray DataTree.
+    - [XarrayGraph](#xarraygraph): Graph/Iterate/Fit/Analyze (x,y) slices of DataArrays in an Xarray DataTree.
+- [Using Xarray DataTree model/view components in your own app](#using-xarray-datatree-modelview-components-in-your-own-app)
+- [Support](#support)
+
+## Install
+Requires a PyQt package. Should work with PySide6 (the official Python Qt binding), PyQt6, or PyQt5 via the [QtPy](https://github.com/spyder-ide/qtpy) abstraction layer. *Note: PySide6>=6.2.2 for Apple silicon support, and PySide6!=6.9.1 due to a [bug](https://github.com/pyqtgraph/pyqtgraph/issues/3328) that is incompatible with pyqtgraph.*
+
+### Install with uv (recommended):
+1. Install the python package manager [uv](https://github.com/astral-sh/uv).
+2. Download the [xarray-graph GitHub repository](https://github.com/marcel-goldschen-ohm/xarray-graph). <!-- *I suggest downloading the latest release version.* -->
+3. In the downloaded repo directory, run the following commands (e.g., in a Terminal or shell):
+```shell
+uv sync
+uv pip install "PySide6>=6.2.2,!=6.9.1"
+```
+
+:warning: Although the `xarray-graph` package is also available via [PyPI](https://pypi.org/project/xarray-graph/), this package is currently NOT up-to-date and should NOT be used at the moment. For now, please use uv to install from the latest repo as instructed above.
+
+<!--
+### Install with pip (optional):
+---
+Install latest release version:
+```shell
+pip install --upgrade xarray-graph
+pip install "PySide6>=6.2.2,!=6.9.1"
+```
+Or install latest development version:
+```shell
+pip install --upgrade xarray-graph@git+https://github.com/marcel-goldschen-ohm/xarray-graph
+pip install "PySide6>=6.2.2,!=6.9.1"
+```
+-->
+
+[&uarr; top](#xarray-graph)
+
+## XarrayDataTreeViewer
+Tree UI for an Xarray DataTree.
+
+:rocket: To **launch the application**, run the following command (e.g., in a Terminal or shell) in the downloaded repo directory:
+```shell
+uv run xarray-tree
+```
+:bangbang: *Note: The first time you run the app it may take 30-60 seconds to start due to loading of graphics libraries, so be patient. Subsequent runs should start in only a few seconds.*
+
+:construction: YouTube video
+
+[&uarr; top](#xarray-graph)
+
+## XarrayGraph
+Graph/Iterate/Fit/Analyze (x,y) slices of DataArrays in an Xarray DataTree.
+
+:rocket: To **launch the application**, run the following command (e.g., in a Terminal or shell) in the downloaded repo directory:
+```shell
+uv run xarray-graph
+```
+:bangbang: *Note: The first time you run the app it may take 30-60 seconds to start due to loading of graphics libraries, so be patient. Subsequent runs should start in only a few seconds.*
+
+:construction: YouTube video
+
+[&uarr; top](#xarray-graph)
+
+## Using Xarray DataTree model/view components in your own app
+```python
+import xarray as xr
+from xarray_graph.tree import XarrayDataTreeModel, XarrayDataTreeView
+
+dt = xr.DataTree(...)
+
+model = XarrayDataTreeModel()
+model.setDatatree(dt)
+
+view = XarrayDataTreeView()
+view.setModel(model)
+
+# place view widget in your app as desired
+```
+
+[&uarr; top](#xarray-graph)
+
+## Support
+This is all done in my free time. If you find it useful, why not buy me a cup of coffee? Cheers!
+
+<a href="https://www.buymeacoffee.com/marcel.goldschen.ohm" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
+
+[&uarr; top](#xarray-graph)

xarray_graph-2026.7.1/README.md

@@ -0,0 +1,99 @@
+# xarray-graph
+PyQt UIs for Xarray DataTree including tree view and DataArray slice graphing and processing.
+
+![GitHub Tag](https://img.shields.io/github/v/tag/marcel-goldschen-ohm/xarray-graph?cacheSeconds=1)
+![build-test](https://github.com/marcel-goldschen-ohm/xarray-graph/actions/workflows/build-test.yml/badge.svg)
+![GitHub Release](https://img.shields.io/github/v/release/marcel-goldschen-ohm/xarray-graph?include_prereleases&cacheSeconds=1)
+![publish](https://github.com/marcel-goldschen-ohm/xarray-graph/actions/workflows/publish.yml/badge.svg)
+
+:construction: YouTube videos for tree and graph apps
+
+## Contents
+- [Install](#install)
+- Apps
+    - [XarrayDataTreeViewer](#xarraydatatreeviewer): Tree UI for an Xarray DataTree.
+    - [XarrayGraph](#xarraygraph): Graph/Iterate/Fit/Analyze (x,y) slices of DataArrays in an Xarray DataTree.
+- [Using Xarray DataTree model/view components in your own app](#using-xarray-datatree-modelview-components-in-your-own-app)
+- [Support](#support)
+
+## Install
+Requires a PyQt package. Should work with PySide6 (the official Python Qt binding), PyQt6, or PyQt5 via the [QtPy](https://github.com/spyder-ide/qtpy) abstraction layer. *Note: PySide6>=6.2.2 for Apple silicon support, and PySide6!=6.9.1 due to a [bug](https://github.com/pyqtgraph/pyqtgraph/issues/3328) that is incompatible with pyqtgraph.*
+
+### Install with uv (recommended):
+1. Install the python package manager [uv](https://github.com/astral-sh/uv).
+2. Download the [xarray-graph GitHub repository](https://github.com/marcel-goldschen-ohm/xarray-graph). <!-- *I suggest downloading the latest release version.* -->
+3. In the downloaded repo directory, run the following commands (e.g., in a Terminal or shell):
+```shell
+uv sync
+uv pip install "PySide6>=6.2.2,!=6.9.1"
+```
+
+:warning: Although the `xarray-graph` package is also available via [PyPI](https://pypi.org/project/xarray-graph/), this package is currently NOT up-to-date and should NOT be used at the moment. For now, please use uv to install from the latest repo as instructed above.
+
+<!--
+### Install with pip (optional):
+---
+Install latest release version:
+```shell
+pip install --upgrade xarray-graph
+pip install "PySide6>=6.2.2,!=6.9.1"
+```
+Or install latest development version:
+```shell
+pip install --upgrade xarray-graph@git+https://github.com/marcel-goldschen-ohm/xarray-graph
+pip install "PySide6>=6.2.2,!=6.9.1"
+```
+-->
+
+[&uarr; top](#xarray-graph)
+
+## XarrayDataTreeViewer
+Tree UI for an Xarray DataTree.
+
+:rocket: To **launch the application**, run the following command (e.g., in a Terminal or shell) in the downloaded repo directory:
+```shell
+uv run xarray-tree
+```
+:bangbang: *Note: The first time you run the app it may take 30-60 seconds to start due to loading of graphics libraries, so be patient. Subsequent runs should start in only a few seconds.*
+
+:construction: YouTube video
+
+[&uarr; top](#xarray-graph)
+
+## XarrayGraph
+Graph/Iterate/Fit/Analyze (x,y) slices of DataArrays in an Xarray DataTree.
+
+:rocket: To **launch the application**, run the following command (e.g., in a Terminal or shell) in the downloaded repo directory:
+```shell
+uv run xarray-graph
+```
+:bangbang: *Note: The first time you run the app it may take 30-60 seconds to start due to loading of graphics libraries, so be patient. Subsequent runs should start in only a few seconds.*
+
+:construction: YouTube video
+
+[&uarr; top](#xarray-graph)
+
+## Using Xarray DataTree model/view components in your own app
+```python
+import xarray as xr
+from xarray_graph.tree import XarrayDataTreeModel, XarrayDataTreeView
+
+dt = xr.DataTree(...)
+
+model = XarrayDataTreeModel()
+model.setDatatree(dt)
+
+view = XarrayDataTreeView()
+view.setModel(model)
+
+# place view widget in your app as desired
+```
+
+[&uarr; top](#xarray-graph)
+
+## Support
+This is all done in my free time. If you find it useful, why not buy me a cup of coffee? Cheers!
+
+<a href="https://www.buymeacoffee.com/marcel.goldschen.ohm" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
+
+[&uarr; top](#xarray-graph)

xarray_graph-2026.7.1/pyproject.toml

@@ -0,0 +1,46 @@
+[project]
+name = "xarray-graph"
+version = "v2026.7.1"
+description = "PyQt UIs for Xarray DataTree including tree view and DataArray slice graphing and processing."
+authors = [
+    {name = "Marcel Goldschen-Ohm", email = "goldschen-ohm@utexas.edu"},
+]
+readme = "README.md"
+keywords = ["xarray", "DataTree", "tree", "PyQt", "PySide", "pyqtgraph", "graph", "plot", "signal processing", "n-dimensional"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3 :: Only",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "xarray >=2025.3.1",
+    "h5netcdf",
+    "zarr",
+    "scipy",
+    "pint",
+    "lmfit",
+    "QtPy",
+    "QtAwesome",
+    "pyqtgraph",
+    "qtconsole",
+    "cmap",
+    "requests",
+    "pint-xarray>=0.5.1",
+    "cf-xarray>=0.10.6",
+    "cftime",
+]
+
+[project.urls]
+homepage = "https://github.com/marcel-goldschen-ohm/xarray-graph"
+repository = "https://github.com/marcel-goldschen-ohm/xarray-graph"
+issues = "https://github.com/marcel-goldschen-ohm/xarray-graph/issues"
+
+[project.scripts]
+xarray-graph = "xarray_graph.__main__:xgraph"
+xarray-tree = "xarray_graph.__main__:xtree"
+
+[build-system]
+requires = ["uv_build"]
+build-backend = "uv_build"

xarray_graph-2026.7.1/src/xarray_graph/__main__.py

@@ -0,0 +1,85 @@
+from qtpy.QtCore import QSize, QTimer
+from qtpy.QtGui import QPixmap, Qt
+from qtpy.QtWidgets import QApplication, QSplashScreen
+from qtawesome import icon
+
+
+def show_ui_and_close_splash(ui, splash: QSplashScreen):
+    ui.show()
+    splash.finish(ui)
+
+
+def xtree():
+    app = QApplication()
+    app.setQuitOnLastWindowClosed(False)
+
+    splash_pix: QPixmap = icon('ph.cube-thin').pixmap(QSize(256, 256))
+    splash = QSplashScreen(splash_pix, Qt.WindowType.WindowStaysOnTopHint)
+    splash.show()
+    splash.showMessage("xarray-tree: Loading system resources...", Qt.AlignmentFlag.AlignBottom | Qt.AlignmentFlag.AlignCenter, Qt.GlobalColor.white)
+    app.processEvents() # Force Qt to paint the splash screen immediately
+
+    from xarray_graph.apps import XarrayDataTreeViewer
+
+    ui = XarrayDataTreeViewer.new()
+    ui.setWindowTitle('xarray-tree')
+    QTimer.singleShot(2000, lambda: show_ui_and_close_splash(ui, splash))
+
+    show_warnings()
+    load_datatree(ui, 'https://raw.githubusercontent.com/marcel-goldschen-ohm/xarray-graph/main/examples/ERPdata.nc', ask=True)
+    return app.exec()
+
+
+def xgraph():
+    app = QApplication()
+    app.setQuitOnLastWindowClosed(False)
+
+    splash_pix: QPixmap = icon('ph.cube-thin').pixmap(QSize(256, 256))
+    splash = QSplashScreen(splash_pix, Qt.WindowType.WindowStaysOnTopHint)
+    splash.show()
+    splash.showMessage("xarray-graph: Loading system resources...", Qt.AlignmentFlag.AlignBottom | Qt.AlignmentFlag.AlignCenter, Qt.GlobalColor.white)
+    app.processEvents() # Force Qt to paint the splash screen immediately
+
+    from xarray_graph.apps import XarrayGraph
+
+    ui = XarrayGraph.new()
+    ui.setWindowTitle('xarray-graph')
+    QTimer.singleShot(2000, lambda: show_ui_and_close_splash(ui, splash))
+
+    show_warnings()
+    load_datatree(ui, 'https://raw.githubusercontent.com/marcel-goldschen-ohm/xarray-graph/main/examples/ERPdata.nc', ask=True)
+    return app.exec()
+
+
+def show_warnings() -> None:
+    import platform
+    if platform.system() == 'Darwin':
+        from qtpy.QtWidgets import QMessageBox
+        QMessageBox.warning(None, 'Magnet Warning', 'If you are using the window management software Magnet, please disable it for this app to work properly.')
+
+
+def load_datatree(ui, url: str = 'https://raw.githubusercontent.com/marcel-goldschen-ohm/xarray-graph/main/examples/ERPdata.nc', ask: bool = True) -> None:
+    import requests, io
+    import xarray as xr
+    from qtpy.QtWidgets import QMessageBox
+    from xarray_graph.apps import XarrayDataTreeViewer # ui: XarrayDataTreeViewer
+
+    if ask:
+        answer = QMessageBox.question(ui, 'Example?', 'Load example data?')
+    if (ask == False) or (answer == QMessageBox.StandardButton.Yes):
+        try:
+            req = requests.get(url, stream=True)
+            if req.status_code != 200:
+                raise ValueError(f'Failed to download example data: request status code = {req.status_code}')
+            dt: xr.DataTree = xr.open_datatree(io.BytesIO(req.content), engine='h5netcdf')
+            ui.setDatatree(dt)
+            ui._datatree_view.showAll()
+        except Exception as err:
+            QMessageBox.critical(ui, 'Failed to load example', str(err))
+
+
+if __name__ == '__main__':
+    import sys
+    # status = xtree()
+    status = xgraph()
+    sys.exit(status)