タイムシリーズ変数

タイムシリーズ変数は、試行中のすべての値の変化を記録し、各変化にはタイムスタンプが付与されます。これは、試行の最後に最終値のみをキャプチャするデフォルトの記録モードとは異なります。

試行中に継続的に進化する何かを追跡する必要がある場合は、タイムシリーズ変数を使用します：視線座標、マウス位置、生理信号値、または時間経過と共に変化する応答など、単一の離散的な結果を生成するのではなく、常に変化するものです。

タイムシリーズ変数の設定

タイムシリーズ記録は、2つの変数プロパティによって制御されます：

1. 変数プロパティパネルでRecord TypeをAll changes / time seriesに設定します。これにより、Labvancedは試行が終了するまで待機するのではなく、各値の変化をタイムスタンプ付きで記録します。
2. データがエクスポートに含まれるように、Record Variableが有効になっていることを確認します。

座標や値の配列（視線のx/yなど）を保持する変数の場合、FormatをArrayに設定します。単一の連続的な測定（スライダーの位置など）の場合は、Scalarが適切です。

サンプリング方法

Record TypeがAll changes / time seriesに設定されている場合、変数プロパティパネルにSampling methodオプションが表示されます。これは、連続する重複値の処理方法を制御します。

デフォルトは、変数形式によって異なります：スカラー変数はデフォルトでrecord changes only、配列変数はデフォルトでrecord allです。これは、各タイプの最も一般的な使用パターンに一致します。

変数の更新頻度が低く、データ量を最小限に抑えたい場合はrecord changes onlyを使用します。サンプル間に値が変化するかどうかに関係なく、完全で均等な間隔のタイムシリーズが必要な場合はrecord allを使用します。例えば、ループを介して固定間隔でサンプリングする場合などです。

タイムシリーズデータの記録方法

変数の値が変化するたび（またはサンプリング方法に応じて毎回）、Labvancedは次のものを保存します：

• その時点での変数値
• 試行に対するタイムスタンプ

これにより、エクスポートではサンプルごとに1行が生成され、試行ごとに1行ではありません。多くのサンプルを持つ試行は、タイムシリーズエクスポートに多くの行を生成します。

データ出力

タイムシリーズ変数は、通常の試行レベルデータとは別にエクスポートされます。データビュー＆エクスポートタブには、次の2つのデータダウンロードがあります：

• 通常データ： 試行ごとに1行、標準変数の最終値をキャプチャします。
• タイムシリーズデータ： 記録されたサンプルごとに1行、タイムスタンプ列付き。

タイムシリーズエクスポート内では、すべてのタイムシリーズ変数を1つのファイルにまとめる（時間で整理され、変数ごとに交互に行が続く）か、各変数のために別々のファイルをエクスポートすることを選択できます。異なるサンプリングレートを持つ変数の場合、変数ごとの別ファイルの方が作業しやすいです。

一般的な使用例

マウス追跡： 数値配列変数をAll changes / time seriesに設定し、各動きで現在の位置を書くためにMouse Moveトリガーを持つイベントを使用して、試行中にマウスのx/y位置を連続的に記録します。

視線追跡： 視線追跡システムによって作成された視線座標変数はデフォルトでタイムシリーズです。各視線サンプルはそのタイムスタンプと共に保存され、注視点やスキャンパスのフレーム毎の分析が可能です。

生理信号： 連続的な生理的入力（心拍数、頭の位置）を受け取る変数は、試行の長さにわたって完全な信号が保存されるように、タイムシリーズとして記録されます。

スライダーまたは連続応答： 参加者が試行中にスライダーを動かし、最終的な位置だけでなく軌跡をキャプチャしたい場合は、リンクされた変数をタイムシリーズ記録に設定します。

さらなる読み物