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