OpenMontage 数学动画坐标系实战基于 ManimCE 的 Axes、NumberPlane 与坐标转换系统【免费下载链接】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 仓库中的 ManimCE 最佳实践技能文档 .agents/skills/manimce-best-practices/rules/axes.md 为核心骨架系统讲解Axes、NumberPlane、ComplexPlane、NumberLine与ThreeDAxes的构造、定制与坐标换算方法并结合仓库中math_animate工具的源码与可运行示例说明如何写出可以直接渲染的坐标系场景。读完本文你将能够独立编写带坐标轴、网格、刻度、标签与复数标注的数学动画 Scene并掌握两套坐标系统数学坐标 ↔ 屏幕坐标互转的全部 API。坐标系在 OpenMontage 数学动画管线中的位置OpenMontage 是一个把 AI 编码助手变成完整视频制作工作室的智能体视频生产系统其中数学/科学讲解类视频由本地免费的math_animate工具完成渲染见 tools/graphics/math_animate.pyMathematical animation tool via ManimCE ... Free, local, no API key required。该工具底层执行 Manim Community Edition 场景代码并在其agent_skills [manimce-best-practices, manim-composer]中声明依赖本文所在的技能目录——也就是说.agents/skills/manimce-best-practices/下的规则文件正是 Agent 编写数学场景时会被调取的知识库。坐标系是这一切的地基函数绘图、参数曲线、复数平面、黎曼和、微分几何几乎全部依赖Axes一族对象。技能的入口文档 .agents/skills/manimce-best-practices/SKILL.md 将本文档与 graphing.md函数绘制和 3d.md3D 坐标并列归入 Coordinate Systems Graphing 板块三者共同构成一套从坐标骨架到图形内容的完整写作规范。Axes二维坐标轴Axes是 ManimCE 中最常用的二维坐标容器它本身是 Mobject被self.add()或self.play(Create(axes))加入场景后即可作为所有曲线、点的参照系。最基本的使用方式如下from manim import * class AxesExample(Scene): def construct(self): # Default axes axes Axes() self.add(axes)默认坐标轴会按 ManimCE 内置的x_range/y_range范围铺满画面但工程实践中几乎总是需要显式定制以匹配被绘制的函数定义域与值域。定制 Axes范围、物理长度与样式class CustomAxes(Scene): def construct(self): axes Axes( x_range[-5, 5, 1], # [min, max, step] y_range[-3, 3, 1], x_length10, # Physical length on screen y_length6, axis_config{ color: BLUE, include_tip: True, include_numbers: True, }, x_axis_config{ numbers_to_include: [-4, -2, 0, 2, 4], }, y_axis_config{ numbers_to_include: [-2, 0, 2], }, ) self.add(axes)关键参数语义如下表参数取值示例含义x_range/y_range[-5, 5, 1]数学坐标系范围三元组为[min, max, step]step决定刻度间距x_length/y_length10/6坐标轴在屏幕上占据的物理长度单位是 Manim 场景单位决定网格与曲线的缩放比例axis_config{color: BLUE, ...}同时作用于 x、y 两条轴的通用样式与行为x_axis_config{numbers_to_include: [...]}仅作用于 x 轴的覆盖项优先级高于axis_configy_axis_config{numbers_to_include: [...]}仅作用于 y 轴的覆盖项axis_config中最常用的键包括color轴线与刻度颜色、include_tip是否在正方向末端加箭头、include_numbers是否在每个刻度旁渲染数字标签、stroke_width线宽、tip_shape箭头形状等。numbers_to_include用于精挑哪些刻度显示数字——这是避免画面过密的直接手段与下文 Best Practices 中数字宁缺毋滥的原则一脉相承。为轴添加标签class AxesLabels(Scene): def construct(self): axes Axes(x_range[-5, 5], y_range[-3, 3]) # Add axis labels x_label axes.get_x_axis_label(x) y_label axes.get_y_axis_label(y) # Custom labels x_label axes.get_x_axis_label(MathTex(r\theta)) y_label axes.get_y_axis_label(MathTex(rf(\theta))) self.add(axes, x_label, y_label)get_x_axis_label/get_y_axis_label接受纯字符串如x、t或任意 Mobject最常见的做法是传入MathTex排版 LaTeX 数学符号并会自动把标签附着在对应轴的正方向末端。示例中的第二个赋值覆盖了第一个说明该方法可以反复调用——实际场景中通常直接传入最终想要的MathTex。这一用法与仓库内可运行的示例 graph_plotting.py 中BasicAxes场景完全一致该场景还示范了用self.play(Create(axes), Write(x_label), Write(y_label))让轴与标签逐帧生长出来。NumberPlane带网格线的坐标平面NumberPlane在坐标轴之上叠加了背景网格是展示坐标线与几何变换的核心容器——当图形发生拉伸、剪切、旋转等线性变换时变形的网格能直观地暴露变换效果。class NumberPlaneExample(Scene): def construct(self): # Default plane plane NumberPlane() self.add(plane)定制 NumberPlane 网格样式class CustomPlane(Scene): def construct(self): plane NumberPlane( x_range[-4, 4, 1], y_range[-3, 3, 1], x_length8, y_length6, background_line_style{ stroke_color: BLUE_D, stroke_width: 1, stroke_opacity: 0.5, }, axis_config{ color: WHITE, }, ) self.add(plane)与Axes的差异在于多了一个background_line_style参数它统一控制所有背景网格线的观感常用键包括stroke_color推荐使用深色系如BLUE_D、GREY以与白色轴线区分、stroke_width细线如1更显克制、stroke_opacity半透明0.5让网格退居幕后。同时仍可通过axis_config单独加亮两条主轴。仓库示例 graph_plotting.py 中的NumberPlaneExample场景给出了网格上叠加元素的完整范式用plane.c2p(2, 3)定位Dot、用Arrow(plane.c2p(0, 0), plane.c2p(2, 3), buff0)画从原点指向该点的向量配合GrowArrow、Write等动画完成一个点在平面上的表示镜头。ComplexPlane复数平面ComplexPlane是NumberPlane的复数语义封装用于把复数可视化为平面上的点。class ComplexPlaneExample(Scene): def construct(self): plane ComplexPlane() # Plot complex number z complex(2, 1) # 2 i dot Dot(plane.n2p(z), colorYELLOW) label MathTex(2i).next_to(dot, UR) self.add(plane, dot, label)关键转换方法是plane.n2p(z)输入一个 Python 内置complex如complex(2, 1)即2i返回该复数在屏幕坐标系上的位置随后即可用Dot落点、用next_to放置标注。如需在屏幕上叠加两个复数进行加减的几何演示只需对n2p返回的点做向量运算即可。NumberLine一维数轴当内容只涉及单变量如区间、单调性、数列时数轴比二维平面更简洁清晰。class NumberLineExample(Scene): def construct(self): line NumberLine( x_range[-5, 5, 1], length10, include_numbersTrue, include_tipTrue, ) self.add(line)注意此处参数名为x_range与lengthlength等价于二维情形下的x_lengthinclude_numbersTrue表示在x_range指定间隔的位置渲染刻度数字。坐标系 ↔ 屏幕坐标的双向转换ManimCE 场景坐标系与屏幕上实际摆放物体的坐标是两套系统Axes(x_range[-5,5], ...)说的是数学定义域而Dot、MathTex的位置参数用的是以画面中心为原点的场景坐标。所有坐标对象都提供成对的方法完成互转规则文档强调一切坐标换算都应使用这些内置方法绝不要手工换算。class CoordinateConversion(Scene): def construct(self): axes Axes(x_range[-5, 5], y_range[-3, 3]) # Convert coordinates to screen position point axes.c2p(2, 1) # coords_to_point: (2, 1) - screen position # Convert screen position to coordinates coords axes.p2c(point) # point_to_coords: screen - (x, y) dot Dot(point, colorRED) self.add(axes, dot)简写方法汇总axes Axes() # c2p coords_to_point axes.c2p(x, y) # p2c point_to_coords axes.p2c(point) # i2gp input_to_graph_point (for graphs) axes.i2gp(x, graph) # For NumberPlane/ComplexPlane plane.n2p(complex_number) # number_to_point plane.p2n(point) # point_to_number把这些方法与 OpenMontage 场景编排习惯结合使用时几个高频模式值得记录需求推荐写法在坐标 (2, 1) 处放一个点Dot(axes.c2p(2, 1), colorYELLOW)让动点沿曲线滑行Dot(axes.i2gp(tracker.get_value(), graph))配合always_redraw在坐标原点画向量到 (2,3)Arrow(axes.c2p(0,0), axes.c2p(2,3), buff0)标注横坐标刻度位置MathTex(2).next_to(axes.c2p(x_val, 0), DOWN)其中i2gp系列在配套的 graphing.md 中有更完整的应用如Moving Point on Graph中用ValueTracker驱动点在正弦曲线上往返并与示例 graph_plotting.py 的切线标注场景互相印证。在坐标轴上绘制点与集合点构造好坐标骨架后最直接的填内容方式就是用c2p把一组数据点投影到轴上class PlotPoints(Scene): def construct(self): axes Axes(x_range[-5, 5], y_range[-3, 3]) points [(1, 2), (-2, 1), (3, -1), (0, 2)] dots VGroup(*[ Dot(axes.c2p(x, y), colorYELLOW) for x, y in points ]) self.add(axes, dots)这里使用列表推导把(x, y)元组批量转换为Dot再用VGroup聚合以便统一管理或整体动画化——点的颜色统一为YELLOW能在深色背景下形成强视觉焦点。对离散数据的进一步处理散点、轨迹连线只需把收集到的c2p结果喂给Polygon、Line或dashed_line即可。ThreeDAxes三维可视化坐标当概念本质上是三维空间关系曲面zf(x,y)、向量场、体积时应切换为ThreeDSceneThreeDAxes。坐标对象层面它与 2D 用法对称只是多出z_range/z_length两个维度class ThreeDAxesExample(ThreeDScene): def construct(self): axes ThreeDAxes( x_range[-4, 4, 1], y_range[-4, 4, 1], z_range[-4, 4, 1], x_length8, y_length8, z_length6, ) self.set_camera_orientation(phi75 * DEGREES, theta-45 * DEGREES) self.add(axes)两条 3D 专属注意点其一必须显式调用set_camera_orientation(phi, theta)设置相机俯仰角与水平转角否则默认视角难以体现立体感phi为相对 z 轴的仰角75 * DEGREES是接近斜俯视的常用值其二ThreeDAxes还额外提供get_z_axis_label()用于标注 z 轴见 3d.md 的 ThreeDAxes 小节。3D 场景相关细节请直接查阅 3d.md 与可运行示例 3d_visualization.py。渲染、验证与自动化从坐标场景到成片命令行直接渲染坐标场景写好后用 ManimCE CLI 渲染。开发期推荐用低质量快速预览出片用高质量全套质量档位如下见 cli.md# Low Quality: 854x480, 15fps快速迭代 manim -ql scene.py AxesExample # Medium Quality: 1280x720, 30fps manim -qm scene.py AxesExample # High Quality: 1920x1080, 60fps manim -qh scene.py AxesExample # 2K / 4K manim -qp scene.py AxesExample manim -qk scene.py AxesExample # 预览渲染后自动打开 manim -pql scene.py AxesExample通过 math_animate 工具渲染在 OpenMontage 内部推荐路径是把Scene代码交给 tools/graphics/math_animate.py 中的math_animate工具它会自动补齐from manim import *若代码缺失自动从Scene|ThreeDScene|MovingCameraScene|ZoomedScene子类中识别场景名并把quality参数映射到上述 CLI 质量标志其QUALITY_PRESETS定义的low/medium/high/4k/preview与-ql/-qm/-qh/-qk一一对应。该工具还支持background_color如深色#1a1a2e、transparent透明背景、formatmp4/gif/webm/png等参数完全覆盖坐标场景的导出需求。需特别注意math_animate会在宿主机上执行调用方提供的 Python 代码属本地代码执行边界issue #219。因此工具默认用_scan_scene_code做静态安全扫描拦截os、subprocess、socket等危险 import、eval/open等内建名及 dunder 属性访问对应守卫逻辑可参见 tests/tools/test_math_animate_safety.py 中的安全用例。坐标场景本身只使用manim命名空间与numpy不会触碰任何被禁构造可以放心通过默认扫描。画质与叙事节奏建议结合 OpenMontage 的数学动画规范 skills/creative/manim-usage.md正式成片用-qh1080p草稿用-qm便于在脚本/旁白对白推进中快速评审默认使用深色背景BLACK或#1a1a2e与axis_config、网格线的配色保持一致单个 Scene 只承载一个概念坐标轴Create之后给1.0-2.0s停留再让曲线、点与标注逐层进入避免同时亮出超过 3-4 个新元素。坐标场景 Best Practices 汇总综合规则文档axes.md的结论与实践经验落地为 5 条可直接执行的原则设置合理的坐标范围——x_range/y_range要紧贴内容不要遗留大块无用空白画面聚焦远胜铺满。让物理长度与范围比例匹配——x_length / y_length应约等于(x_max-x_min) / (y_max-y_min)否则圆会变椭圆、正方形会变矩形造成视觉失真。例如 x 范围跨度 10、y 范围跨度 6 时取x_length10, y_length6即保持等比。变换演示优先用 NumberPlane——网格变形能把平移、缩放、线性变换的形变细节清清楚楚暴露出来比裸轴更有说服力。一切坐标换算走 c2p/p2c/i2gp/n2p/p2n——绝不手工换算这些内置方法同时处理了刻度间隔、物理长度与原点偏移手工换算一旦改轴参数就会整体错位。刻度数字宁缺毋滥——用numbers_to_include只保留必要刻度密集数字是画面噪点的最大来源。若要在坐标骨架上继续绘制函数曲线、参数曲线、面积与黎曼矩形请直接阅读同目录的 graphing.md需要快速验证整套写法的完整可运行参考仓库内提供了覆盖坐标轴标注、函数绘制、参数曲线、切线、动点与黎曼和等场景的 graph_plotting.py一条命令即可渲染manim -pql graph_plotting.py BasicAxes【免费下载链接】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），仅供参考