数据框变量

数据框变量以类电子表格的结构保存表格数据：行是条目，列是变量，每个变量可以保存字符串、数字、布尔值或文件值。数据框不是通过参与者的响应填充的。您上传一个.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. 创建一个起始值为0，并且Reset at Trial Start禁用的数字变量trial_index。
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. 使用数组变量的元素设置对象属性或驱动该次试验的事件逻辑。

进一步阅读

数据框操作

在运行时读取、写入和随机化数据框的事件系统操作。

变量类型

所有六种变量类型及其使用场合的参考。

变量属性

每个变量设置的完整参考：数据类型、规模、格式、起始值、重置行为和记录选项。

数据框模式

如何将数据框应用于常见研究设计：顺序刺激呈现、抗衡和基于文件的刺激。

随机化与抗衡

如何利用数据框、试验系统和事件对您的研究进行抗衡和随机化。

变量操作

变量操作节的中心页面：类型、属性、记录选项和数据框。