变量

描述

在 Labvanced 的实验创建过程中，变量可以用于不同的目的。变量保持并更新的值可由实验者在编辑器中创建，或通过不同方式在实验执行期间生成。值得注意的是，研究中的所有变量都是定义好的，可以在整个实验中全局使用。在主导航面板中有一个“变量”选项卡，其中列出了研究的所有变量。

在任务编辑器中，当前选择的框架上使用的变量在屏幕右上角的“变量”选项卡下列出。在这里，每个变量都显示了其最重要的属性：主要类别、数据类型和名称。变量可以被复制、删除，并选择以检查和更改进一步的属性。在 Labvanced 任务编辑器中，尤其是在事件系统中，有几个地方必须选择变量以达到预期功能。当要求选择变量时，通常可以选择现有的变量，但此时也可以创建一个新变量。您还可以在不选择/使用它的情况下创建一个新变量。这可以通过点击变量选项卡中的“新变量”图标来完成。 variables

对变量的更改可以触发事件，但反之亦然：事件可以更改变量的值。此外，变量可以直接改变某些对象的状态。变量分为五大类：系统变量、因子变量、对象变量、自定义变量和未使用变量。

变量属性

对于每个变量，用户可以确定不同的属性，并提供一个简短的文本描述，总结变量的用途。“名称”和“数据类型”属性是强制性的，而其他属性是可选的，或根据数据类型无法更改。以下是所有属性、其值和描述的列表。

名称

描述：名称在事件、对象中被用作变量的句柄，在复制任务时，在数据视图中也会用到。名称必须是唯一的（不能有两个变量同名）。否则，可能会导致严重错误！名称属性可以在除了系统变量之外的所有变量中更改。
可能的值：任何 ASCII 字符串。

数据类型

描述：变量的数据类型决定了变量可以拥有什么类型的值。数据类型还决定可以对变量应用什么样的数学操作（例如，乘法仅适用于数值变量等）。
可能的值：
- 字符串：变量可以存储任何文本，包括数字、特殊字符等。
- 数值：变量只能存储数值。
- 布尔值：变量只能具有“真”或“假”值。
- 类别：变量具有一组固定的预定义级别，变量值必须是这些级别之一。这主要用于因子变量。
- 日期：变量只能保存格式为（yyyy/mm/dd）的日期值。
- 时间：变量只能保存格式为（小时/分钟/秒）的时间值。
- 文件：变量可以保存图像、视频或音频文件的数据。

量表

描述：变量的量表决定了变量的“测量水平”。这种区分对于具有数值数据类型的变量很有用，并定义了变量值之间的关系。该属性在将来的 Labvanced 扩展中可能会有更多用途，例如分析模块。
可能的值：
- 未定义：没有选择
- 名义：名义尺度值（类别）。
- 有序：有序尺度值（等级）。
- 区间：区间尺度值（没有真实零点的尺度，例如温度）。
- 比例：比例尺度值（有真实零点的尺度，例如体重）。

格式

描述：变量的格式决定了变量是单个（标量）值还是值的数组。一些操作/动作只能应用于数组，而其他则只能应用于标量变量。
可能的值：
- 标量：变量是单一值。
- 数组：变量保持一系列值。
- 数据框：CSV 文件中嵌套有多个变量。选择数据框会打开一个对话框以指定 CSV 数据，其中每列是一个变量。用户可以选择字符串、数值、布尔值或文件作为变量类型。

起始值

描述：变量的起始值决定了变量的默认/重置值。起始值可用于在每次试验开始时将变量的值重置为某个特定值。起始值也可用于在变量中永久存储信息（例如文本、图像、视频或音频数据）。
可能的值：取决于数据类型。使用重置图标以删除起始值。
- 数据格式为“数组”的变量：对于“数组”变量，不仅可以定义一个起始值，还可以用值填充完整的数组。例如，用户可以将单词列表（CSV 文件）、图像、视频、音频文件等上传到数组变量中。数组中的项目/条目的位置也可以调整。

在试验开始时重置

描述：“在试验开始时重置”选项决定变量是否在每个新试验中重置为起始值。通常，对于记录参与者响应或反应时间的变量，应该激活此选项。然而，应累积数据的变量（用于反馈或其他目的）或持久存储信息的数据数组不应重置。
可能的值：如果选中（真），变量将重置为起始值。如果未选中（假），变量将不重置。

记录变量

描述：记录变量选项决定变量是否将被记录。启用该选项的所有变量将在每次试验结束时被记录。
可能的值：如果选中（真），变量将被记录。如果未选中（假），变量将不被记录。

记录类型

描述：变量的记录类型决定了在试验期间变量的所有值变化是否将被记录，还是仅记录每次试验中变量的最终值。如果记录所有变化，每个变量变化都会与时间戳一起保存。此选项可用于记录时间序列数据（例如用于鼠标或眼动追踪）。
可能的值：
- 所有变化 / 时间序列：记录变量的所有变化，包括时间戳。
- 仅最终值：仅在试验结束时记录变量的最后一个值。

