Pupil Labsのデータの見方 

#概要
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を見る方法
今後書く予定