概要
Pupil Labsとは視線計測装置である．Pupil Labsを用いて視線計測をした際に出力される様々なデータの見方を説明していく．
また，この投稿は未完成であり，さらなる情報が分かり次第更新していく．
ファイル構成
記録されたファイルは以下のような構成になっている
- 20XX_XXXX(自分で指定することができるフォルダ)
|- 00X(記録した順に001から番号が割り当てられるフォルダ)
|-- info.csv
|-- user_info.csv
|-- world.mp4
|-- eye0.mp4
|-- world_timestamps.npy
|-- ey0_timestamps.npy
|-- camera_calibration
|-- pupil_data
|-- exports(勝手に作られるフォルダ)
|--- pupil_gaze_positions_info.csv
|--- pupil_postions.csv
|--- gaze_positions.csv
各ファイルの説明
| ファイル名 | 説明 |
|---|---|
| info.csv | ファイルのメタデータが記録されたファイル |
| user_info.csv | 記録したユーザ情報を記録するためのファイル(自分で編集する) |
| world.mp4 | 外側カメラの映像情報※ |
| eye0.mp4 | 内側カメラの映像情報※ |
| world_timestamps.npy | 外側カメラの映像のタイムスタンプ※ |
| ey0_timestamps.npy | 内側カメラの映像のタイムスタンプ※ |
| camera_calibration | キャリブレーション情報が記録されたファイル |
| pupil_data | Pythonから見ることができる生データ |
| pupil_gaze_positions_info.txt | 各パラメータの説明が記載されたファイル |
| pupil_postions.csv | 瞳孔の詳細情報が記録されたファイル |
| gaze_positions.csv | 視線の詳細情報が記録されたファイル |
| ※Pupil Playerを用いてしか見ることができない(と思う) |
各ファイルの詳細説明
ここでは各ファイル(全てではない)の詳細説明を行う．
info.csv
記録時のメタデータが記録されている
| パラメータ名 | 説明 |
|---|---|
| System Info | 録画したPCのユーザ名，機種名などが記録されている |
| World Camera Resolution | 外側カメラの解像度 |
| Start Time | 録画開始時間 |
| Duration Time | 録画時間 |
| Data Format Version | データフォーマットのバージョン |
| Recording Name | 記録されたフォルダ名 |
| World Camera Frames | 外側カメラの総フレーム数 |
| Start Date | 録画した日付 |
| Capture Software Version | 録画したソフトのバージョン |
user_info.csv
記録したユーザの情報を記録するためのファイル(自分で書く)
| パラメータ名 | 説明 |
|---|---|
| name | 記録したユーザの名前 |
| additional_dield | その他情報(あれば) |
pupil_postions.csv
内側カメラによる様々な情報が記録されている．
不明または曖昧な部分は?マークがついています．
| パラメータ名 | 説明 |
|---|---|
| timestamp | 映像フレームのタイムスタンプ |
| index | ビデオのフレーム数? |
| id | 0:右眼，1:左眼 |
| confidence | 瞳孔検出の精度を表す．0が全く信頼できず．1は完全なデータである．0.6より大きい値の時に有用なデータとして使用してよい |
| norm_pos_x | 映像における眼のx座標 |
| norm_pos_y | 映像における眼のy座標 |
| diameter | 映像における瞳孔の直径 |
| method | 瞳孔を検出する方法※1 |
| ellipse_center_x | 瞳の中心のx座標 |
| ellipse_center_y | 瞳の中心のy座標 |
| ellipse_axis_a | 楕円の長軸の長さ |
| ellipse_axis_b | 楕円の短軸の長さ |
| ellipse_angle | 楕円の角度※2 |
| diameter_3d | mmに変換された瞳孔の直径? |
| model_confidence | 眼の認識の信頼性(0 or 1) |
| sphere_center_x | 3次元の眼球の中心のx座標 |
| sphere_center_y | 3次元の眼球の中心のy座標 |
| sphere_radius | 3次元の眼球の半径(常に12mmである) |
| circle_3d_center_x | 3次元の瞳孔の中心のx座標(単位はmm) |
| circle_3d_center_y | 3次元の瞳孔の中心のy座標 |
| circle_3d_center_z | 3次元の瞳孔の中心のz座標 |
| circle_3d_normal_x | 3次元の瞳孔の正常時のx座標 |
| circle_3d_normal_y | 3次元の瞳孔の正常時のy座標 |
| circle_3d_normal_z | 3次元の瞳孔の正常時のz座標 |
| circle_3d_radius | 3次元の瞳孔の半径(diameterと同じ) |
| theta | ? |
| phi | ? |
| projected_sphere_center_x | ? |
| projected_sphere_axis_a | ? |
| projected_sphere_axis_b | ? |
| projected_sphere_angle | ? |
| ※1：検出方法はXX，XX，XXのX種類ある． | |
| ※2：ここでの角度はこんな感じ． |
gaze_positions.csv
外側カメラによる様々な情報が記録されている．
不明または曖昧な部分は?マークがついています．
| パラメータ名 | 説明 |
|---|---|
| timestamp | 映像フレームのタイムスタンプ |
| index | ビデオのフレーム数? |
| confidence | 信頼度(0(信頼性なし) or 1(信頼性あり)) |
| norm_pos_x | 映像における眼のx座標 |
| norm_pos_y | 映像における眼のy座標 |
| base_data | ? |
| gaze_point_3d_x | 見ている点のx座標(1人称目線) |
| gaze_point_3d_y | 見ている点のy座標 |
| gaze_point_3d_z | 見ている点のz座標 |
| eye_center0_3d_x | 外側カメラから算出した眼球の中心のx座標 |
| eye_center0_3d_y | 外側カメラから算出した眼球の中心のy座標 |
| eye_center0_3d_z | 外側カメラから算出した眼球の中心のz座標 |
| gaze_normal0_x | ? |
| gaze_normal0_y | ? |
| gaze_normal0_z | ? |
| eye_center1_3d_x | eye_center0と同様 |
| eye_center1_3d_y | eye_center0と同様 |
| eye_center1_3d_z | eye_center0と同様 |
| gaze_normal1_x | eye_center0と同様 |
| gaze_normal1_y | eye_center0と同様 |
| gaze_normal1_z | eye_center0と同様 |
| ※3：パラメータのXXX1というものは両目対応のデバイスを用いるときに値が記録される(Pupil Labsでは記録されない) |
PythonでRaw_dataを見る方法
今後書く予定