系统变量

系统变量对于实验执行和数据导出非常重要。它们是自动创建的，无法修改或删除。系统变量在需求中也非常有用（例如，如果-否则操作）。例如，它们可用于引用特定的试验编号、使用主题计数器，或在多用户研究中区分参与者之间的事件。所有系统变量在 Labvanced 平台的主变量菜单中显示。了解有关系统变量的更多信息。

因子变量

因子变量是与试验系统中的因子相关联的变量。每个因子都有一个与之链接的变量，其数据类型为类别。因子的级别也是变量的可能值状态。在创建新因子时，用户可以选择创建一个新变量（自动）或重用现有变量。在链接因子变量时，需要注意对变量/因子级别的更改会改变所有链接任务/试验组的试验结构。因子变量可以在事件系统中使用，例如创建仅在特定条件下执行的事件（例如，仅当因子“图像类别”等于“房屋”时才执行某项操作）。此外，在实验执行期间的每次试验中，每个因子变量将始终在数据视图中存储一个新的级别值。这样，在查看数据输出或重复程序时，更容易重构每个记录试验的条件。

对象变量

当对象添加到框架中时，会自动创建对象变量。这些变量大多数源于添加“问卷项目”，如复选框、李克特量表、下拉菜单等。在创建此类对象时，您将被要求输入与之关联的变量的名称。在您输入有效（唯一！）名称后，变量将自动创建。在对象属性视图中，您将看到“链接变量”下的相关变量引用。在这里，您也可以将链接/关联更改为其他变量。然而，我们建议谨慎使用此选项。在实验执行中，参与者的响应将存储在变量中。对象变量将默认被记录，大多数对象变量的属性无法更改，以确保其功能。

自定义变量

自定义变量是用户主动创建的。创建自定义变量的原因可能相当多样。它们可以用于记录参与者的决定（鼠标点击或键盘输入）或反应时间。它们也可以用作 while 循环或数组操作中的计数器或索引，用于存储（图像、视频、音频）文件数据，以及许多其他目的。

当变量创建后未被使用，或其使用（对象或事件）被删除时，变量将列为未使用。

数组变量

数组与上述标量变量有很大不同。将数组视为电子表格中的一列：它按指定顺序保存条目。创建数组时，您可以点击“使用 CSV 文件”旁边的文件夹以上传包含信息的一列的 .csv 文件，或者可以使用加号图标手动添加条目。

creating an array variable in the variables tab

有关与数组相关的操作列表，请参见数组操作。

数据框变量

数据框与数组的不同之处在于，如果数组是一列电子表格，数据框则是整张电子表格，包含多个列。数据框可以保存字符串（文本）、数值、布尔值或文件值，但不能在数据框对话框中直接编辑。您可以添加列和文件，但不能输入文本或数字：

data frame dialog box

要添加新的数据框，请点击 上传 2D CSV 数据。在向数据框添加信息时，仅接受 .csv 文件。选择文件后，将出现多个导入选项：

data frame import options

选择所有适用的选项：

将字符串映射到文件 允许您将文件名作为字符串包含，然后使用映射函数指向文件存储的文件夹。这将允许该列的文件名搜索文件夹中的对应文件，前提是数据框中的值与所需文件的名称完全匹配。此功能仅在该列由字符串值填充时可用。
使用第一行作为标题 将数据框第一行的值用作每列的变量名称。
转置数据 只是以原样上传数据框。如果您的数据框不包含任何文件名，这个选项非常有用。

如果您的数据框完全由与文件夹中的文件名称对应的字符串值组成，您可以使用 将所有字符串映射到文件 功能将整个数据框映射到一个文件夹中。

the map icon

要向现有数据框添加更多信息，请在数据框对话框顶部选择 添加变量/列选项。

有关与数据框相关的操作列表，请参见数据框操作。

将图像添加到框架中。
创建一个新事件，并给它命名。
定义触发器以确定何时应设置变量值。例如，选择 --> 用户输入 --> 鼠标触发器。将触发器动作设置为点击，按钮设置为左键。点击“添加目标”旁边的 + 符号，以添加图像作为可点击目标。点击窗口底部的下一步。
选择动作变量操作 --> 设置/记录变量。然后单击“选择”按钮。
点击 “新变量” 选项卡，通过提供名称创建一个新变量（数据类型：数字，重置 = 真，记录 = 真）。点击“确定”。
点击值选择（笔）图标 --> 触发器（鼠标） --> 从框架开始的时间。点击完成。

现在您已保存了点击图像的反应时间。您可以使用类似的过程记录其他属性，例如决定（从多种选项中点击了哪个图像）等。

变量

描述