py4d-browser-h5oina 0.1.0

py4d-browser plugin for loading Oxford Instruments h5oina EBSD pattern files

py4d-browser-h5oina

A py4d-browser plugin for loading Oxford Instruments h5oina EBSD pattern files (.h5oina).

Installation

pip install py4d-browser-h5oina

For files saved with AZtec < 6.3 (h5oina format < v8.0), patterns are LZF-compressed. Install the optional filter plugin to read those files:

pip install py4d-browser-h5oina[lzf]

Usage

Launch py4d-browser as usual:

py4DGUI

A new "Oxford h5oina..." entry appears in the Plugins menu. Click it, select your .h5oina file, and the dataset loads into the browser.

File format support

Feature	Support
Single scan group	✓ — automatic
Multiple scan groups	✓ — prompts to select one
Unprocessed patterns (int16, raw)	✓ — preferred by default
Processed patterns (uint8, background-subtracted)	✓ — selectable
Scan step size (µm) from header	✓ — set as R-space calibration
LZF-compressed patterns (format < v8.0)	✓ — with hdf5plugin installed

Development

git clone https://github.com/ys755/py4d-browser-h5oina
cd py4d-browser-h5oina
pip install -e ".[lzf]"

License

MIT © Yu-Tsun Shao