🎚

Slider

Sources
运行在线示例 免费 · 无需注册 · 直接在浏览器中运行

Slider 模块在画布上提供了一个交互式图形滑动条控件,允许用户在仿真运行期间实时调整信号或工程全局变量。拖动滑块手柄会实时更新输出值,并自动将仿真引擎调整为物理实时时钟同步步进,从而使系统立即对用户的手动操作做出动态响应。该模块既可以作为普通的物理信号源输出,也可以直接驱动工程中的全局变量(如 PID 控制器增益或机械结构质量),而无需在画布上布置繁琐的物理信号连线。

数学模型

连续输出信号 y(t)y(t) 对应于用户所选的滑块物理位置 v(t)v(t),被限制在预设区间 [vmin⁡,vmax⁡][v_{\min}, v_{\max}] 之内,并按照量化步长 Δv\Delta v 进行离散化取整:

y(t)=clamp⁡(vmin⁡+round⁡(v(t)−vmin⁡Δv)⋅Δv,  vmin⁡,  vmax⁡)y(t) = \operatorname{clamp}\left( v_{\min} + \operatorname{round}\left(\frac{v(t) - v_{\min}}{\Delta v}\right) \cdot \Delta v, \; v_{\min}, \; v_{\max} \right)

其中 vmin⁡=minValuev_{\min} = \text{minValue},vmax⁡=maxValuev_{\max} = \text{maxValue},Δv=step\Delta v = \text{step},且有:

clamp⁡(x,a,b)=min⁡(max⁡(x,a),b)\operatorname{clamp}(x, a, b) = \min(\max(x, a), b)

当参数 variable 非空(Vname≠""V_{\text{name}} \ne \text{""})时,该模块会同步更新全局共享工程变量:

V[Vname]←y(t)\mathcal{V}[V_{\text{name}}] \leftarrow y(t)

从而允许画布中所有引用 {{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 实时同步,确保人机交互的顺畅与物理真实感。
  • 撤销历史记录整合: 用户释放滑块鼠标手柄后,会在平台历史记录栈中自动记录一次合并的撤销状态。
  • 严格边界限幅: 输出信号严格受限于 [vmin⁡,vmax⁡][v_{\min}, v_{\max}] 区间,即使在检查面板中手动输入越界数值也会被自动限幅。
  • 嵌入式环境就绪: 完美支持零知识加密分享链接与交互式 iframe 嵌入式展示。

相关模块

  • Joystick2D: 二维平面操纵杆模块,用于双轴 XY 平面信号的同步交互控制。
  • KeyboardInput: 键盘输入模块,可通过方向键或 WASD 键盘按键实时控制仿真信号。
  • Constant: 常数模块,提供固定的非交互式标量信号源。
  • PIDController: 比例积分微分控制器,常通过滑块进行交互式在线参数整定。