变量

OpenSesame中的实验变量是什么？

OpenSesame中的实验变量是指这些变量：

• 您可以在用户界面中使用' {variable_name}'语法引用。
• 在Python inline_script中作为全局变量可用。
• 在JavaScript inline_javascript中作为全局变量可用。
• 包含以下内容：
  • 您在loop项目中定义的变量。
  • 您收集的响应。
  • 实验的各种属性。
  • 等

变量检查器

变量检查器（Ctrl+I）提供了可用变量的概述（％FigVariableInspector）。实验未运行时，此概述基于对实验过程中将提供哪些变量的最佳猜测。但是，实验运行时，变量检查器显示变量及其值的实时概述。这对于调试您的实验非常有用。

Figure 1. 变量检查器提供了OpenSesame已知的所有变量的概述。

定义变量

定义变量的最简单方法是通过loop项目。例如，％FigLoop展示了如何定义名为gaze_cue的变量。在此示例中，当gaze_cue为'left'时，调用trial_sequence项目四次，当'gaze_cue'为'right'时，再调用四次。

Figure 2. 使用loop表定义自变量的最常见方法。

内置变量

以下变量始终可用：

实验变量

项目变量

还有一些变量可用于跟踪实验中的所有项目。

响应变量

当您使用标准响应项目，例如keyboard_response和mouse_response时，系统会根据参与者的响应设置一些变量。

反馈变量

反馈变量维护准确性和响应时间的移动平均值。

在用户界面中使用变量

在用户界面中看到的任何值都可以使用‘{变量名}’符号替换为变量。例如，如果您在loop项目中定义了一个变量soa，则可以将此变量用于草图板的持续时间，如Figure 3所示。

Figure 3. 持续时间‘{soa}’表示sketchpad的持续时间取决于变量soa。

这在整个用户界面中都有用。 例如，如果您定义了一个变量my_freq，则可以将此变量用作synth项目中的频率，如Figure 4所示。

Figure 4. 频率‘{my_freq}’表示synth的频率取决于变量my_freq。

有时，用户界面不会让您输入任意文本。例如，sketchpad的元素是以视觉方式显示的，您无法直接将X坐标更改为变量。但是，您可以点击右上角的选择视图→查看脚本 按钮，并直接编辑脚本。

例如，您可以将固定点的位置从中心更改为：

draw fixdot x=0 y=0

…到由变量xpos和ypos定义的位置：

draw fixdot x={xpos} y={ypos}

在用户界面中使用Python表达式

在使用{my_var}符号引用变量时，您实际上在使用所谓的f-string，这是一种在文本字符串中嵌入Python代码的方法。 您还可以使用f-strings来评估任意Python代码。 例如，您可以将变量width和height相乘，并将结果包含在sketchpad中，如下所示：

Figure 5. 您可以使用f-strings嵌入Python表达式。

f-strings是Python代码，因此仅在桌面上受支持，但请参阅下面的浏览器实验中的JavaScript替代方案。

在用户界面中使用JavaScript表达式

在使用OSWeb时，花括号之间包含的表达式会被解释为模板文字。 这与Python中的f-strings非常相似，重要的区别在于它使用JavaScript。

在普通的JavaScript中，模板文字内的表达式以 $ 作为前缀，如下所示：${expression}。在OpenSesame中允许但不必使用此前缀：为了提高浏览器和桌面实验之间的兼容性，会自动添加前缀。在大多数情况下，如下图所示，桌面上的Python f-string和浏览器中的JavaScript模板文字可以使用完全相同的表达式。

Figure 6. 你可以使用模板文字嵌入JavaScript表达式。

在Python中使用变量

在inline_script中，实验变量作为全局变量可用。例如，如果你在loop中定义了 example_variable，那么下面的代码将把 example_variable 的值打印到调试窗口：

print(example_variable)

您可以将实验变量 example_variable 设置为值 'some value'，如下所示：

example_variable = 'some value'

在JavaScript中使用变量

在inline_javascript中，实验变量作为全局变量可用。例如，如果你在一个loop中定义了 example_variable，那么下面的代码将把 example_variable 的值打印到浏览器控制台：

console.log(example_variable)

您可以将实验变量 example_variable 设置为值 'some value'，如下所示：

example_variable = 'some value'

使用条件（"if"）语句

条件语句，或 "if 语句"，提供了一种方法，用于指示只在特定情况下，如某个变量具有特定值时发生。条件语句是常规的Python表达式。

在OpenSesame中使用最常见的if-语句是sequence的 run-if 语句，它允许您指定执行特定元素的条件。如果打开一个sequence项目，会看到序列中的每个项目都有一个 'Run if ...'' 选项。默认值为 'always'，表示项目始终运行；但也可以在此输入条件。例如，如果你想在正确的响应后展示绿色的注视点，错误的响应后展示红色的注视点，可以创建一个如下的sequence（这利用了keyboard_response项目自动设置 correct 变量的事实，如上所述），如 Figure 7 所示。

重要提示： Run-if 语句仅适用于项目的 Run 阶段。Prepare 阶段始终被执行。另请参见此页面。

Figure 7. "Run if" 语句可用于指示sequence中的某些项目只在特定条件下执行。

您还可以使用更复杂数的条件。让我们看几个例子：

correct == 1 and response_time > 2000
correct != 1 or response_time > max_response_time or response_time < min_response_time

同样的原理应用于sketchpad项目中的 'Show if' 字段。例如，如果您只想在变量 quadrant 设置为 'upper right' 时绘制指向右上的箭头，只需在 'Show if...' 字段中输入正确的条件并绘制箭头，如 Figure 8 所示。请确保在设置条件后绘制箭头。

Figure 8. 'Show if' 语句可用于指示sketchpad或feedback项目中的某些元素仅在特定条件下显示。

重要提示：条件语句评估的时刻可能会影响实验的运行方式。这与OpenSesame所采用的 prepare-run 策略有关，详细解释可见：

• https://osdoc.cogsci.nl/4.0/zh/manual/prepare-run