efa-gui 1.0.11

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

Elliptic Fourier Analysis with GUI in Web Application use it online:

An interactive Streamlit web app for particle shape analysis using EFA (Elliptic Fourier Analysis).

Quick Start

1. Launch App: https://efa-gui.streamlit.app/
2. Download Test Data to test it: test_data.csv (set px/mm = 77)
3. Read Manual: User Manual (PDF)

Recommended Installation Using a Virtual Environment (PowerShell)

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__)"

Automated Self-Test

Before starting the application, run the automated self-test:

efa-gui-self-test

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

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

After the self-test passes, start the application:

efa-gui

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. 10.1016/j.powtec.2026.122435