時系列変数
時系列変数は、試行中の各値の変化をtimestampとペアで記録します。これは、試行の終わりに最終値のみをキャプチャするデフォルトの記録モードとは異なります。
試行中に連続的に進化するものを追跡する必要がある場合は、常に時系列変数を使用してください：視線座標、マウスの位置、生理的信号値、または時間の経過と共に変化する応答。
時系列変数の設定
時系列記録は2つの変数プロパティによって制御されます：
- 変数プロパティパネルで、
Record TypeをAll changes / time seriesに設定します。これにより、試行が終了するのを待つのではなく、Labvancedがtimestampを持つ各値の変化をログに記録します。 - データがエクスポートに含まれるように、
Record Variableが有効になっていることを確認してください。
座標や値の配列（視線のx/yなど）を保持する変数に対しては、FormatをArrayに設定します。単一の連続測定（スライダー位置など）にはScalarが適しています。
サンプリング方法
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を使用します。たとえば、ループを介して固定間隔でサンプリングする際です。
列ヘッダー
時系列変数にFormatがArrayに設定されていると、変数プロパティパネルにColumn Headersセクションが表示されます。これを使用して、配列内の各インデックス位置に説明的なラベルを割り当てます。
+ Addラベルの隣にあるColumn Headersをクリックしてヘッダーエントリを追加します。インデックス番号は自動的に表示されますので、その位置のラベルテキストを入力してください。配列に含まれる各インデックスについて繰り返します。
ヘッダーは、その変数の時系列エクスポートファイルの列名として表示されます。これは、各配列位置に異なる意味がある場合、たとえばインデックス1にxをラベル付けし、インデックス2にyをラベル付けするなど、エクスポートされたデータの読みやすさを向上させます。
時系列データの記録方法
変数の値が変化するたびに（またはサンプリング方法に応じて毎サンプル）、Labvancedは以下を保存します：
- 現時点での変数値
- 試行に対するtimestamp
これにより、エクスポートでのサンプルごとに1行が生成され、試行ごとに1行ではなくなります。多くのサンプルを持つ試行は、時系列エクスポートに多くの行を生成します。
データの出力
時系列変数は、通常の試行レベルデータとは別にエクスポートされます。データビューとエクスポートタブでは、2つのデータダウンロードがあります：
- 通常のデータ： 試行ごとに1行、標準変数の最終値をキャプチャします。
- 時系列データ： 記録されたサンプルごとに1行、timestamp列付き。
時系列エクスポート内では、すべての時系列変数を単一ファイルに結合するか（時間順に整理され、各変数ごとに行を交互に）、各変数ごとに別々のファイルとしてエクスポートするかを選択できます。変数のサンプリングレートが異なる場合、各変数ごとに別々のファイルの方が扱いやすくなります。
一般的な使用例
マウストラッキング： 整数配列変数をAll changes / time seriesに設定し、各動作時に現在の位置を記録するためにMouse Moveトリガーが付いたイベントを使用して、試行中にマウスのx/y位置を連続して記録します。
眼球追跡： 眼球追跡システムによって作成された視線座標変数はデフォルトで時系列です。各視線サンプルはtimestampとともに保存され、注視点とスキャンパスのフレームごとの分析が可能です。
生理信号： 連続的生理入力（心拍数、頭の位置）を受信する変数は、試行時間全体を通じて完全な信号が保持されるように時系列として記録されます。
スライダーまたは連続応答： 参加者が試行中にスライダーを動かし、最終位置だけでなくその軌跡をキャプチャしたい場合は、リンクされた変数を時系列記録に設定します。