数据框变量
数据框变量以电子表格般的结构保存表格数据：行为条目，列为变量，每个变量可以保存字符串、数值、布尔值或文件值。数据框不是通过参与者的回应填充的。您上传一个 .csv 文件以将数据加载到其中，实验在运行时通过事件系统从其读取数据。
数据框是 Labvanced 中管理结构化输入的标准工具：刺激列表、平衡计划、文件与图像映射，以及任何需要一次试验逐行填入准备好的数据的场景。
何时使用数据框
每当您的实验需要加载预先准备好的结构化数据，而不是从参与者收集值时，请使用数据框。
- 您有一个刺激词、句子、图像或音频文件的列表，应逐个试验显示
- 您需要在参与者之间进行条件平衡
- 您希望在实验开始时打乱试验顺序，然后逐步读取条目
- 您正在加载 OpenAI 提示、自定义消息或其他来自准备文件的字符串数据
设置数据框
创建数据框需要三个步骤：准备您的 CSV、创建变量和导入文件。
格式化您的 CSV
您的 CSV 中的每一列都成为数据框中的一个变量（列）。每一行是一个条目。如果您的第一行包含列名，则在导入时启用 Use first row as header。
对于基于文件的刺激（图像、音频），将文件名放入相关的列中。然后，您可以在导入时使用 Map strings to files 将这些名称链接到您研究中上传的文件。
创建数据框变量
- 打开您的研究并转到左侧面板中的 变量 选项卡，或在任务编辑器中打开
Variables面板选项卡。 - 点击
+ New Variable并将Data Type设置为Data Frame。 - 点击
Save。数据框对话框将打开。
上传您的 CSV
在数据框对话框中，点击 Upload 2D CSV Data。文件选择器打开。在您选择文件后，导入选项对话框将出现。
| 选项 | 功能 |
|---|---|
Map strings to files | 将 CSV 中的字符串值视为文件名并将其链接到您研究中上传的文件 |
Use first row as header | 将 CSV 的第一行用作列名，而不是数据 |
Transpose data | 上传数据而不转置行和列 |
点击 Ok 进行导入。数据框将填充您的 CSV 内容。
编辑数据框
创建数据框后，您可以通过新列扩展它、直接编辑单元格值或用新上传的 CSV 替换所有内容。
添加列
在初始导入后添加新列，请在数据框对话框的顶部点击 Add variable / Column。这将添加一个空列，您可以为其命名和配置。如果新列包含文件名，请在对话框中之后点击 Map all strings to files 将其链接到您研究中上传的文件。
编辑单元格值
要直接编辑单元格值，请在数据框对话框中启用 Edit Values 复选框。单元格变得可以就地编辑。禁用复选框以返回只读视图。
在事件系统中使用数据框
数据框通过事件系统进行读取和写入。数据框操作类别中的两个操作处理此任务。
从/写入数据框操作
使用此操作将数据框中的一行或一列读入数组变量，或将值写回去。
关键参数：
| 参数 | 描述 |
|---|---|
| 数据框变量 | 要读取或写入的数据框 |
| 读取或写入 | 操作的方向 |
| 按行或列 | 是否读取整行或整列 |
| 索引类型 | 如何选择行或列：固定值、变量或最后一行 |
| 索引变量 | 当索引类型设置为变量时，使用的变量作为索引 |
| 输出变量 | 存储结果的数组变量 |
最常见的模式是：维护一个每次试验递增的数值计数变量，将其作为索引变量，并将相应的行读入一个数组。数组的每个元素然后映射到该行的一个列。
打乱数据框条目操作
使用此操作随机化数据框中行或列的顺序。在实验开始时运行一次（由会话开始事件触发），在任何试验开始之前。
参数：
| 参数 | 描述 |
|---|---|
| 数据框 | 要打乱的数据框 |
| 按行或列 | 是否打乱行或列的顺序 |
常见工作流程：每次试验的刺激列表
读取每次试验一行刺激的典型设置：
- 上传一个每次试验一行的 CSV，列出每个刺激属性（例如，
word，condition，correct_response）。 - 创建一个数值变量
trial_index，起始值为1，并禁用Reset at Trial Start。 - 在实验开始时，在您的数据框上添加一个
Shuffle Data Frame Entries操作（按行）。 - 在每次试验开始时，添加一个
Read from / Write to Data Frame操作：按行读取，索引变量 =trial_index，输出变量 = 一个数组变量（例如，current_trial_data）。 - 读取后，使用
Set / Record Variable算术操作将trial_index增加1。 - 使用数组变量元素设置对象属性或驱动该试验的事件逻辑。
