ThumbAnalysis

親指の3D点群データをCSVファイルから読み込み、3Dグラフィックスで可視化するPythonプロジェクトです。

機能

• CSVファイルから59列のデータを読み込み、14点の3D座標を抽出
• 点群を3D散布図で表示
• 点同士を接続する線を表示
• 各点の近くに名称を表示
• スライダーを使ってフレームを操作可能
• 軸範囲は全データの範囲を含むように設定

インストール

1. Python 3.14以上をインストールしてください。
2. 仮想環境を作成し、アクティブ化します。

   python -m venv .venv
   .venv\Scripts\activate  # Windowsの場合
   

3. 依存関係をインストールします。

   pip install -e .
   

   または、uvを使用する場合:

   uv sync
   

使用方法

1. CSVファイルをプロジェクトディレクトリに配置します（例: IwasakiThumbRightKapandji03.csv）。
2. スクリプトを実行します。

   python main.py
   

3. 3Dウィンドウが開き、スライダーでフレームを切り替えられます。

CSVファイルの仕様

• 59列のCSVファイル
• 行1: タイトル
• 行2: 設定値
• 行3: 点の名称（"New Subject:名称"形式）
• 行4: ヘッダー（Frame, Sub Frame, X, Y, Z, ...）
• 行5: 単位（mm, mm, mm, ...）
• 行6以降: データ（Frame番号, Sub Frame, X1, Y1, Z1, X2, Y2, Z2, ..., X14, Y14, Z14, ...）

依存関係

• pandas
• matplotlib

ライセンス

このプロジェクトはMITライセンスの下で公開されています。