Torus类在制作数学、物理或工程领域的动画时具有广泛的应用场景。
比如,通过动态演示环面的拓扑变换(如内外翻转、扭曲等),帮助我们直观地理解拓扑不变量和同胚等概念;
此外,也可以模拟磁场线在环面导体中的分布和运动,展示电磁感应现象等等。
本篇介绍Torus的主要参数和基本使用方法。
1. 主要参数
Torus的参数不多,主要有:
| 参数名称 |
类型 |
说明 |
| major_radius |
float |
圆环面的主要半径,从环面中心到其管道中心(或称为环面中心轴)的距离 |
| minor_radius |
float |
环面管道的半径 |
| resolution |
[int, int] |
环面表面的分辨率,用于控制渲染的精细程度 |
| u_range |
[float, float] |
绕环面中心大圈的角度范围,默认 (0, TAU) |
| v_range |
[float] |
定义了圆环面在v方向上的参数化范围 |
| v_range |
[float, float] |
绕管道截面的角度范围,默认 (0, TAU) |
0.21 实测:u_range / v_range 默认都是 (0, TAU)(整圈 2π)。u 绕大圈、v 绕截面——缩小 u_range 会缺一个扇形,缩小 v_range 会削掉一层管道外壳;resolution 在 Cairo 渲染器下默认 (24, 24)。
Torus 是三维对象:它继承自 Surface,要用 ThreeDScene 并调用 self.set_camera_orientation(phi=65*DEGREES, theta=-45*DEGREES) 转动相机,才能看到甜甜圈的立体形状;普通 Scene 从 +z 方向俯视只得到一个平面圆环。中文一律用 Text(font="STLiti"),屏幕说明用 add_fixed_in_frame_mobjects() 固定。
如果把Torus圆环面看成一个轮胎的话,
那么,major_radius参数表示轮胎的大小,minor_radius参数表示轮胎的厚度。
2. 使用示例
为了有效展示Torus(圆环面)各个参数的使用,下面构造四个示例,
每个示例将突出Torus类的一个或几个关键参数,并说明这些参数如何影响环面的外观和特性。
2.1. 标准圆环面
这是一个标准的环面,其中major_radius决定了环面的大小,minor_radius决定了环面管道的厚度,
而resolution控制了环面表面的平滑度。
通过调整这些参数,可以获得不同大小和形状的环面。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
| from manim import * class TorusBasic(ThreeDScene): """2.1 标准环面。Torus 是 Surface 的子类,属于三维对象, 用 ThreeDScene + set_camera_orientation 转一下相机才能看出甜甜圈的立体形状; 若用普通 Scene 从 +z 方向俯视,只会得到一个平面圆环。 """ def construct(self): self.set_camera_orientation(phi=65 * DEGREES, theta=-45 * DEGREES) title = Text("标准环面 Torus", font="STLiti", font_size=34).to_edge(UP) self.add_fixed_in_frame_mobjects(title) torus = Torus(major_radius=2.5, minor_radius=0.5, resolution=(30, 30), checkerboard_colors=[BLUE_D, BLUE_E]) self.play(FadeIn(title), run_time=0.6) self.play(FadeIn(torus), run_time=1.8) note = Text("major_radius=2.5 轮胎大小 | minor_radius=0.5 管道厚度", font="STLiti", font_size=22, color=YELLOW).to_edge(DOWN) self.add_fixed_in_frame_mobjects(note) self.play(FadeIn(note), run_time=0.6) self.wait(3.2)
|
下载 Python 脚本
2.2. 半管圆环面(v_range)
通过限制 v_range,可以削掉环面管道的一部分外壳。
本例 v_range=(0, PI/2) 只取截面的 1/4 圈(默认 (0, TAU) 是整圈),得到的是一个半管而不是「扁平的环面」——视频里能清楚看到碗状的开口。
v 控制的是管道截面,不影响大圈半径,所以环面的整体大小并不改变。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
| from manim import * class TorusVRange(ThreeDScene): """2.2 限制 v_range 得到「半管」环面。 v 是绕管道截面转一圈的参数,(0, PI/2) 只画四分之一圈截面, 所以环面看起来更薄、更少一层外壳。 """ def construct(self): self.set_camera_orientation(phi=65 * DEGREES, theta=-45 * DEGREES) title = Text("v_range=(0, π/2) 限制管道截面", font="STLiti", font_size=32).to_edge(UP) self.add_fixed_in_frame_mobjects(title) torus = Torus(major_radius=2.5, minor_radius=0.5, resolution=(30, 30), v_range=(0, PI / 2), checkerboard_colors=[TEAL_D, TEAL_E]) self.play(FadeIn(title), run_time=0.6) self.play(FadeIn(torus), run_time=1.8) note = Text("v 方向只取 1/4 圈,管道外壳被削去,视觉上更扁平", font="STLiti", font_size=22, color=YELLOW).to_edge(DOWN) self.add_fixed_in_frame_mobjects(note) self.play(FadeIn(note), run_time=0.6) self.wait(3.2)
|
下载 Python 脚本
2.3. 高分辨率圆环面
增加resolution的值可以提高环面表面的平滑度和细节程度。
本例 resolution 取 (60, 60),远高于 Cairo 默认的 (24, 24),网格更密、边缘更圆润。
性能提示:原文的 (100, 100) 会生成一万个面,在 1920×1080/60fps 下实测超过单次渲染 5 分钟上限,因此本脚本改用 (60, 60)。机器性能足够时再往上调,但渲染耗时大致随分辨率平方级增长。
高分辨率环面在渲染复杂场景或制作高质量动画时非常有用。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
| from manim import * class TorusResolution(ThreeDScene): """2.3 提高 resolution 让曲面更平滑。 Cairo 渲染器下 Torus 默认 resolution=(24, 24), 放大到 (60, 60) 后网格更密、边缘更圆润,渲染耗时也明显增加。 原文的 (100, 100) 在 1920x1080/60fps 下实测超过 5 分钟渲染上限, 这里取一个肉眼可辨又能在常规机器上跑完的折中值。 """ def construct(self): self.set_camera_orientation(phi=65 * DEGREES, theta=-45 * DEGREES) title = Text("resolution=(60, 60) 高分辨率", font="STLiti", font_size=32).to_edge(UP) self.add_fixed_in_frame_mobjects(title) torus = Torus(major_radius=2.5, minor_radius=0.5, resolution=(60, 60), checkerboard_colors=[GREEN_D, GREEN_E]) self.play(FadeIn(title), run_time=0.6) self.play(FadeIn(torus), run_time=1.8) note = Text("网格更密、边缘更圆润;分辨率越高渲染越慢", font="STLiti", font_size=22, color=YELLOW).to_edge(DOWN) self.add_fixed_in_frame_mobjects(note) self.play(FadeIn(note), run_time=0.6) self.wait(3.2)
|
下载 Python 脚本
2.4. 缺口圆环面(u_range)
通过调整u_range的值,我们可以创建一个非标准的环面。
本例 u_range=(0, 3*PI/2) 只取大圈的 3/4(默认 (0, TAU) 是整圈),范围是被缩小而不是扩展,所以环面缺了一个 90° 的扇形。
u 与 v 的分工:u 绕环面中心的大圈转,v 绕管道截面转。缩小 u_range → 缺一个扇形;缩小 v_range → 削掉一层外壳。
这种非标准环面可以用于艺术创作、数学可视化或物理模拟等领域,以展示环面在不同参数设置下的多样性和灵活性。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
| from manim import * class TorusURange(ThreeDScene): """2.4 限制 u_range 得到缺口环面。 u 是绕环面中心大圈转的参数,(0, 3π/2) 只画 3/4 圈, 所以画面上会缺掉一个 90° 的扇形。 """ def construct(self): self.set_camera_orientation(phi=65 * DEGREES, theta=-45 * DEGREES) title = Text("u_range=(0, 3π/2) 缺 90° 扇形", font="STLiti", font_size=32).to_edge(UP) self.add_fixed_in_frame_mobjects(title) torus = Torus(major_radius=2.5, minor_radius=0.5, resolution=(30, 30), u_range=(0, 3 * PI / 2), checkerboard_colors=[PURPLE_D, PURPLE_E]) self.play(FadeIn(title), run_time=0.6) self.play(FadeIn(torus), run_time=1.8) note = Text("u 方向只取 3/4 圈,环面缺一角;u 管大圈、v 管截面", font="STLiti", font_size=22, color=YELLOW).to_edge(DOWN) self.add_fixed_in_frame_mobjects(note) self.play(FadeIn(note), run_time=0.6) self.wait(3.2)
|
下载 Python 脚本
3. 附件
本文 4 个脚本都是 ThreeDScene,可直接运行(Manim CE 0.21.0),例如 manim -qh --disable_caching -a 20241007102557000.py;四个脚本分别对应 2.1~2.4 的视频,中文一律用 Text(font="STLiti"),否则会显示成豆腐块。
主观感受,仅供参考。本文采用 本文采用 CC BY-NC-SA 4.0 许可 协议,
完整转载请注明来自
数学动画引擎。