efa-gui 1.0.8

Interactive Streamlit app for computational elliptic Fourier analysis of particle shapes.

Install from PyPI

Option 1: Quick install

pip install efa-gui
efa-gui-self-test
efa-gui

Option 2: Recommended install in PowerShell with virtual environment

python -m venv env
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\env\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install efa-gui
python -c "import efa_gui; print(efa_gui.__version__)"
efa-gui-self-test
efa-gui

Install in Jupyter / Notebook environment

python -m pip install efa-gui
python -c "import efa_gui; print(efa_gui.__version__)"
efa-gui-self-test
efa-gui

Test the app with sample data

To check that the Streamlit app works correctly, download the sample file:

test_data.csv

Download and drop into framework

Self-test success message

The automated self-test is successful if you see this message:

Self-test passed: sample CSV loaded, Module 3 ran, and reference indices matched.

Citation

If you use this app or code in your work, please cite:

Boribayeva, A., Sultaniyar, S., Lukmanov, I., Baigarina, A., Rojas-SolГіrzano, L. R., Curtis, J. S., Govender N. & Golman, B. (2026). Integrated characterization, classification, and quasi-3D reconstruction of highly irregular particles using multiscale shape descriptors for predictive DEM flow simulation. Powder Technology, 122435.