時系列変数{/examples/}
時系列変数は、試行中の各値の変化をタイムスタンプとペアで記録します。これは、試行が終了した時点でのみ最終値をキャプチャするデフォルトの記録モードとは異なります。
試行中に連続して進化する何かを追跡する必要がある場合は、時系列変数を使用してください：視線座標、マウスの位置、生理信号の値、または時間とともに変化する応答。
時系列変数の設定{/examples/}
時系列記録は、2つの変数プロパティによって制御されます：
- 変数プロパティパネルで、
Record TypeをAll changes / time seriesに設定します。これにより、Labvancedは試行が終了するのを待たずに、各値の変化をタイムスタンプ付きでログに記録します。 - データがエクスポートに含まれるように
Record Variableが有効であることを確認してください。
座標や値の配列を保持する変数（例えば視線の x/y）の場合は、Format を Array に設定します。単一の連続測定（スライダーの位置など）の場合は、Scalar が適切です。
サンプリング方法{/examples/}
Record Type が All changes / time series に設定されていると、変数プロパティパネルに Sampling method オプションが表示されます。これにより、重複する連続値の扱いが制御されます。
| オプション | 説明 |
|---|---|
record changes only (no repeated duplicates) | 値が変化したときのみ新しいデータポイントを記録します。連続する重複値はスキップされます。 |
record all (allow repeated duplicates) | 繰り返しの値を含めて、各サンプル間隔でデータポイントを記録します。 |
デフォルトは変数フォーマットに依存します：スカラー変数はデフォルトで record changes only、配列変数はデフォルトで record all です。これは各型の最も一般的な使用パターンに合致しています。
変数の更新が稀で、データ量を最小限に抑えたい場合は record changes only を使用してください。サンプル間で値が変わるかどうかに関係なく、均等に間隔を置いた時系列が必要な場合は record all を使用してください。例えば、ループを通じて固定間隔でサンプリングする場合です。
列ヘッダー{/examples/}
時系列変数に Format が Array に設定されている場合、変数プロパティパネルに Column Headers セクションが表示されます。これを使用して、配列の各インデックス位置に説明的なラベルを割り当てます。
Column Headers ラベルの隣にある + Add をクリックして、ヘッダーエントリを追加します。インデックス番号は自動的に表示されます。その位置のラベルテキストを入力してください。配列に含まれる各インデックスについて繰り返します。
ヘッダーは、その変数の時系列エクスポートファイルの列名として表示されます。これは、各配列位置に固有の意味がある場合にエクスポートされたデータを読みやすくします。例えば、インデックス1を x とラベル付けし、インデックス2を y として、座標ペア配列を示します。
時系列データの記録方法{/examples/}
変数の値が変化するたびに（またはサンプリング方法に応じて毎回）、Labvancedは次の情報を保存します：
- その時点での変数の値
- 試行に関連するタイムスタンプ
これにより、エクスポートにおいてサンプルごとに1行を生成します。多くのサンプルを持つ試行は、時系列エクスポートで多くの行を生成します。
データ出力{/examples/}
時系列変数は通常の試行レベルデータとは別にエクスポートされます。 データビュー＆エクスポート タブでは、2つのデータダウンロードがあります：
- 通常データ： 試行ごとに1行、標準変数の最終値をキャプチャします。
- 時系列データ： 記録されたサンプルごとに1行、タイムスタンプ列があります。
時系列エクスポート内では、すべての時系列変数を単一ファイル（時間順に整理され、変数ごとに交互の行）にまとめるか、各変数の別々のファイルをエクスポートすることを選択できます。変数ごとの別々のファイルは、変数が異なるサンプリングレートを持つ場合、作業が容易です。
一般的な使用例{/examples/}
マウス追跡： 計数配列変数を All changes / time series に設定し、移動のたびに現在の位置を書き込む Mouse Move トリガーを持つイベントを使用することで、試行中にマウスの x/y 位置を連続的に記録します。
眼球追跡： 眼球追跡システムによって作成された視線座標変数は、デフォルトで時系列です。各視線サンプルはタイムスタンプとともに保存され、注視点やスキャンパスのフレームごとの分析が可能です。
生理信号： 連続的な生理的入力（心拍数、頭の位置）を受信する変数は、試行期間中に全信号が保存されるように時系列として記録されます。
スライダーまたは連続応答： 参加者が試行中にスライダーを動かし、その軌道をキャプチャしたい場合、単に最終位置ではなく、リンクされた変数を時系列記録に設定します。
