Psychopy使用文档

Builder
构建器
Building experiments in a GUI
使用图形用户界面构建实验
Making your experiments using the PsychoPy® builder is the approach that we generally recommend. Why would we (a team of programmers) recommend using a GUI?:
我们通常推荐使用PsychoPy®构建器来创建实验。作为一个程序员团队，我们为何会推荐使用图形界面呢？原因如下：
制作速度更快
通过图形界面搭建实验流程，效率远高于手动编写代码。
降低实验错误率
自行编写代码的实验容易因疏忽产生漏洞——即使是由顶尖程序员编写也是如此！而构建器通过模块化设计减少了此类风险。
轻松实现在线实验
PsychoPy构建器在后台会自动生成Python脚本。若您希望将实验部署到浏览器运行，它还能通过姊妹库PsychoJS编译出JavaScript版本（需注意：PsychoJS作为新生工具，其功能完备性可能不及PsychoPy本体。建议在开发在线实验前查阅平台最新支持情况）。目前最便捷的PsychoPy在线实验托管平台是Pavlovia®，且构建器已内置与该平台的深度集成。
丰富的学习资源
PsychoPy官方YouTube频道提供大量入门教程，另有图文教程和实验模板库。教学场景中，构建器视图也配备了多样化的教学素材支持。

Contents: → 内容
Builder concepts → 构建器概念
Routines and Flow → 例程与流程
The components panel → 组件面板
Making experiments to go online → 创建可在线运行的实验
Routines → 例程
Flow → 流程
Adding Routines → 添加例程
Loops → 循环
Using a Staircase → 使用阶梯法
Using a simple staircase → 使用基础阶梯法
Using a QUEST staircase → 使用QUEST阶梯法
Using a QUEST Plus staircase → 使用QUEST Plus阶梯法
Blocks of trials and counterbalancing → 试次块与平衡设计
Blocking similar conditions → 对相似条件分组平衡
Counterbalancing similar conditions → 对相似条件交叉平衡
Counterbalancing different subtasks → 对不同子任务交叉平衡
Components → 组件
Pavlovia Survey → Pavlovia调查组件
Aperture Component → 孔径组件
Brush Component → 画笔组件
Button Component → 按钮组件
CameraComponent → 摄像头组件
Cedrus Button Box Component → Cedrus按钮盒组件
Code Component → 代码组件
Counterbalance Standalone Routine → 平衡独立例程
DotsComponent → 点组件
Emotiv Marking Component → Emotiv标记组件
Emotiv Record Component → Emotiv记录组件
Eye Tracker Region of Interest Component → 眼动仪感兴趣区域组件
Eye Tracker Calibration Component (Standalone Routine) → 眼动仪校准组件（独立例程）
EyetrackerRecordComponent → 眼动仪记录组件
Eye Tracker Validation Component (Standalone Routine) → 眼动仪验证组件（独立例程）
FormComponent → 表单组件
Creating a Google Cloud Speech API key → 创建Google Cloud语音API密钥
Grating Component → 光栅组件
Image Component → 图像组件
ioLab Systems buttonbox Component → ioLab系统按钮盒组件
JoyButtons Component → 摇杆按钮组件
Joystick Component → 摇杆组件
Keyboard Component → 键盘组件
Microphone Component → 麦克风组件
Mouse Component → 鼠标组件
Movie Component → 视频组件
Panorama Component → 全景组件
Parallel Port Out Component → 并行端口输出组件
Patch (image) Component → 补丁（图像）组件
Polygon (shape) Component → 多边形（形状）组件
Progress Bar Component → 进度条组件
Pump Component → 泵组件
RatingScale Component → 评分量表组件
Resource Manager Component → 资源管理器组件
Example: Loading resources in the background of instructions → 示例：在指令背景中加载资源
Loading resources for blocked or branched designs, or loading trial-by-trial → 为分块/分支设计加载资源，或逐试次加载资源
Reward Component → 奖励组件
Serial Port Out Component → 串口输出组件
Slider Component → 滑块组件
Sound Component → 声音组件
Static Component → 静态组件
Custom → 自定义
Text Component → 文本组件
Textbox Component → 文本框组件
Variable Component → 变量组件
Entering parameters → 参数输入
How often to evaluate the variable/code → 代码/变量的评估频率
Experiment settings → 实验设置
Settings → 设置
Defining the onset/duration of components → 定义组件的启动时间/持续时间
Examples → 示例
Generating outputs (datafiles) → 生成输出（数据文件）
Common Mistakes (aka Gotcha’s) → 常见错误（Gotchas）
General Advice → 通用建议
My stimulus isn’t appearing, there’s only the grey background → 我的刺激未显示，只有灰色背景
The loop isn’t using my Excel spreadsheet → 循环未使用我的Excel表格
I just want a plain square, but it’s turning into a grating → 我想要纯方框却出现光栅
The code snippet I’ve entered doesn’t do anything → 输入的代码片段无效
My stimulus isn’t changing as I progress through the loop → 循环中刺激未按预期变化
I’m getting the error message AttributeError: ‘unicode object has no attribute ‘XXXX’ → 报错：AttributeError: 'unicode'对象没有属性'XXXX'
The window opens and immediately closes → 窗口打开后立即关闭
Compiling a Script → 编译脚本
Set up your monitor properly → 正确设置显示器参数