所谓复数平面,就是一种二维坐标系统,用于几何表示复数的场景,其中横轴代表实部,纵轴代表虚部。

每个点对应一个唯一的复数,反之亦然,这种表示方法使得复数的加法、乘法等运算可以通过直观的图形变换来理解。

ComplexPlane是Manim库中用于处理复数平面的类。

它不仅提供了标准的笛卡尔坐标系,还特别针对复数操作进行了优化,使得复数及其变换的可视化变得更加直观。

通过 ComplexPlane,我们可以轻松地绘制出复数点、向量以及执行复数变换,如旋转、缩放等。

本篇将介绍Manim中的ComplexPlane对象以及一些常用的使用示例。

1. 主要参数

ComplexPlane继承自上一篇介绍的NumberPlane,

ComplexPlane没有自己特有的参数,和NumberPlane的参数是一样的。

参数名称 类型 说明
x_range Sequence[float] 直角平面的横坐标轴范围,间隔
y_range Sequence[float] 直角平面的纵坐标轴范围,间隔
x_length float 直角平面宽度
y_length float 直角平面高度
background_line_style dict 直角平面背景网格线的样式
faded_line_style dict 淡化网格线的样式,用于辅助背景网格线
faded_line_ratio int 定义淡化网格线与背景网格线的比例
make_smooth_after_applying_functions bool 应用函数后是否进行平滑处理

2. 主要方法

和NumberPlane一样,ComplexPlane也包含了坐标系统CoordinateSystem类提供的方法,

不过,在复数平面中,我比较常用的是以下3个方法:

名称 说明
add_coordinates 给复数平面的坐标轴添加刻度数值
n2p(number_to_point) 根据复数得到此复数在复数平面上的位置
p2n(point_to_number) 根据复数平面上的位置得到对应的复数

0.21 实测补充:add_coordinates() 返回 self,可链式写成 ComplexPlane(...).add_coordinates();而且要在 FadeIn(plane) 之前调用,刻度才会随入场动画一起出现。n2p(z) 接受 Python 复数(如 3+2j)并返回画面坐标,p2n(点) 反向还原,两者互逆。另外平面若被 shift() 过,n2p 返回的仍是未平移的局部坐标,标点时容易错位——所以本文示例都不平移平面。

最容易踩的坑:ComplexPlane(...) 与 Dot(...) 只是构造对象,必须 self.add(...) 或 self.play(FadeIn(...)) 才会显示。原文 3.2 / 3.3 的片段一个对象都没上屏,渲染出来就是纯黑片。

3. 使用示例

下面通过示例来演示复数平面ComplexPlane的多种功能,包括复数平面的网格与坐标轴,复数点的标记与展示、复数平面上的函数图像、复数变换动画等。

让ComplexPlane成为我们展示复数概念和性质的有力工具。

3.1. 网格与坐标轴

创建一个复数平面ComplexPlane,绘制网格线和坐标轴,设置实部的范围[-5, 5],虚部的范围[-4, 4],最后再给坐标轴加上刻度值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
from manim import *
class ComplexPlaneGrid(Scene):
"""3.1 复数平面:横轴是实部、纵轴是虚部,add_coordinates() 加刻度数值。
0.21 里 add_coordinates() 返回 self,可以链式;必须在 FadeIn 之前调用,
否则刻度不会随这次入场动画一起出现。原脚本混入的 run_time / data / dot()
等无关变量已全部去掉,这里只保留讲这个知识点用得上的代码。
"""
def construct(self):
kw = dict(font="STLiti")
title = Text("3.1 复数平面的网格与坐标轴", font_size=36, color=RED, **kw).to_edge(UP, buff=0.28)
rule = Line(LEFT * 6.6, RIGHT * 6.6, color=BLUE_B, stroke_width=3).next_to(title, DOWN, buff=0.16)
plane = ComplexPlane(x_range=[-5, 5, 1], y_range=[-4, 4, 1],
x_length=9.5, y_length=5.5).add_coordinates()
note = Text("横轴表示实部,纵轴表示虚部;平面上每个点对应唯一一个复数",
font_size=24, color=GREY_B, **kw).to_edge(DOWN, buff=0.25)
self.play(FadeIn(title), FadeIn(rule), run_time=0.7)
self.play(FadeIn(plane), run_time=1.6)
self.play(FadeIn(note), run_time=0.6)
self.wait(3.0)

