OpenMontage 中的 ManimGL 弹簧-质量系统动画从阻尼简谐运动到实时轨迹图【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage导读本文基于 OpenMontage 仓库内 ManimGL 最佳实践技能.claude/skills/manimgl-best-practices中references/spring_mass_system.md参考指南及其配套示例 spring_mass_system.py系统讲解如何在 ManimGL3Blue1Brown 版 Manim中构建一个自包含的弹簧-质量系统物理仿真组件并派生出基础振荡、实时 x(t) 轨迹图与多阻尼对比三类教学场景。读完本文你将掌握物理仿真 可视化封装为单个VGroup子类的 3b1b 式设计方法、欧拉法积分实现、TracedPath实时绘图以及 ManimGL 交互式迭代开发-secheckpoint_paste的高效工作流可直接复用于 OpenMontage 的数学动画生产链路。参考文档定位与适用场景本文对应的参考指南位于 references/spring_mass_system.md它是 ManimGL 最佳实践技能包中八份参考文档之一同目录下还有equation_transforms.md、integration_visualization.md、parallax_starfield.md等。该技能包的 SKILL.md 明确声明它面向ManimGLGrant Sanderson 的 3Blue1Brown 版本基于 OpenGL 的动画引擎而非 Manim Community EditionManimCE——两者的差异包括导入语句from manimlib import *vsfrom manim import *、CLImanimglvsmanim、场景基类InteractiveScenevsScene、创建动画ShowCreationvsCreate等。阅读本文前请确保已通过pip install manimgl安装正确版本。在 OpenMontage 中这类 ManimGL 动画知识服务于 math_animate 工具 驱动的数学动画生产流程与该技能包rules/下的 scenes.md、mobjects.md、cli.md、interactive.md 等规则文件配套使用。典型用户查询场景参考指南开篇即列出了这个示例要解决的典型用户需求这些查询可以作为需求判定的快速匹配模板Create a spring animation with oscillation创建一个带振荡的弹簧动画Show damped harmonic motion展示阻尼简谐运动Visualize physics simulation with a mass on a spring可视化弹簧上质量的物理仿真Animate a spring-mass system with real-time graph用实时曲线图动画化弹簧-质量系统Compare different damping coefficients对比不同的阻尼系数当用户提出上述任意一类需求时SpringMassDemo、SpringWithGraph、MultipleSprings三个场景即可分别覆盖基础演示、实时图表与参数对比三种形态。场景构思过程3b1b 风格核心概念阻尼简谐运动示例要表达的核心物理概念是阻尼简谐运动Damped Harmonic Motion挂在弹簧上的质量块往复振荡振幅因摩擦/阻尼随时间衰减。其控制方程为二阶常微分方程x -kx - μv其中k为弹簧刚度系数spring constantμ为阻尼系数damping coefficientx为偏离平衡位置的位移v为速度。方程右侧第一项-kx是弹簧回复力胡克定律第二项-μv是与速度成正比的阻尼力。视觉设计决策参考指南给出了两个关键设计决策及其理由示例源码中均有对应实现为什么用参数化螺旋线parametric helix画弹簧带 3D 线圈的造型更接近真实弹簧质量块移动时螺旋能自然地伸缩示例通过set_width(..., stretchTrue)实现使用ParametricCurve保证渲染平滑。示例源码_create_spring中的实现见 spring_mass_system.pydef _create_spring(self, stroke_color, stroke_width, n_curls, radius): Create a 3D helix spring using parametric curve. spring ParametricCurve( lambda t: [t, -radius * math.sin(TAU * t), radius * math.cos(TAU * t)], t_range(0, n_curls, 0.01), stroke_colorstroke_color, stroke_widthstroke_width, ) spring.rotate(self.rot_off_horizontal) return spring这里TAU 2πt每增加 1 螺旋正好绕一圈n_curls默认 8控制总圈数radius默认 0.25控制线圈半径t_range(0, n_curls, 0.01)的步长 0.01 保证了曲线的采样密度。rot_off_horizontal是预设运动方向与水平向右的夹角angle_between_vectors(RIGHT, direction)使弹簧可以沿任意方向摆放。为什么在数轴上跟踪位置给出定量反馈让观众看到精确的位移数值便于理解运动方向数轴上的箭头指示点随之左右移动。SpringMassDemo中通过NumberLine(x_range(-4, 4, 1))配合ArrowTip指示器实现指示器用更新器持续跟踪质量块当前位置见下文场景详解。核心技术实现模式一自包含的物理组件VGroup 子类参考指南强调的核心洞察是把物理状态与视觉表现封装进同一个VGroup子类使组件可复用、动画代码保持干净。示例源码的完整构造器展示了所有可调参数spring_mass_system.pyclass SpringMassSystem(VGroup): def __init__( self, x00, # 初始位移偏离平衡位置 v00, # 初始速度 k3, # 弹簧刚度系数 mu0.1, # 阻尼系数 equilibrium_length5, # 弹簧的静止自然长度 equilibrium_positionORIGIN, # 平衡位置坐标 directionRIGHT, # 运动方向 spring_stroke_colorGREY_B, # 弹簧描边颜色 spring_stroke_width2, # 弹簧描边宽度 spring_radius0.25, # 螺旋半径 n_spring_curls8, # 螺旋圈数 mass_width1.0, # 质量块边长 mass_colorBLUE_E, # 质量块颜色 mass_labelm, # 质量块上的标签 ): super().__init__() self.equilibrium_position equilibrium_position self.fixed_spring_point equilibrium_position - (equilibrium_length - 0.5 * mass_width) * direction self.direction direction self.rot_off_horizontal angle_between_vectors(RIGHT, direction) # 创建视觉组件 self.mass self._create_mass(mass_width, mass_color, mass_label) self.spring self._create_spring(spring_stroke_color, spring_stroke_width, n_spring_curls, spring_radius) self.add(self.spring, self.mass) # 物理状态 self.k k self.mu mu self.velocity v0 self._is_running True # 设置初始位置 self.set_x(x0) # 注册物理更新器每帧自动推进仿真 self.add_updater(lambda m, dt: m.time_step(dt)) ...关键点拆解fixed_spring_point是弹簧固定端点计算式为equilibrium_position - (equilibrium_length - 0.5 * mass_width) * direction即在平衡位置沿运动方向的反方向偏移自然长度减去半个质量块宽度的距离保证静止时弹簧恰好水平拉直add_updater(lambda m, dt: m.time_step(dt))将物理推进挂接在 ManimGL 的逐帧更新机制上只要该组件在场景中动画引擎每一帧都会自动调用time_step无需在场景中手写循环质量块_create_mass用Square(mass_width)填充mass_color、白色描边并设置set_shading(0.1, 0.1, 0.1)获得 3D 光照质感再叠加一个最大宽度受限的Tex标签mset_x(x)在移动质量块的同时会重新计算固定端点与质量块左缘的距离旋转回水平后self.spring.set_width(spring_width, stretchTrue)拉伸弹簧、再旋转回运动方向并move_to对齐从而实现弹簧随位移自然伸缩。模式二欧拉法物理积分参考指南给出的核心积分代码在示例中完整实现为time_stepspring_mass_system.pydef time_step(self, delta_t, dt_size0.01): Integrate physics using simple Euler method. if not self._is_running or delta_t 0: return state [self.get_x(), self.velocity] sub_steps max(int(delta_t / dt_size), 1) true_dt delta_t / sub_steps for _ in range(sub_steps): x, v state # Damped harmonic oscillator: x -kx - μv acceleration -self.k * x - self.mu * v state[0] v * true_dt state[1] acceleration * true_dt self.set_x(state[0]) self.velocity state[1]实现要点子步长细分sub-steppingdt_size默认 0.01 秒sub_steps max(int(delta_t / dt_size), 1)将渲染帧间隔拆分为多个物理子步true_dt delta_t / sub_steps保证总时长一致。这样做是为了降低显式欧拉法的数值误差——帧率越低帧间隔越大一次性大步长积分的误差越明显细分后运动更平滑、更接近解析解半隐式/更新顺序先用当前速度更新位置state[0] v * true_dt再用当前加速度更新速度state[1] acceleration * true_dt即先用旧速度移动再更新速度的经典顺序_is_running开关pause()/unpause()控制仿真是否推进见可暂停物理模式delta_t 0时直接跳过以避免除零或空转。模式三动态速度/力矢量参考指南展示了通过add_updater让矢量箭头跟随物理状态实时变化的技巧。示例中实现了两个版本spring_mass_system.pydef get_velocity_vector(self, scale_factor0.5, v_offset-0.25, colorGREEN): Get a dynamic vector showing velocity. vector Vector(RIGHT, fill_colorcolor, stroke_colorcolor) v_shift v_offset * UP vector.add_updater(lambda m: m.put_start_and_end_on( self.mass.get_center() v_shift, self.mass.get_center() v_shift scale_factor * self.velocity * RIGHT )) return vector def get_force_vector(self, scale_factor0.5, v_offset0.25, colorRED): Get a dynamic vector showing net force. vector Vector(RIGHT, fill_colorcolor, stroke_colorcolor) v_shift v_offset * UP def get_force(): return -self.k * self.get_x() - self.mu * self.velocity vector.add_updater(lambda m: m.put_start_and_end_on( self.mass.get_center() v_shift, self.mass.get_center() v_shift scale_factor * get_force() * RIGHT )) return vector两个函数的设计差异体现了教学语义速度矢量绿色直接读取self.velocity长度反映瞬时速度力矢量红色每次更新重新计算净力-k·x - μ·v长度反映瞬时合力。二者分别偏移到质量块下方v_offset-0.25与上方v_offset0.25避免重叠并用绿/红双色形成速度 vs 力的视觉对照——这与技能包 colors.md 中变量用黄色、已知常量用蓝色、标注用绿色、错误路径用暗红的语义配色体系一脉相承。三个场景变体参考指南用一张表格概括了三个场景的用途示例源码中均有完整实现场景用途关键特性SpringMassDemo基础振荡叠加速度/力矢量数轴 箭头指示器 矢量逐层FadeInSpringWithGraph用TracedPath实时绘制 x(t) 曲线坐标轴 ValueTracker计时 暂停/恢复控制MultipleSprings并排对比不同阻尼系数零/轻/重三档阻尼 跟随标签SpringMassDemo基础演示场景以x02, mu0.15, k3初始化系统平衡位置放在2 * LEFT数轴放在平衡位置下方 2 个单位spring_mass_system.pyspring SpringMassSystem( x02, mu0.15, k3, equilibrium_position2 * LEFT, equilibrium_length5, ) self.add(spring) number_line NumberLine(x_range(-4, 4, 1)) number_line.next_to(spring.equilibrium_position, DOWN, buff2.0) number_line.add_numbers(font_size24) arrow_tip ArrowTip(length0.2, width0.1) arrow_tip.rotate(-90 * DEG) arrow_tip.set_fill(TEAL) arrow_tip.add_updater(lambda m: m.move_to(number_line.n2p(spring.get_x()), DOWN))动画节奏上先self.wait(2)让系统自由振荡再依次FadeIn数轴与箭头指示器wait 5→ 绿色速度矢量wait 5→ 红色力矢量wait 8。这种先现象、后定量、再受力分析的递进展示正是技能包 scenes.md 中一个场景只讲一个概念、逐层构建one concept per scene, build incrementally原则的具体落地。SpringWithGraph实时轨迹图这是全示例中最有教学价值的一个场景左侧是弹簧右侧是 x(t) 坐标轴仿真运行的同时蓝色曲线实时画出位移随时间的变化spring_mass_system.pyaxes Axes( x_range(0, 15, 1), # 时间轴 0~15 秒 y_range(-2.5, 2.5, 1), # 位移轴 ±2.5 width10, height3, axis_config{stroke_color: GREY} ) # 时间追踪器每帧自动累加 time_tracker ValueTracker(0) time_tracker.add_updater(lambda m, dt: m.increment_value(dt)) # 追踪点将 (t, x) 映射到坐标轴空间 tracking_point Point() tracking_point.add_updater(lambda p: p.move_to( axes.c2p(time_tracker.get_value(), spring.get_x()) )) # TracedPath 实时画线 position_graph TracedPath( tracking_point.get_center, stroke_colorBLUE, stroke_width3, )参考指南中的模式要点完整继承于此spring.pause() # 先暂停物理完成 UI 搭建 self.add(spring) self.play(FadeIn(axes), Write(t_label), Write(x_label)) self.add(tracking_point, position_graph, time_tracker) # 挂载追踪链路 spring.unpause() # 恢复仿真开始实时描线 self.wait(12)三个组件各司其职ValueTracker是 ManimGL 的数值追踪器配合更新器每帧递增充当秒表Point通过axes.c2p把时间-位移坐标映射到图幅空间TracedPath持续记录Point走过的路径形成连续曲线。pause()/unpause()在这里派上了关键用场——先冻结物理、再搭建 UI、最后恢复避免曲线从 0 时刻之前就开始乱画。注意t_labelText(Time (t))与x_labelTex(x(t))分别放在横轴右侧与纵轴顶端构成完整图表语义。MultipleSprings阻尼对比场景用VGroup并排放置三个弹簧阻尼系数取[0.0, 0.2, 0.5]分别对应无阻尼 / 轻阻尼 / 重阻尼三档spring_mass_system.pysprings VGroup() damping_values [0.0, 0.2, 0.5] labels_text [No damping, Light damping, Heavy damping] colors [BLUE, GREEN, RED] for i, (mu, label_text, color) in enumerate(zip(damping_values, labels_text, colors)): spring SpringMassSystem( x01.5, mumu, k4, equilibrium_position4 * LEFT (2 - i * 2) * UP, equilibrium_length4, mass_colorcolor, ) label Text(label_text, font_size24, colorcolor) label.next_to(spring.mass, RIGHT, buff2) # 标签跟随质量块移动 label.add_updater(lambda m, sspring, tlabel_text, ccolor: m.become( Text(t, font_size24, colorc).next_to(s.mass, RIGHT, buff2) )) springs.add(spring) self.add(label) self.add(springs) self.wait(12)教学价值在于μ0 时曲线永不衰减能量守恒μ 越大衰减越快三个系统并排运行即可直观感受阻尼的物理意义。两个实现细节值得注意均衡位置按(2 - i * 2) * UP纵向排布i0 在上、i2 在下形成清晰的行布局文本标签用become(...)更新器跟随各自质量块移动且 lambda 通过默认参数sspring, tlabel_text, ccolor绑定循环变量避免 Python 闭包常见的循环变量晚绑定陷阱——这是多对象add_updater时的经典易错点。关键模式提炼模式可暂停物理Pausable Physicsdef pause(self): self._is_running False def unpause(self): self._is_running Truetime_step开头通过if not self._is_running or delta_t 0: return消费这个开关。用途有三搭建 UI 时冻结物理如SpringWithGraph的 setup 阶段、讲解中途定格画面、以及精确控制对比实验的同时起跑。模式TracedPath 实时绘图tracking_point Point() tracking_point.add_updater(lambda p: p.move_to( axes.c2p(time_tracker.get_value(), spring.get_x()) )) position_graph TracedPath(tracking_point.get_center, stroke_colorBLUE)要点是追踪点驱动任何需要画轨迹的物理量位置、速度、相位等都可以先做成一个Point并add_updater驱动其运动再用TracedPath记录该点的历史路径。这样图形绘制与物理仿真完全解耦可以自由组合出位移图、速度图甚至相空间图位置-速度曲线。模式更新器与 ValueTracker 协同整个示例的实时性完全建立在 ManimGL 的更新器机制上规则详见 mobjects.md 的 Updaters 小节add_updater(lambda m, dt: ...)每帧回调dt为帧间隔ValueTracker提供可动画的数值状态get_value()/increment_value()配合使用更新器可以注册在任意 Mobject 上包括矢量箭头、指示点、标签文本。运行命令与渲染输出参考指南给出的三条命令对应上述三个场景# 基础演示含速度/力矢量与数轴 manimgl spring_mass_system.py SpringMassDemo -w # 带实时轨迹图 manimgl spring_mass_system.py SpringWithGraph -w # 多阻尼对比 manimgl spring_mass_system.py MultipleSprings -w其中-w表示将渲染结果写入文件。示例文件头部还标注了另一种常用方式spring_mass_system.py# 预览模式渲染后立即弹出窗口播放 manimgl spring_mass_system.py SpringMassDemo -p结合技能包的 cli.md 与 config.md常用的运行变体还包括# 低画质快速测试 manimgl spring_mass_system.py SpringMassDemo -l # 交互式开发运行到第 15 行后进入 IPython shell manimgl spring_mass_system.py SpringMassDemo -se 15交互式开发-secheckpoint_paste是 ManimGL 相对 ManimCE 的杀手锏详见 interactive.md-se 行号让场景执行到指定行后暂停并进入 IPython 交互环境此时把新代码复制到剪贴板后调用checkpoint_paste()skipTrue跳过动画立即执行、recordTrue记录动画即可在不重渲染的前提下反复试错直到满意再把代码回填进源文件。调试弹簧参数如阻尼系数、初始位移时这种工作流能极大缩短迭代周期。与 OpenMontage 生产链路的衔接在 OpenMontage 中ManimGL 动画知识最终服务于数学动画生产仓库的 math_animate 工具 及其安全性测试 test_math_animate_safety.py 定义了数学动画的生成与校验边界而 manim-usage.md 则从 ManimCE 侧给出了渲染质量档位-ql/-qm/-qh/-qp/-qk、动画节奏方程书写 1.5–2.0s、图形创建 0.8–1.2s、揭示后等待 1.0–2.0s与语义配色等生产规范。本文介绍的SpringMassSystem组件化思路物理 视觉封装进一个 VGroup正是这些规范在具体动画主题上的落地范本——它既可作为独立教学片段直接渲染也可以被进一步包装为 OpenMontage 技能库中可复用的动画组件供 Agent 在需要振荡 / 阻尼 / 弹簧类物理可视化时按需调用。小结本文围绕 ManimGL 弹簧-质量系统示例完整拆解了从物理方程x -kx - μv到三场景成品动画的全部实现路径以VGroup子类封装物理状态与视觉组件、以欧拉法子步长积分推进仿真、以更新器驱动矢量箭头与数轴指示、以TracedPathValueTracker实现实时曲线、以三档阻尼并排对比突出物理内涵。参考文档与示例源码分别位于 references/spring_mass_system.md 与 examples/spring_mass_system.py读者可直接将其作为模板将同一套仿真组件 实时绘图 参数对比模式迁移到其他物理主题摆锤、双弹簧、波动等的动画创作中。【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考