直角平面NumberPlane是Manim库中用于创建二维坐标平面的对象,它可以帮助用户在场景中可视化坐标轴以及网格线。

通过坐标轴、网格线以及刻度,它能够动态地展示函数曲线、几何图形以及它们的变换过程,使得复杂的数学概念变得直观易懂。

NumberPlane提供了x轴和y轴,通常是中心对称的,

默认情况下,NumberPlane会显示背景网格,这对于展示数学函数、几何形状等非常有帮助。

我们可以定义坐标平面的范围,为坐标轴添加标签,并将其他形状、函数或动画放置在NumberPlane上,从而在动画中展示数学概念。

下面将介绍Manim中的NumberPlane对象以及一些常用的使用示例。

1. 主要参数

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 应用函数后是否进行平滑处理

0.21 实测:faded_line_ratio 默认 1,此时看不到淡化网格;只有设为 2(或更大)时 faded_line_style 才会生效。add_coordinates() 返回 self,必须在 self.play(FadeIn(plane)) 之前调用。

直角平面中,常见的是坐标轴和背景网格线,其样式通过background_line_style参数来设置。

此外,NumberPlane中还有个faded_line_style参数,它用于定义淡化网格线的样式,

这些淡化网格线通常用于辅助背景网格线,以提供更细致的视觉效果或帮助区分不同的坐标区域。

一般情况下,不需要使用faded_line_style和faded_line_ratio。
更准确地说:faded_line_ratio=1 时淡化线与主网格重合,只有调大比例才能看出分层。

2. 主要方法

Manim中的坐标系统CoordinateSystem类提供了很多方法,包括:

  1. 获取和设置坐标系统属性的方法
  2. 坐标系中坐标和屏幕上坐标转换的方法
  3. 坐标系中绘制图形(点,线,面等等)的方法

后续介绍各种坐标系统时会用在示例中用到其中的方法,这里不再一一介绍。

而NumberPlane继承自CoordinateSystem类,所以可以直接使用它的各种方法。

**坐标换算用 c2p / p2c**:NumberPlane 没有 NumberLine 的 n2p / p2n,坐标 → 屏幕点是 c2p(x, y),反过来是 p2c(point);另一个常用方法是 get_axis_labels(),返回的 VGroup 要自己上屏。

3. 使用示例

下面通过几个示例展示NumberPlane的功能。

构造 ≠ 上屏:所有 NumberPlane(...)、plot_parametric_curve(...) 的返回值都必须 self.add / self.play 才会出现在画面里。老文章里的示例算完 g1、g2 就结束,视频因此是黑的;中文一律用 Text(font="STLiti"),否则会显示成豆腐块。

3.1. 基础二维坐标平面

默认情况下,NumberPlane显示坐标轴和背景网格线,帮助用户清晰地看到坐标系的划分。

坐标轴默认是白色的,背景网格线默认是蓝色的。

下面的示例展示一个标准的二维坐标平面,包含x轴和y轴,

x轴和y轴的范围分别设置为-7~7和-4~4,网格线间隔为1。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
from manim import *
class NumberPlaneBasic(Scene):
"""3.1 基础二维坐标平面。
x_range / y_range 第三位是网格间隔,x_length / y_length 是屏幕上的显示尺寸;
坐标轴默认白色、背景网格默认蓝色。add_coordinates() 要在 FadeIn 之前调用。
"""
def construct(self):
title = Text("基础二维坐标平面 NumberPlane", font="STLiti", font_size=32).to_edge(UP)
plane = NumberPlane(x_range=[-7, 7, 1], y_range=[-4, 4, 1],
x_length=10, y_length=5.5)
plane.add_coordinates()
self.play(FadeIn(title), run_time=0.6)
self.play(FadeIn(plane), run_time=1.6)
note = Text("x_range=[-7,7,1] y_range=[-4,4,1] 网格间隔为 1",
font="STLiti", font_size=22, color=YELLOW).to_edge(DOWN)
self.play(FadeIn(note), run_time=0.6)
self.wait(3.4)

下载 Python 脚本

3.2. 自定义网格线样式

NumberPlane的背景网格线和淡化网格线的样式都可以自定义,

下面的示例对背景网格线和淡化网格线的颜色、宽度和透明度进行了设置。

背景网格线是青色,淡化网格线是灰色。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
from manim import *
class NumberPlaneStyles(Scene):
"""3.2 background_line_style 控制主网格,faded_line_style 控制被
faded_line_ratio 拆出来的辅助网格,默认 ratio=1 时看不到淡化线。
"""
def construct(self):
title = Text("自定义网格线样式", font="STLiti", font_size=32).to_edge(UP)
plane = NumberPlane(
x_range=[-7, 7, 1], y_range=[-4, 4, 1], x_length=10, y_length=5.5,
background_line_style=dict(stroke_color=TEAL, stroke_width=4,
stroke_opacity=0.6),
faded_line_style=dict(stroke_color=GREY, stroke_width=2,
stroke_opacity=0.3),
faded_line_ratio=2)
self.play(FadeIn(title), run_time=0.6)
self.play(FadeIn(plane), run_time=1.8)
note = Text("青色主网格 + 灰色淡化网格,faded_line_ratio=2",
font="STLiti", font_size=22, color=YELLOW).to_edge(DOWN)
self.play(FadeIn(note), run_time=0.6)
self.wait(3.2)