下载 Python 脚本

3.2. 复数点的标记

在复数平面坐标上添加2个复数点,再给这两个点添加标签,显示其复数的值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
from manim import *
class ComplexPlanePoints(Scene):
"""3.2 用 n2p 把复数换成画面坐标,再标点与写标签。
原文片段没有 import、没有 Scene,plane 与两个 Dot 也从未 self.add / self.play,
所以渲染出来是全黑;下面给出可直接运行的完整写法。
"""
def construct(self):
kw = dict(font="STLiti")
title = Text("3.2 在复数平面上标记复数点", font_size=36, color=RED, **kw).to_edge(UP, buff=0.28)
rule = Line(LEFT * 6.6, RIGHT * 6.6, color=BLUE_B, stroke_width=3).next_to(title, DOWN, buff=0.16)
plane = ComplexPlane(x_range=[-5, 5, 1], y_range=[-5, 5, 1],
x_length=8.4, y_length=5.6).add_coordinates()
z1, z2 = 3 + 2j, -4 - 2j
d1 = Dot(plane.n2p(z1), radius=0.13, color=YELLOW)
d2 = Dot(plane.n2p(z2), radius=0.13, color=RED)
l1 = Text("z = 3 + 2i", font_size=26, color=YELLOW, **kw).next_to(d1, UR, buff=0.15)
l2 = Text("z = -4 - 2i", font_size=26, color=RED, **kw).next_to(d2, DL, buff=0.15)
note = Text("n2p(z) 把复数转成画面坐标;p2n(点) 可反向还原成复数",
font_size=24, color=GREY_B, **kw).to_edge(DOWN, buff=0.25)
self.play(FadeIn(title), FadeIn(rule), run_time=0.7)
self.play(FadeIn(plane), run_time=1.4)
self.play(FadeIn(d1), FadeIn(d2), run_time=0.9)
self.play(FadeIn(l1), FadeIn(l2), run_time=0.9)
self.play(FadeIn(note), run_time=0.6)
self.wait(2.4)

下载 Python 脚本

3.3. 复数运算

复数平面上添加两个点,然后计算这两个复数相加的结果,并将计算过程在复数平面上用动画显示出来。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
from manim import *
class ComplexPlaneAdd(Scene):
"""3.3 复数加法:(2+i) + (2+4i) = 4+5i。
三条从原点出发的箭头分别对应两个加数与它们的和,几何上就是向量相加。
原文只写了三个 Dot,既没上屏也没体现「相加」的过程,这里改成完整演示。
"""
def construct(self):
kw = dict(font="STLiti")
title = Text("3.3 复数加法在平面上的含义", font_size=36, color=RED, **kw).to_edge(UP, buff=0.28)
rule = Line(LEFT * 6.6, RIGHT * 6.6, color=BLUE_B, stroke_width=3).next_to(title, DOWN, buff=0.16)
plane = ComplexPlane(x_range=[-1, 8, 1], y_range=[-1, 8, 1],
x_length=5.5, y_length=5.5).add_coordinates()
O = plane.n2p(0)
a, b = 2 + 1j, 2 + 4j
c = a + b
arrows = VGroup(
Arrow(O, plane.n2p(a), color=BLUE, buff=0, stroke_width=4),
Arrow(O, plane.n2p(b), color=GREEN, buff=0, stroke_width=4),
Arrow(O, plane.n2p(c), color=YELLOW, buff=0, stroke_width=5),
)
caps = VGroup(
Text("z1 = 2 + i", font_size=24, color=BLUE, **kw).next_to(plane.n2p(a), DOWN, buff=0.18),
Text("z2 = 2 + 4i", font_size=24, color=GREEN, **kw).next_to(plane.n2p(b), LEFT, buff=0.18),
Text("z1 + z2 = 4 + 5i", font_size=24, color=YELLOW, **kw).next_to(plane.n2p(c), UR, buff=0.15),
)
note = Text("实部与实部相加、虚部与虚部相加,对应平面上两个向量相加",
font_size=24, color=GREY_B, **kw).to_edge(DOWN, buff=0.25)
self.play(FadeIn(title), FadeIn(rule), run_time=0.7)
self.play(FadeIn(plane), run_time=1.3)
self.play(LaggedStart(*[GrowArrow(x) for x in arrows], lag_ratio=0.25, run_time=1.4))
self.play(LaggedStart(*[FadeIn(x) for x in caps], lag_ratio=0.2, run_time=1.0))
self.play(FadeIn(note), run_time=0.6)
self.wait(2.2)

