变量
描述
变量可用于 Labvanced 实验创建过程中的不同目的。变量保存并更新由实验者在编辑器中创建或在实验执行过程中通过不同方式生成的值。重要的是，研究中的所有变量都是定义好的，可以在整个实验中全局使用。主导航面板中有一个“变量”选项卡，列出了研究的所有变量。
在任务编辑器中，当前选择的框架上使用的变量列在屏幕右上角的“变量”选项卡下。这里，每个变量都显示其最重要的属性：主要类别、数据类型和名称。变量可以被复制、删除，并被选中以检查和更改其他属性。在 Labvanced 任务编辑器中，尤其是在事件系统中，有几个地方需要选择变量以实现所需功能。当要求您选择一个变量时，通常可以选择一个现有的变量，但您也可以在那时创建一个新变量。您也可以独立于选择/使用它创建一个新变量。这可以通过单击变量选项卡中的“新变量”图标来完成。 
对变量所做的更改可以触发事件，但反之亦然：事件可以更改变量的值。此外，变量可以直接改变某些对象的状态。变量被分为五个主要类别：系统变量、因子变量、对象变量、自定义变量和未使用变量。
变量属性
对于每个变量，用户可以确定不同的属性，并提供一个简短的文本描述，概述变量的用途。“名称”和“数据类型”属性是强制性的，而其他属性是可选的，或根据数据类型不可更改。以下是所有属性、其值和描述的列表。
名称
- 描述：名称作为变量在事件、对象中、在复制任务时以及在数据视图中使用的句柄。名称必须唯一（不能有两个变量同名）。否则，可能会发生严重错误！名称属性可以在所有变量中更改，系统变量除外。
- 可能值：任何 ASCII 字符串。
数据类型
- 描述：变量的数据类型决定了变量可以具有哪种类型的值。数据类型还决定了可以对变量应用哪些数学操作（例如，仅在数值变量上可进行乘法运算）。
- 可能值：
- 字符串：变量可以存储任何文本，包括数字、特殊字符等。
- 数值：变量只能存储数值。
- 布尔：变量只能具有“真”或“假”值。
- 类别：变量有一组固定的预定义水平，变量值必须是这些水平之一。这主要用于因子变量。
- 日期：变量只能以格式（yyyy/mm/dd）保存日期值。
- 时间：变量只能保存格式（小时/分钟/秒）的时间值。
- 文件：变量可以保存图像、视频或音频文件的数据。
规模
- 描述：变量的规模决定了变量的“测量水平”。这种区别对具有数值数据类型的变量非常有用，并定义了变量值之间的关系。该属性在 Labvanced 未来扩展（例如分析模块）中可能有更多用途。
- 可能值：
- 未定义：未选择
- 名义：名义尺度值（类别）。
- 顺序：顺序尺度值（排序）。
- 间隔：间隔尺度值（没有真正零点的尺度，例如温度）。
- 比率：比率尺度值（具有真正零点的尺度，例如体重）。
格式
- 描述：变量的格式决定了变量是单一（标量）值还是一系列值。有些操作/动作仅可以应用于数组，而有些则仅適用於标量变量。
- 可能值：
- 标量：变量是单一值。
- 数组：变量持有一系列值。
- 数据框：CSV 文件中包含多个变量。当选择数据框时，会打开一个对话框来指定 CSV 数据，文件中的每一列都是一个变量。用户可以选择字符串、数值、布尔或文件作为变量类型。
启动值
- 描述：变量的启动值决定了变量的默认/重置值。启动值可以在每次实验开始时将变量的值重置为某一特定值。启动值还可以用于在变量中永久存储信息（例如文本、图像、视频或音频数据）。
- 可能值：取决于数据类型。使用重置图标移除起始值。
- 数据格式为“数组”的变量：对于“数组”变量，您不仅可以定义一个起始值，还可以用值填充整个数组。例如，用户可以将一组单词（CSV 文件）、图像、视频、音频文件等上传到数组变量中。数组中条目的位置也可以调整。
在试验开始时重置
- 描述：“在试验开始时重置”选项确定变量是否会在每次新试验时重置为起始值。通常，对于记录参与者反应或反应时间的变量，应该激活此选项。然而，累积试验数据的变量（用于反馈或其他目的）或持久存储信息的数据数组不应重置。
- 可能值：如果选中（真），变量将重置为启动值。如果未选中（假），变量将不会重置。
记录变量
- 描述：记录变量选项决定变量是否将被记录。启用此选项的所有变量将在每次试验结束时被记录。
- 可能值：如果选中（真），变量将被记录。如果未选中（假），变量将不会被记录。
记录类型
- 描述：变量的记录类型决定了在试验期间变量的所有值变化是否会被记录，或者仅记录每次试验中变量的最终值。如果记录所有更改，每个变量更改将会连同时间戳一起保存。此选项可用于记录数据的时间序列（例如，对于鼠标或眼动追踪）。
- 可能值：
- 所有更改/时间序列：记录变量的所有更改，包括时间戳。
- 仅最终值：仅记录试验结束时变量的最后值。
系统变量
系统变量对于实验执行和数据导出非常重要。它们会自动创建，无法修改或删除。系统变量在需求中（例如 If-Else 操作）也非常有用。例如，它们可以用于引用特定的试验编号、使用主题计数器，或在多个参与者的多用户研究中分隔事件。所有系统变量在 Labvanced 平台的主变量菜单中显示。了解更多关于 系统变量的信息
因子变量
因子变量是与试验系统中的因子相关联的变量。每个因子都有一个与之关联的具有类别数据类型的变量。因子的水平也是变量可能的值状态。创建新因子时，用户可以选择创建一个新变量（自动）或重用现有变量。链接因子变量时，应注意，对变量/因子水平的更改将影响所有链接任务/试验组中的试验结构。因子变量可以在事件系统中使用，例如创建仅在特定条件下执行的事件（例如，仅在因子“图像类别”等于“房屋”时执行某项操作）。此外，在实验执行的每次试验中，每个因子变量将始终在数据视图中存储新的级别值。这样，在查看数据输出或重复程序时，更容易重构每个记录试验的条件。
对象变量
对象变量在将对象添加到框架时会自动创建。大多数这些变量源于添加“问卷项目”，例如复选框、李克特量表、下拉框等。在创建此类对象时，您将被要求输入与之相关联的变量的名称。在您输入一个有效（唯一！）名称后，变量将会被自动创建。在对象属性视图中，您将在“链接变量”下看到与之关联的变量的引用。您也可以在这里更改与其他变量的链接/关联。然而，我们建议谨慎使用此选项。在实验执行时，参与者的反应将存储在变量中。对象变量默认情况下会被记录，并且大多数对象变量的属性无法更改以确保其功能。
自定义变量
自定义变量由用户主动创建。创建自定义变量的原因可能相当多样。它们可以用于记录参与者的决定（鼠标点击或按键）或反应时间。它们还可以用作 while 循环或数组操作中的计数器或索引，存储（图像、视频、音频）文件数据，以及许多其他目的。
当变量在未使用的情况创建时，或者当其使用（对象或事件）被删除时，该变量将被列为未使用。
数组变量
数组与上述标量变量非常不同。将数组视为电子表格中的一列：它以指定顺序保存条目。在创建数组时，您可以单击“使用 CSV 文件”旁边的文件夹上传带有信息的一列 .csv 文件，或可以使用加号图标手动添加条目。
有关与数组关联的操作的列表，请参见 数组操作
数据框变量
数据框与数组的不同之处在于，如果数组是一列电子表格，则数据框是整个电子表格，包含多列。数据框可以保存字符串（文本）、数值、布尔或文件值，但不能直接在数据框对话框中编辑。您可以添加列和文件，但无法输入文本或数字：
要添加新数据框，单击上传 2D CSV 数据。添加信息到数据框时，仅接受 .csv 文件。选择文件后，会出现多个导入选项：
选择所有适用的选项：
- 将字符串映射到文件 允许您将文件名作为字符串包含，然后使用映射函数指向文件存储的文件夹。只要数据框中的值与所需文件的名称完全匹配，这将使该列的文件名搜索文件夹中的相应文件。此功能仅在列由字符串值填充时可用。
- 使用第一行作为标题 会将数据框第一行中的值作为每列的变量名称使用。
- 转置数据 仅仅以原样上传数据框。如果您的数据框不包含任何文件名，这非常有用。
如果您的数据框完全由字符串值组成，这些值与文件夹中文件的名称相对应，您可以使用将所有字符串映射到文件函数将整个数据框映射到一个文件夹中。
要向现有数据框添加更多信息，请选择数据框对话框顶部的添加变量/列选项。
有关与数据框相关的操作的列表，请参见 数据框操作
变量引用与变量删除
为了更好地概述每个变量的使用情况，变量属性面板底部有一个名为“使用情况”的列表。在这里，列出了变量的所有用法，包括使用该变量的框架（名称）的引用、用途（用作）以及使用是读取操作（R）、写入操作（W）还是两者（RW）。对于每个使用变量的框架，使用表中将多出一条条目，其“使用类型”命名为“局部工作区”。框架局部工作区中的所有变量将随后显示在变量选择菜单中的“局部变量”部分中。
当您希望删除变量时，必须特别小心。删除仍用作因子、对象或用于事件的变量可能导致严重问题，并可能在最坏的情况下破坏整个实验结构。因此，在变量选项卡中，只能删除那些除了处于一个（或多个）局部工作区之外没有其他引用使用的变量。仅在局部工作区上定义的变量（没有进一步使用）列为未使用，并且旁边会显示删除图标。
变量选择菜单
用户控制变量的使用主要基于事件逻辑。在事件系统中，有三个（视觉上）不同的菜单允许您选择一个变量：“值选择菜单”、“绿色选择按钮”和“变量引用菜单”。虽然这些菜单在视觉上不同，但它们都会打开同一个菜单（变量选择菜单）以选择变量。
总的来说，变量选择菜单包含三个不同的选项卡：“局部变量”、“所有变量”和“新变量”。在“局部变量”下，您可以查看和选择在框架的局部工作区中定义的所有变量（已经在框架中使用）。在“所有变量”下，列出了研究的全局变量列表中的所有变量，可以进行选择。这两个菜单都有搜索功能，可以直接找到所需的变量。“新变量”选项卡可用于创建（并因此选择）一个新变量。
记录数据
对于每个变量，用户可以使用复选框决定变量值是否会被记录。对于系统变量、因子变量和对象变量，记录默认被激活。因此，数据记录的许多部分将自动工作。当您想记录某个对象属性、参与者的反应或其他默认未记录的内容时，您必须使用事件系统适当地设置变量值。下面是一个记录反应时间的事件逻辑的简要示例：
- 向框架添加一张图像。
- 创建一个新事件并命名它。
- 定义触发器，用于确定何时应设置变量值。例如，选择 --> 用户输入 --> 鼠标触发。将触发器操作设置为单击，并将按钮设置为左键。单击“添加目标”旁边的 + 号，将图像添加为可点击目标。单击窗口底部的“下一步”。
- 选择操作变量操作 --> 设置/记录变量。然后单击“选择”按钮。
- 单击“新变量”选项卡，通过给它一个名称（数据类型：数值，重置 = 真，记录 = 真）创建一个新变量。单击“确定”。
- 单击值选择（铅笔）图标 --> 触发（鼠标） --> 从框架开始的时间。单击完成。
现在，您已经为点击图像的反应时间进行了保存。您可以使用类似的过程记录其他属性，例如决策（从多种中点击了哪张图像）等。