数据框模式
数据框是Labvanced中管理实验输入方面的最灵活工具之一。本页介绍如何将它们应用于三种常见的研究设计场景。有关创建和配置数据框的技术参考，请参见数据框变量。
顺序刺激呈现
数据框最常见的使用是刺激列表：每个试验一行，每个属性（单词、图像文件名、条件、正确反应）一列。在会话开始时，随机打乱行以随机化试验顺序。然后在每个试验中，将当前行读入数组变量，并利用其值设置对象属性：显示的文本，显示的图像，预期的反应。
关键组件：
- 一个每个试验一行的数据框
- 一个以
trial_index开始的数值变量，从1，并且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无需触摸事件系统即可轻松更新刺激集。
步骤：
- 准备一个CSV，列中包含文件名（例如，
image_file）。将图像文件单独上传到你的研究中。 - 创建一个数据框变量并上传CSV。在导入时启用
Map strings to files和Use first row as header。 - 在每个试验中使用
Read from / Write to Data Frame将文件名读入到数组变量中。 - 添加一个
Set Object Property操作，目标是图像元素：将其源设置为保存文件名的数组元素。