下载 Python 脚本

3.4. 复数变换

最后,是复数点经过一个函数变换后,在复数平面上显示新的位置。

示例中先给出 4 个复数点,再让每个点乘上单位复数 e^(iπ/4),也就是绕原点逆时针旋转 45°,最后把变换前后的位置同时画出来做对比。

说明:原文这句话把公式重复粘贴了三次(f(x)=2xf(x)=2^xf(x)=2x),旧代码用 np.exp2(plane.p2n(...)) 算出 pd1..pd4 后再也没用过,变换后的点根本没上屏,「变换」其实没有发生。这里改用旋转 45°这个更直观的复数变换,并完整走一遍 p2n → 计算 → n2p:蓝色是变换前的点,黄色是变换后的点,灰色箭头表示移动方向。

其中用到了ComplexPlane的主要方法n2p和p2n。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
from manim import *
import numpy as np
class ComplexPlaneTransform(Scene):
"""3.4 复数变换:4 个点乘上 e^(iπ/4),即整体逆时针旋转 45°。
原文把 np.exp2(plane.p2n(...)) 的结果存进 pd1..pd4 后再没用过,
变换后的点根本没上屏,「变换」其实没有发生。这里走完整的
p2n → 计算 → n2p 流程,并把变换前(蓝)与变换后(黄)两组点同时画出。
"""
def construct(self):
kw = dict(font="STLiti")
title = Text("3.4 复数变换:旋转 45 度", font_size=36, color=RED, **kw).to_edge(UP, buff=0.28)
rule = Line(LEFT * 6.6, RIGHT * 6.6, color=BLUE_B, stroke_width=3).next_to(title, DOWN, buff=0.16)
plane = ComplexPlane(x_range=[-5, 5, 1], y_range=[-5, 5, 1],
x_length=5.6, y_length=5.6).add_coordinates()
rot = np.exp(1j * PI / 4)
zs = [2 + 1j, 2 + 3j, -2 - 2j, -3 + 2j]
before = VGroup(*[LabeledDot(
label=Text(str(i + 1), font="STLiti", font_size=20, color=WHITE),
point=plane.n2p(z), color=BLUE) for i, z in enumerate(zs)])
after = VGroup(*[LabeledDot(
label=Text(str(i + 1), font="STLiti", font_size=20, color=BLACK),
point=plane.n2p(z * rot), color=YELLOW) for i, z in enumerate(zs)])
arrows = VGroup(*[Arrow(plane.n2p(z), plane.n2p(z * rot), color=GREY_B,
stroke_width=2, buff=0.18) for z in zs])
note = Text("f(z) = z · e^(iπ/4):乘上单位复数就是绕原点逆时针旋转 45 度",
font_size=24, color=GREY_B, **kw).to_edge(DOWN, buff=0.25)
self.play(FadeIn(title), FadeIn(rule), run_time=0.7)
self.play(FadeIn(plane), run_time=1.2)
self.play(FadeIn(before), run_time=1.0)
self.play(FadeIn(arrows), FadeIn(after), run_time=1.2)
self.play(FadeIn(note), run_time=0.6)
self.wait(2.4)

下载 Python 脚本

4. 附件

本文 4 段示例均为完整可运行的 Scene,可直接复制保存为 .py 后用 manim -qh 文件名.py 场景名 渲染;每段视频下方也提供了对应的站内脚本下载链接。中文文字统一显式指定 font="STLiti",避免默认西文字体渲染中文时出现豆腐块。

环境:Manim CE 0.21.0;演示视频由上述脚本真实渲染生成(1920×1080 / 60fps)。