xarray-graph

PyQt UIs for Xarray DataTree including tree view and DataArray slice graphing and processing.

:construction: YouTube videos for tree and graph apps

Contents

• Install
• Apps
  • XarrayDataTreeViewer: Tree UI for an Xarray DataTree.
  • XarrayGraph: Graph/Iterate/Fit/Analyze (x,y) slices of DataArrays in an Xarray DataTree.
• Using Xarray DataTree model/view components in your own app
• Support

Install

Requires a PyQt package. Should work with PySide6 (the official Python Qt binding), PyQt6, or PyQt5 via the QtPy abstraction layer. Note: PySide6>=6.2.2 for Apple silicon support, and PySide6!=6.9.1 due to a bug that is incompatible with pyqtgraph.

Install with uv (recommended):

1. Install the python package manager uv.
2. Download the xarray-graph GitHub repository.
3. In the downloaded repo directory, run the following commands (e.g., in a Terminal or shell):

uv sync
uv pip install "PySide6>=6.2.2,!=6.9.1"

:warning: Although the xarray-graph package is also available via PyPI, 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.

↑ top

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:

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

↑ top

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:

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

↑ top

Using Xarray DataTree model/view components in your own app

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

↑ top

Support

This is all done in my free time. If you find it useful, why not buy me a cup of coffee? Cheers!

↑ top