# 动力学与抗风课程资源：来源与使用

整理日期：2026-10-23。用于桥梁工程教材第9章。本目录没有网络接口或登录要求；独立运行 `control.html` 时应同时保留 control-physics、control、control-3d、control-three.min 和 control-orbit 五个脚本及许可文件。

## 来源与版本

| 本地资源 | 来源与版本 | 本次处理 |
|---|---|---|
| viv.html | [bridge-viv-classroom，cdd796edffbfdc2e647f3a488ea5c091445604dc](https://github.com/syzhaoln-stack/bridge-viv-classroom/commit/cdd796edffbfdc2e647f3a488ea5c091445604dc) | 最新104 KB首页逐字节复制，求解与页面均未改。原教师进阶相对路径另接一个本地说明页，联网时打开完整课程。 |
| buffeting.html | [bridge-buffeting-classroom，e755fd64f33fa9a2b747790360f5c9c29dba52f5](https://github.com/syzhaoln-stack/bridge-buffeting-classroom/commit/e755fd64f33fa9a2b747790360f5c9c29dba52f5) | 首页逐字节复制。附带guide/source-review/course-alignment，三份说明仅将“返回实验”的导航改到buffeting.html。 |
| control-physics.js | 课程本地 advanced-wind-course/design/physics.js，2026-10-20版 | 6677字节逐字节复制，无外部依赖；未修改方程、输入谱、反馈或随机相位。 |
| control.html、control.js、control-3d.js | 本轮教材自制 | 同一核心驱动实体箱梁与被动/主动装置、三方案RMS/行程/时程、冻结读数和CSV。不是实桥性能模型。 |
| control-three.min.js、control-orbit.js | 本地 Three.js r160 与教材已有 OrbitControls | 本地离线依赖，MIT 许可见 THREE-LICENSE.txt。OrbitControls仅将ES模块导入/导出改为本页全局绑定。 |

原课程工作目录：`D:/claude_work/20260908_桥梁抗风课程备课`。模型的本地路径用于作者追溯，不是网页运行依赖。详细核对：教材工作区 `修订记录/动力学抗风抗震更新_20261023/课程与GitHub核对.md`。

## 许可

- 抖振内嵌 Three.js r160，MIT 原许可保留为 [THREE-LICENSE.txt](THREE-LICENSE.txt)。
- 涡振原课程的 Wake 教学库 BSD 许可保留为 [WAKE-LICENSE.txt](WAKE-LICENSE.txt)，供课程来源追溯。当前104 KB首页采用课程自有浏览器 D2Q9/BGK 求解器，并不把历史 Wake 库作为外部依赖。
- 其余课程自有内容按作者教材工作区内部复用，没有擅自为作者内容新增开源许可证。第三方许可证不自动覆盖作者的新课文或全部源码。

## 控制例的模型边界

第一竖弯模态与附加质量组成二自由度线性模型，共享同一教学风谱、相位与风荷载。默认f₁=0.25 Hz、结构阻尼比0.8%、广义质量3600 t、附加质量72 t、装置阻尼比8%，调谐比1.00。理想主动反馈没有延迟、饱和、限位、噪声或停电。没有气动反馈和弯扭耦合，不能预测颤振临界风速。

默认无装置/被动/主动的位移 RMS 为26.2074/17.1262/16.6414 mm；被动/主动的相对行程 RMS 为45.4613/46.4646 mm。这些是教学算例结果，不是论文或实桥试验数据。主动强度调到0.12时，位移 RMS约16.18 mm，相对行程RMS约66.23 mm，适合观察性能与装置需求的同时变化。

本例不同于教材旧 `bridge-wind-lab-20261017` 中的给定谐波TMD比较：旧例默认质量比3%、调谐比0.97。本例是宽带阵风且加入主动装置，不能互换两例默认参数、谐波幅值与随机RMS。

## 数值验证

结果文件：[control-verification.json](control-verification.json)。

- 主动增益为零严格回到被动；附加质量为零严格回到原单自由度。
- 12个状态直接代入两体动力平衡与机械能平衡，装置力等大反向，阻尼耗散非负。
- 27组质量比/调谐比/反馈强度的边界与典型组合通过连续闭环Routh-Hurwitz稳定检查。
- 独立RK4时间积分引擎从零初态计算2000 s，不使用源频域逆矩阵或stateAt；3组谐波复幅值与源频响的最大绝对差约1.11×10⁻⁹ m。
- 桌面浏览器实际点击暂停/零反馈/调反馈/取数后，零反馈的RMS和行程分别同为17.13 mm和45.46 mm；冻结记录保持原参数与读数。

以上验证属于课堂模型的实现与力学自洽检查，不代替现场标定、装置可靠性或工程抗风验算。

## 三维表示与放大

2026-10-23追加的真正Three.js场景包括箱梁顶/底板、腹板、加劲肋、栏杆、端部支承，以及安装架、质量块、螺旋弹簧、导向套、阻尼缸和主动执行器。四个模块均由同一个二自由度教学模型状态驱动，合计质量等于模型附加质量；并非另求四个独立装置自由度。

整体400 m视图用于表达给定第一竖弯模态，并不表示这种单跨普通箱梁的实际设计。局部采用教学装置几何：每块质量的平面2.4×2.2 m，高度按7850 kg/m³和四等分附加质量计算，安装与运动留有实体间隙；这不复用课程其他装置示意的外形尺寸。剖开窗口仅为了看到箱内安装，不是原桥存在开洞。

整体变形显示放大80倍，局部采用共同自适应放大（不超过3倍）；梁位移、附加质量位移与时间滑块来自同一状态。界面显示放大倍数，毫米读数、RMS和CSV始终是原计算值。旋转、缩放、重置视角和切换方案不改物理时间。定量时程仍以平面坐标图呈现，其数据与三维实体同步。