xdmfviewer 0.1.0

Standalone PyVista/Qt viewer for XDMF result files

xdmfviewer

A standalone desktop viewer for XDMF time-series results based on PyVista and Qt.

Features

• Interactive visualization of XDMF time steps
• Point and cell field selection
• Scalar component selection (scalar, vector, tensor)
• Warp-by-vector rendering (manual opt-in)
• Animation playback and export (GIF/MP4)
• Screenshot export
• Hover tooltip inspection

Installation

Install from PyPI:

pip install xdmfviewer[qt]

For development, clone the repository and install in editable mode:

git clone <repository-url>
cd xdmfviewer
pip install -e ".[qt,dev]"

Windows release

Tagged releases publish a per-user MSI installer as a GitHub release asset. Download the .msi file from the release page and run it normally; it installs into your user profile.

The release workflow is triggered by version tags such as v0.1.0.

Usage

After installation:

xdmfviewer

Or via module:

python -m xdmfviewer

Then open an .xdmf file from the GUI.

Dependencies

Core runtime dependencies are declared in pyproject.toml:

• numpy
• pyvista
• pyvistaqt
• qtpy

You also need a Qt binding, for example one of:

• PySide6
• PyQt6
• PyQt5

The recommended install extra for this project is qt, which currently pulls in PySide6.

Acknowledgments

This project was developed with assistance from Claude (Anthropic) and GitHub Copilot.

License

This project is licensed under the GNU Lesser General Public License v3 or later (LGPL-3.0-or-later). See LICENSE.