数据框变量

数据框变量以电子表格式结构保存表格数据：行是条目，列是变量，每个变量可以保存字符串、数值、布尔值或文件值。数据框不是通过参与者的响应填充的。您上传一个 .csv 文件以加载数据，然后实验在运行时使用事件系统从中读取数据。

数据框是Labvanced中管理结构化输入的标准工具：刺激列表、平衡计划、文件到图像的映射，以及任何需要一次将准备好的数据行逐个馈送到实验中的情景。

何时使用数据框

每当您的实验需要加载预先准备好的结构化数据，而不是从参与者收集值时，请使用数据框。

• 您有一个刺激词、句子、图像或音频文件的列表，应该逐次出现
• 您需要在参与者之间进行条件平衡
• 您想在实验开始时打乱试验顺序，然后顺序读取条目
• 您正在加载OpenAI提示、自定义消息或其他字符串数据，从准备好的文件中

设置数据框

创建数据框需要三个步骤：准备CSV，创建变量，并导入文件。

格式化您的CSV

您的CSV中的每一列在数据框中都会变成一个变量（列）。每一行是一个条目。如果您的第一行包含列名，请在导入时启用 Use first row as header。

对于基于文件的刺激（图像、音频），请将文件名放在相关列中。然后，您可以在导入时使用 Map strings to files 将这些名称链接到您研究中上传的文件。

创建数据框变量

1. 打开您的研究并进入左侧面板中的 变量 标签，或在任务编辑器中打开 Variables 面板标签。
2. 点击 + New Variable 并将 Data Type 设置为 Data Frame。
3. 点击 Save。数据框对话框打开。

上传您的CSV

在数据框对话框中，点击 Upload 2D CSV Data。文件选择器打开。选择文件后，导入选项对话框出现。

点击 Ok 进行导入。数据框将填充您的CSV内容。

编辑数据框

创建数据框后，您可以通过新增列、直接编辑单个单元格值或用新的CSV上传替换所有内容来扩展它。

添加列

要在初始导入后添加新列，请在数据框对话框顶部点击 Add variable / Column。这将添加一个空列，您可以命名并配置。如果新列包含文件名，请在对话框中随后点击 Map all strings to files 以将其链接到您研究中上传的文件。

编辑单元格值

要直接编辑单个单元格值，请在数据框对话框中启用 Edit Values 复选框。单元格将变得可就地编辑。禁用复选框将返回只读视图。

在事件系统中使用数据框

数据框通过事件系统进行读取和写入。数据框操作类别中的两个操作处理此功能。

从/写入数据框操作

使用该操作将数据框中的一行或一列读取到数组变量中，或将值写回。

关键参数：

最常见的模式是：维护一个数值计数器变量，每次试验递增，使用它作为索引变量，并将相应的行读取到数组中。然后，数组的每个元素映射到该行的一列。

打乱数据框条目操作

使用该操作随机化数据框中行或列的顺序。在实验开始时（通过会话开始事件触发），在任何试验开始之前运行该操作。

参数：

常见工作流程：每次试验的刺激列表

每次试验读取一行刺激的典型设置：

1. 上传一个每行一个试验的CSV，列出每个刺激属性（例如，word, condition, correct_response）。
2. 创建一个数值变量 trial_index，初始值为 0，并禁用 Reset at Trial Start。
3. 在实验开始时，在数据框上添加一个 Shuffle Data Frame Entries 操作（按行）。
4. 在每次试验开始时，添加一个 Read from / Write to Data Frame 操作：按行读取，索引变量 = trial_index，输出变量 = 数组变量（例如，current_trial_data）。
5. 读取后，使用 Set / Record Variable 算术操作使 trial_index 增加 1。
6. 使用数组变量元素设置对象属性或驱动该试验的事件逻辑。

进一步阅读