# EyeLink1000

## experiment

片目を閉じてキャリブレーションすれば，勝手にそっちの目をやってくれる．
キャリブレーション・バリデーションの結果画面のポインタや矢印が緑なら左目になっている．

…目ごとに「サンプリング間隔の」設定を持っているか，初期化されるかが発生している気がする．実験する前にサンプリングレートが変更されていないか，必ず確認．

測定に使う方の目の下にマーカシールを貼ると良い気がする

まばたきの検知（特に開いていく方）うまくできていないのでは？

### 台について
デフォルトでがたついているので，足に何か噛ませて安定させてください．

### サンプリングレートについて
Fを押すとサイレントにサンプリングレートが変更される．毎回必ず確認．

## data reading
- データはホストPC(アイトラッカー側)からダウンロード
- edf2ascという変換ソフトが入っているので， ./edf2asc ./{*file name*}.EDF といった感じで.ascに変換すれば読める
- セパレータはタブ(\t)

以下，EyeLink1000_UserManual.pdfから抜粋・意訳

### 視点ログ

視点ログは下に示す構造で出力されている．
どのオプション{}によって出てきたカラムか一見わからない（詳細はpdf）

レコード + ステータスエラー + ターゲットレコード + ターゲットエラー

#### 視点ログへのタグ付け(4.3.5 Saccadic Thresholds)
The velocity threshold is the eye-movement velocity that must be exceeded for a saccade to be detected. A velocity threshold of 22 degrees per second allows detection of saccades as small as 0.3, ideal for smooth pursuit and psychophysical research. A conservative threshold of 30/sec is better for reading and cognitive research, shortening saccades and lengthening fixation
durations. The larger threshold also reduces the number of microsaccades detected, decreasing the number of short fixations (less than 100 msec in
duration) in the data. Some short fixations (2% to 3% of total fixations) can be expected, and most researchers simply discard these.
Use of eye-movement acceleration is important for detection of small saccades, especially in smooth pursuit. Acceleration data has much more noise than velocity data, and thresholds of 4000/sec2 for small saccade detection and 8000/sec2 for reading and cognitive research are recommended. Lower acceleration thresholds will produce false saccade reports. Acceleration data and thresholds for the EyeLink 1000 system may be larger than those reported for analog eye trackers. These systems use multi-pole filters for noise reductionthat adds delay and smoothes the data, significantly reducing the measured acceleration.
The saccadic motion threshold is used to delay the onset of a saccade until the eye has moved significantly. A threshold of 0.1 to 0.2 is sufficient for shortening saccades. Larger values may be used with caution to eliminate short saccades: for example, a threshold of 0.4 will always merge fixations separated by 0.5 or less, but may eliminate some 1 saccades as well. The
threshold should be set to zero for non-cognitive research, or where statistics such as saccadic duration, amplitude and average velocity are required.

Examples of the commands to set these thresholds are:
**saccade_velocity_threshold** = 30
**saccade_acceleration_threshold** = 8000
**saccade_motion_threshold** = 0.15

**レコード(4.9.2 Sample Line Format)**

- 単眼

<time> <xp> <yp> <ps> {<xv> <yv> <xr> <yr>}

- 両眼

<time> <xpl> <ypl> <psl> <xpr> <ypr> <psr> {<xvl> <yvl> <xvr> <yvr> <xr> <yr>}

<time> : タイムスタンプ(ms)
<xp>, <yp> ： 単眼のモニタ上の位置
<xpl>, <ypl> : 左目のモニタ上の位置
<xpr>, <ypr> : 右目のモニタ上の位置
<ps> : 瞳孔の大きさ(pupil size)
<psl>,<psr> : 左目，右目の瞳孔の大きさ
<xv>, <yv> : 瞬間速度(degrees/sec)
<xvl>, <yvl> : 左目の瞬間速度(degrees/sec)
<xvr>, <yvr> : 右目の瞬間速度(degrees/sec)
<xr>, <yr> : xとyの解像度(position units/degree)

**ステータスエラー(4.9.3.1 Samples Recorded in Corneal Reflection Mode)**

- 単眼CRモードのステータスエラー(warning)
"..." : 問題なし
1文字目が"I"=( I . .) : 補間されたログ
2文字目が"C"=(. C .) : CRが取れなかったログ
3文字目が"R"=(. . R) : CRをrecovery中のログ

- 両眼CRモードのステータスエラー
"....." : 問題なし
1文字目が"I" : 補間されたログ
2文字目が"C" : 左目のCRが取れなかったログ
3文字目が"R" : 左目のCRをrecovery中のログ
4文字目が"C" : 右目のCRが取れなかったログ
3文字目が"R" : 右目のCRをrecovery中のログ

**ターゲットレコード(4.9.3.2 Samples Recorded with the EyeLink Remote)**

<target x> <target y> <target distance>

<target x> : カメラ座標におけるターゲット（眼）のx座標．とれなかったときは"MISSING_DATA" (-32768)が返ってくる．
<target y> : カメラ座標におけるターゲットのy座標．
<target distance> : カメラとターゲットの距離(mm)．とれなかったときは"MISSING_DATA" (-32768)が返ってくる．

**ターゲットエラー(4.9.3.2 Samples Recorded with the EyeLink Remote)**

"............." if no warning for target and eye image
first character is "M" if target is missing
second character is "A" if extreme target angle occurs
third character is "N" if target is near eye so that the target window and eye window overlap
fourth character is "C" if target is too close
fifth character is "F" if target is too far
sixth character is "T" if target is near top edge of the camera image
seventh character is "B" if target is near bottom edge of the camera image
eighth character is "L" if target is near left edge of the camera image
ninth character is "R" if target is near right edge of the camera image
tenth character is "T" if eye is near top edge of the camera image
eleventh character is "B" if eye is near bottom edge of the camera image
twelfth character is "L" if eye is near left edge of the camera image
thirteenth character is "R" if eye is near right edge of the camera image

### 視点ログ以外のログ

**Fixations（凝視点）**

SFIX <eye> <stime>
...
EFIX <eye> <stime> <etime> <dur> <axp> <ayp> <aps> {<xr> <yr>}

**Saccades(サッケード)**

SSACC <eye> <stime>
 ...
ESACC <eye> <stime> <etime> <dur> <sxp> <syp> <exp> <eyp> <ampl> <pv> {<xr> <yr>}

\<eye\> : R(右目)　L(左目)
\<stime\> ： サッケードの開始時(ms)
\<etime\> ： サッケードの終了時(ms)
\<dur\> : etime - stime
\<sxp\>, \<syp\>, \<exp\>, \<eyp\> : サッケードの始点終点のxy座標
\<ampl\> : 視角何度の領域にそのサッケードが収まるか．サッケードの平均速度はこの数値から計算する．(degrees)
\<pv\> : peak velocity，最も早いときの速度.(degrees/sec)
\<xr\>, \<yr\> : オプション．目の位置による角度解像度(?)．X and Y resolution (position units/degree)

**Blinks(まばたき)**

SBLINK <eye> <stime>
　...
EBLINK <eye> <stime> <etime> <dur>

\<eye\> : R(右目)　L(左目)
\<stime\>　：　まばたきの開始時(ms)
\<etime\>　：　まばたきの終了時(ms)
\<dur\> : etime - stime

まばたき期間中（眼が段々と細くなる期間）も視点データは存在．

# monitor

121.0 * 68.0
(別商品だけどサイズ同じ)
https://www.sony.jp/bravia/products/KDL-55HX850/spec.html

モニタから目までの距離
192cm(モニタから壁) + 7(巻き尺) - 20(顔) = 180

7/8, 7/15