EUC SoH アナライザー

EUC SoH は、電動一輪車（EUC）のバッテリー状態（SoH）を分析するためのツールです。主要な EUC ロギングアプリで記録された走行ログを解析し、バッテリーの健康状態、内部抵抗、長期的な劣化パターンを推定します。

本アプリは完全にデバイス上で動作し、トラッカーやネットワーク接続は一切ありません。AGPL ライセンスの下、完全に無料でオープンソースとして提供されています。

主な機能：

- ストレージを再帰的にスキャンし、WheelLog および EUC World のサブフォルダーと CSV ログファイルを自動的に検出します。

- 走行ログを解析し、受け入れられたファイルと拒否されたファイルを、明確な理由（データポイント不足、Req 計算エラーなど）とともに分類します。

- 等価抵抗（Req）や CUSUM ベースの指標など、バッテリー状態を示す各種メトリクスを計算します。

- MPAndroidChart を用いたインタラクティブなグラフ表示により、抵抗値の変化や SoH の長期的なトレンドを視覚的に確認できます。

- ホイールごとのファイル管理機能：各ホイールに紐づくログを確認し、問題のあるファイルを除外するなど、分析に必要なデータセットのみを管理できます。

- 再販、専門家による診断、メンテナンスなどに活用できる構造化されたアーカイブをエクスポートします。PDF レポート（soh.pdf）、統計サマリー CSV、および対応する WheelLog/EUC World ログを、ホイールごとに整理して出力します。

- 生成された PDF やアーカイブを、メッセージアプリ、メール、クラウドストレージなどに直接共有できます。少ない操作で直感的に使えるよう設計されたユーザーインターフェースを採用しています。

- デフォルトでオフライン動作します。アカウント作成、登録、外部サーバーへの接続は不要です。

一般的な使い方：

1. WheelLog または EUC World のログが保存されているフォルダーをストレージ内でスキャンします。

2. EUC SoH がサブフォルダーを再帰的にスキャンし、互換性のあるすべての CSV ファイルを見つけてホイールごとに分類します。

3. SoH 分析を実行して Req などの関連メトリクスを計算し、生成されたグラフでバッテリーの長期的な劣化状況を確認します。

4. 分析時に受け入れられたログファイルと拒否されたログファイルのリストを確認します。

5. 元のログを含む構造化されたアーカイブとともに PDF レポートをエクスポートし、購入者や技術者との共有、または個人の記録として活用できます。

EUC SoH は、電動一輪車のバッテリー状態について、透明性があり再現可能な診断を必要とする、技術に詳しいライダー、愛好家、修理業者の方々を対象としています。

https://hal.science/hal-05553115 に基づいています。