下载 Python 脚本

这里 faded_line_ratio=2 表示每 1 格背景网格线之间再插入 2 格淡化网格线;取值越大辅助线越密。stroke_color / stroke_width / stroke_opacity 分别控制颜色、粗细与透明度。

3.3. 不同比例的坐标轴

默认情况下,NumberPlane 两个方向的单位长度是相等的;但 x_length / y_length 是屏幕上的显示尺寸,x_range / y_range 决定每格代表多少数值,两者一变,网格就会被横向或纵向压扁。

实际上,通过设置不同的坐标范围和显示范围,可以创建不同比例的坐标轴。

也就是Y轴的间隔可以大于X轴的间隔,也可以小于X轴的间隔。

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
from manim import *
class NumberPlaneRatio(Scene):
"""3.3 同样的显示尺寸下,坐标范围不同,单位长度就不同。
左边 x 方向被压扁(14 个单位挤进 4.5),右边 y 方向被压扁;
老示例只上屏了 plane2,这里两个一起淡入做对照。
"""
def construct(self):
title = Text("不同比例的坐标轴", font="STLiti", font_size=32).to_edge(UP)
p1 = NumberPlane(x_range=[-7, 7], y_range=[-3, 3],
x_length=4.5, y_length=4.5)
p2 = NumberPlane(x_range=[-3, 3], y_range=[-7, 7],
x_length=4.5, y_length=4.5)
caps = VGroup(
Text("x: -7~7 y: -3~3 横向压缩", font="STLiti", font_size=20, color=YELLOW),
Text("x: -3~3 y: -7~7 纵向压缩", font="STLiti", font_size=20, color=YELLOW),
)
planes = VGroup(p1, p2).arrange(RIGHT, buff=1.4).shift(DOWN * 0.35)
for c, p in zip(caps, planes):
c.next_to(p, UP, buff=0.3)
self.play(FadeIn(title), run_time=0.6)
self.play(LaggedStart(*[FadeIn(p) for p in planes],
lag_ratio=0.3, run_time=1.8))
self.play(LaggedStart(*[FadeIn(c) for c in caps],
lag_ratio=0.2, run_time=1.0))
note = Text("显示尺寸相同,坐标范围决定每格代表的数值",
font="STLiti", font_size=20, color=GREY).to_edge(DOWN)
self.play(FadeIn(note), run_time=0.6)
self.wait(3.0)

下载 Python 脚本

3.4. 绘制函数图像

使用NumberPlane最大的用途就在于可以在其中绘制函数图像,在坐标系中绘制图像或几何图形,

可以更方便的定位它们的位置,调整它们之间的变换关系。

下面用坐标系基类提供的 plot_parametric_curve 绘制 y = x² 与 y = x³ 两条曲线。该函数返回 ParametricFunction,第一个参数是 lambda t: [x(t), y(t)],t_range 第三位是采样步长;返回值必须 self.play(Create(...)) 才会上屏。

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
from manim import *
class NumberPlaneCurves(Scene):
"""3.4 plot_parametric_curve 返回 ParametricFunction,
必须 self.play(Create(...)) 才会上屏;老示例把 g1/g2 算出来就结束,视频是黑的。
函数返回 [x, y] 形式的二维点,t_range 第三位是采样步长。
"""
def construct(self):
title = Text("在坐标平面上绘制函数图像", font="STLiti", font_size=32).to_edge(UP)
plane = NumberPlane(x_range=[-4, 4, 1], y_range=[-16, 16, 4],
x_length=6, y_length=6)
parabola = plane.plot_parametric_curve(
lambda x: [x, x ** 2], t_range=[-3.5, 3.5, 0.01],
color=YELLOW, stroke_width=4)
cubic = plane.plot_parametric_curve(
lambda x: [x, x ** 3], t_range=[-2.5, 2.5, 0.01],
color=RED, stroke_width=4)
legend = VGroup(
Text("y = x² 抛物线(黄)", font="STLiti", font_size=21, color=YELLOW),
Text("y = x³ 三次曲线(红)", font="STLiti", font_size=21, color=RED),
).arrange(DOWN, aligned_edge=LEFT, buff=0.16).to_corner(DL)
self.play(FadeIn(title), run_time=0.6)
self.play(FadeIn(plane), run_time=1.0)
self.play(LaggedStart(Create(parabola), Create(cubic),
lag_ratio=0.5, run_time=2.4))
self.play(FadeIn(legend), run_time=0.8)
self.wait(2.8)

下载 Python 脚本

4. 附件

本文 4 个脚本可直接运行(Manim CE 0.21.0),例如 manim -qh --disable_caching -a 20241020091329000.py;四个脚本分别对应 3.1~3.4 的视频。