efa-gui 1.0.0

Computational elliptic Fourier analysis tools for particle shape descriptors.

Computational Elliptic Fourier Analysis

An interactive Streamlit web app for particle shape analysis using EFA.

Quick Start

1. Launch App: computational-elliptic-fourier-analysis-1.streamlit.app
2. Download Test Data: test_data.csv (set px/mm = 77)
3. Read Manual: User Manual (PDF)

Installation

Install the package from PyPI:

pip install efa-gui

Usage

from pathlib import Path

from efa_gui import (
    PARAMS_FIXED,
    compute_shape_indices,
    load_xy_csv,
)

df_xy = load_xy_csv(Path("test_data.csv").read_bytes())
results, errors = compute_shape_indices(df_xy, PARAMS_FIXED)
print(results.head())

For local development:

pip install -e ".[dev]"
python -m build
twine check dist/*

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.