所谓复数平面,就是一种二维坐标系统,用于几何表示复数的场景,其中横轴代表实部,纵轴代表虚部。
每个点对应一个唯一的复数,反之亦然,这种表示方法使得复数的加法、乘法等运算可以通过直观的图形变换来理解。
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)。
主观感受,仅供参考。本文采用 本文采用 CC BY-NC-SA 4.0 许可 协议,
完整转载请注明来自
数学动画引擎。