Slider
Sources
运行在线示例
免费 · 无需注册 · 直接在浏览器中运行
Slider 模块在画布上提供了一个交互式图形滑动条控件,允许用户在仿真运行期间实时调整信号或工程全局变量。拖动滑块手柄会实时更新输出值,并自动将仿真引擎调整为物理实时时钟同步步进,从而使系统立即对用户的手动操作做出动态响应。该模块既可以作为普通的物理信号源输出,也可以直接驱动工程中的全局变量(如 PID 控制器增益或机械结构质量),而无需在画布上布置繁琐的物理信号连线。
数学模型
连续输出信号 对应于用户所选的滑块物理位置 ,被限制在预设区间 之内,并按照量化步长 进行离散化取整:
其中 ,,,且有:
当参数 variable 非空()时,该模块会同步更新全局共享工程变量:
从而允许画布中所有引用 {{V_name}} 占位符的模块在下一个仿真步长自动继承最新的数值。
输入与输出
| Direction | ID | Label | 类型 | Status |
|---|---|---|---|---|
| ← Out | out |
Value | number | Output |
参数
| 参数 | Label | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
value |
Value | number | 0 |
Current slider value — drag the on-canvas slider or edit here |
minValue |
Min | number | -1 |
|
maxValue |
Max | number | 1 |
|
step |
Step | number | 0.01 |
|
label |
Label | string | |
|
variable |
Drives Variable | string | |
Variable this slider sets live; parameters that use it follow. Empty: signal only. |
使用示例
示例 1: 直流电机转速控制的实时人工设定值调步
使用 Slider 模块向伺服电机提供交互式目标转速指令。配置参数 minValue = 0.0,maxValue = 3000.0,step = 10.0,label = "转速 (RPM)"。在仿真运行期间实时拖动滑块手柄,并在 uPlotDisplay 示波器上观察转速阶跃响应,即可直观评估电机的跟踪延迟和超调量。
示例 2: 交互式嵌入教学案例中控制器增益的无线调谐
在交互式嵌入展示中实时整定 PID 控制器增益,避免连线缠绕。设置 minValue = 0.1,maxValue = 20.0,step = 0.1,label = "比例增益",并将 variable 设为 "Kp"。在 PIDController 模块中,将比例系数 kp 填入 {{Kp}},即可直接将增益绑定至滑块位置。
说明与最佳实践
- 自动实时同步 (Real-Time Pacing): 画布中添加交互式滑块模块后,仿真引擎会自动与物理时钟保持 1:1 实时同步,确保人机交互的顺畅与物理真实感。
- 撤销历史记录整合: 用户释放滑块鼠标手柄后,会在平台历史记录栈中自动记录一次合并的撤销状态。
- 严格边界限幅: 输出信号严格受限于 区间,即使在检查面板中手动输入越界数值也会被自动限幅。
- 嵌入式环境就绪: 完美支持零知识加密分享链接与交互式 iframe 嵌入式展示。
相关模块
- Joystick2D: 二维平面操纵杆模块,用于双轴 XY 平面信号的同步交互控制。
- KeyboardInput: 键盘输入模块,可通过方向键或 WASD 键盘按键实时控制仿真信号。
- Constant: 常数模块,提供固定的非交互式标量信号源。
- PIDController: 比例积分微分控制器,常通过滑块进行交互式在线参数整定。