数据框模式

数据框是 Labvanced 中管理实验输入侧最灵活的工具之一。本页面涵盖如何将数据框应用于三种常见的研究设计场景。有关创建和配置数据框的技术参考，请参见 数据框变量。

顺序刺激呈现

数据框最常见的用途是刺激列表：每个试次一行，每个属性（单词、图像文件名、条件、正确反应）一个列。在会话开始时，随机打乱行以随机化试次顺序。然后在每个试次中，将当前行读入数组变量，并使用其值设置对象属性：显示的文本、展示的图像、预期的反应。

关键组件：

• 每个试次一行的数据框
• 开始于 0 的数值 trial_index 变量，禁用 Reset at Trial Start
• 运行 Shuffle Data Frame Entries 的会话开始事件（按行）
• 运行 Read from / Write to Data Frame 的试次开始事件：按行读取，索引变量 = trial_index，输出到数组变量
• 读取后的增量操作：将 1 加入 trial_index

输出数组的每个元素映射到该行的一个列。然后 Set Object Property 操作将每个值分配给数据框上相关的对象。

平衡试次顺序

因为 Shuffle Data Frame Entries 在会话开始时运行且每次的随机打乱不同，每个参与者都能看到从同一组中抽取的独特试次顺序。这是在参与者内的随机化，没有重复。

对于参与者之间的平衡设计，如果您想确保特定条件顺序在参与者之间均匀分布，请结合使用 Labvanced 的组分配和数据框。为每个平衡设计顺序创建一个单独的组，每个组的数据框预先按该条件序列排序。参与者按顺序被分配到组中，平衡样本中的顺序。

有关基于组的平衡设计的完整文档，请参见 随机化和平衡实验设计。

基于文件的刺激

当您的刺激是图像或音频文件而不是文本时，将文件名存储在数据框列中，并在导入时使用 Map strings to files 将每个名称链接到上传的文件。在运行时，Read from / Write to Data Frame 操作返回文件名，Set Object Property 操作使用该文件名交换图像或音频元素所显示的文件。

这种方法将刺激定义（CSV）与刺激传递（事件逻辑）分开，使得通过上传新的 CSV 而不接触事件系统来更新刺激集变得简单明了。

步骤：

1. 准备一个包含文件名的列的 CSV（例如，image_file）。将图像文件单独上传到您的研究中。
2. 创建一个数据框变量并上传 CSV。在导入时启用 Map strings to files 和 Use first row as header。
3. 在每个试次中使用 Read from / Write to Data Frame 将文件名读入数组变量。
4. 添加一个 Set Object Property 操作，目标为图像元素：将其源设置为持有文件名的数组元素。

进一步阅读