数据框模式

数据框是 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 操作，目标为图像元素：将其源设置为持有文件名的数组元素。

深入阅读