Pan3D

Pan3D aims to be an utility package for viewing and processing a wide variety of multidimensional datasets. Any dataset that can be interpreted with xarray can be explored and rendered with Pan3D. Read The Doc is available for additional information.

XArray Viewer is a Pan3D application focused on geospatial rendering use cases. This is a graphical user interface leveraging the Pan3D infrastructure to help geospatial scientists explore data.

For an introduction to this project, check out our blog post.

Installation

To install requirements for the Pan3D VTK mesh builder class only:

pip install pan3d

To install requirements for the graphical user interface (viewers + explorers):

pip install "pan3d[viewer]"

Optional: to install requirements for Pangeo and ESGF catalogs, respectively:

pip install "pan3d[pangeo]"

pip install "pan3d[esgf]"

Recommended: To install all requirements, including optional packages:

pip install "pan3d[all]"

Quick Start

xr-viewer is the main entrypoint for launching XArray Viewer locally. Below are some example usages.

To launch XArray Viewer without a target dataset to browse XArray examples:

xr-viewer

To launch XArray Viewer with a local path to a target dataset:

xr-viewer --xarray-file ./examples/example_dataset.nc

To launch XArray Viewer with a remote URL to a target dataset:

xr-viewer --xarray-url https://host.org/link/to/dataset.zarr

To launch XArray Viewer with a compatible configuration file (see examples):

xr-viewer --import-state ./examples/example_config_xarray.json

To launch the Catalog browser will allow you to query the Pangeo and ESGF Dataset Catalogs (see Catalogs Tutorial) depending on the available dependencies:

xr-catalog

You may have to install the required dependencies:

pip install "pan3d[pangeo]"
pip install "pan3d[esgf]"

The xr-viewer entrypoint will automatically launch your default browser to open localhost:8080.

To launch without opening your browser, add the --server argument to your command.

Explorers

Another key component of Pan3D is its modular, web-based 3D visualization system built using trame. This system powers a suite of focused tools called Explorers, designed to be modular, reusable, and easily extended. Each Explorer is built around a specific task—think of them as "one-trick ponies" with clean interfaces tailored to their purpose. This avoids the clutter and complexity of general-purpose tools.

Pan3D currently includes four Explorer tools:

Slice Explorer – Navigate through 3D datasets by extracting 2D slices along any axis. Features interactive slice controls, dual 2D/3D view modes, and the ability to visualize slices within their 3D context using transparency and outlines. Perfect for exploring internal structures of volumetric data.
Globe Explorer – Visualize geographic data on a realistic 3D Earth. Projects latitude/longitude data onto a spherical surface with various texture options (satellite imagery, topography), continental outlines, and terrain elevation effects. Includes specialized camera controls optimized for globe navigation.
Contour Explorer – Generate smooth contour visualizations with color-banded regions between isolevels. Creates both filled contour bands and contour lines, with automatic surface refinement for publication-quality results. Ideal for visualizing scalar fields and identifying data patterns through isosurfaces.
Analytics Explorer – Combines interactive 3D visualization with statistical analysis powered by xCDAT. Provides multiple plot types including zonal averages, time series, and global statistics. Features a side panel with Plotly charts that update based on your 3D data selection, enabling deep data exploration through both visual and quantitative analysis

Launching the Explorers

Similar to the main XArray Viewer (xr-viewer), each explorer can be launched from the command line:

# Launch Slice Explorer
xr-slicer

# Launch Globe Explorer
xr-globe

# Launch Contour Explorer
xr-contour

# Launch Analytics Explorer
xr-analytics

Each explorer will automatically open your default browser to localhost:8080. To launch without opening your browser, add the --server argument to any command.

Tutorials

Examples

Pan3D comes with a set of example configuration files and example Jupyter notebooks in the examples folder. You can checkout the repository to run these locally, or you can use the Pan3D Binder instance to run these examples.

Release files for pan3d 1.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pan3d 1.3.1
File	Size	Uploaded
pan3d-1.3.1.tar.gz	4.3 MB	Apr 27, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pan3d 1.3.1
File	Interpreter	ABI	Platform	Reset
pan3d-1.3.1-py3-none-any.whl 4.3 MB Apr 27, 2026	Python 3	none	any	Details

Total release size: 8.6 MB

Release files / pan3d-1.3.1.tar.gz

Download URL	pan3d-1.3.1.tar.gz
Size	4.3 MB
Tags	Source
SHA-256 checksum How to use checksums	`d8dc40c5be9d688e6c5e15c2ebbfbee4e6e0b6693655b864dc103cbe13849354`
BLAKE2b-256 checksum How to use checksums	`ba3e93ba7462d225f03676842c3a44a962726018b251a0e9e4921bfb193d7c48`
Upload date	Apr 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Kitware/pan3d
Publishing commit: github.com/Kitware/pan3d/tree/e724b56a61bfebfdb72e88c650d29307bf9f8b08

Workflow

Publishing configuration: github.com/Kitware/pan3d/blob/e724b56a61bfebfdb72e88c650d29307bf9f8b08/.github/workflows/test_and_release.yml
Publishing logs: github.com/Kitware/pan3d/actions/runs/25010347461/attempts/1

Artifact

Subject: pan3d-1.3.1.tar.gz
SHA-256 checksum: d8dc40c5be9d688e6c5e15c2ebbfbee4e6e0b6693655b864dc103cbe13849354 Verifying attestations

Release files / pan3d-1.3.1-py3-none-any.whl

Download URL	pan3d-1.3.1-py3-none-any.whl
Size	4.3 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`acf2d06a7e968110dfc659a13fa58477f72b2890d87b0e509039d78af75f6416`
BLAKE2b-256 checksum How to use checksums	`30dcae23aac20a0cad781186652145990208393621e3507649b8e52f389ec5fc`
Upload date	Apr 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Kitware/pan3d
Publishing commit: github.com/Kitware/pan3d/tree/e724b56a61bfebfdb72e88c650d29307bf9f8b08

Workflow

Publishing configuration: github.com/Kitware/pan3d/blob/e724b56a61bfebfdb72e88c650d29307bf9f8b08/.github/workflows/test_and_release.yml
Publishing logs: github.com/Kitware/pan3d/actions/runs/25010347461/attempts/1

Artifact

Subject: pan3d-1.3.1-py3-none-any.whl
SHA-256 checksum: acf2d06a7e968110dfc659a13fa58477f72b2890d87b0e509039d78af75f6416 Verifying attestations