py4D-browser-transform is a plugin for py4D-browser that provides utility functions for transforming the datacube, currently including flipping, transposing, permuting axes. Other functions like cropping, resampling, and adjusting intensity offsets or scaling might be added in the future.
You can install py4D-browser-transform directly from GitHub using pip or conda:
pip install py4d-browser-transform💡 Note:
- If you install into a fresh Python environment,
py4D-browserandpy4DSTEMwill be automatically installed as dependencies so you don't need to install them first.- If you already have
py4D-browserinstalled, you can install this plugin into the same Python environment.
A step-by-step guide including creating a fresh Python environment via conda would look like this:
conda create -n py4dgui python=3.12
conda activate py4dgui
python -m pip install --upgrade pip
python -m pip cache purge
pip install py4d-browser-transformSimply run the following command to start the browser once you activated the corresponding Python environment:
py4dguiAfter installing this plugin, you should see the "Transform" submenu appear under the "Plugins" menu.
From here, you can:
- Flip or transpose the diffraction pattern.
- Permute dataset axes if your 4D dataset is not in the expected order.
These operations would direcly modify the loaded datacube, but will not affect the raw file stored on disk. You can export the transformed datacube to disk using File > Export Datacube.
💡 Note:
- The order of flipping and permutation matters so if you mix these two operations, you'll have to reverse the operaitons in the exact opposite order to get back to the original state. For example, if you permute and then flip/transpose, you'll have to undo the flip/transpose and then reset the permute.
GNU GPLv3
py4D-browser-transform is open source software distributed under a GPLv3 license. It is free to use, alter, or build on, provided that any work derived from py4D-browser-transform is also kept free and open.