EUC State Of Health Analyzer

EUC SoH is a state-of-health (SoH) analysis tool for electric unicycles. It processes ride logs from popular EUC logging apps to estimate battery health, internal resistance, and long-term degradation patterns.

The app runs entirely on-device, without trackers or network access. It is fully free and open source under the AGPL license.

Main features:

• Scan storage recursively to discover WheelLog and EUC World subfolders and CSV log files automatically (optional support for DarknessBot dumps).
• Parse ride logs and separate accepted files from rejected ones, with explicit rejection reasons (e.g. too few data points, invalid Req computation).
• Compute state-of-health metrics such as equivalent resistance (Req) and CUSUM-based indicators.
• Display interactive charts (MPAndroidChart) to visualize resistance evolution and SoH trends over time.
• Maintain per-wheel file management: inspect logs per wheel, exclude problematic files, and keep a clean dataset.
• Export a structured archive for resale, expertise, or maintenance: PDF report (soh.pdf), statistics CSV, and associated logs organized by wheel identifier.
• Share generated PDF and archives directly via messaging apps, email, or cloud storage.
• Work fully offline: no account, no registration, no external server.

Typical workflow:

A - Your own wheel

• Record rides using WheelLog, EUC World, or DarknessBot.
• The app scans storage for folders containing compatible logs.
• If using DarknessBot: export a dump (.dbb) and enable .dbb search in the app.

B - Purchased wheel with EUC SoH archive

• Import the archive into the app.

Start analysis

• Scan subfolders recursively to find compatible CSV files and group them by wheel.
• Run SoH analysis to compute Req and related metrics.
• Inspect charts to evaluate long-term battery degradation.
• Review accepted and rejected log files.
• Export a PDF report and structured archive for sharing or record keeping.

EUC SoH is intended for technically minded riders, enthusiasts, and repair shops who need transparent and reproducible diagnostics for electric unicycle battery health.

Based on: https://hal.science/hal-05553115