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"),否则会显示成豆腐块。