数轴是数学中的一个基本概念,它规定了原点、正方向和单位长度的直线。

Manim中的NumberLine就是一个专门用来表示数轴的对象,它允许用户设置数轴的范围、间隔和显示长度等参数,从而灵活地在动画中展示数学中的一维数值变化。

下面将介绍Manim中的NumberLine对象的基本功能到使用示例。

1. 主要参数

NumberLine的参数很多,定制性很强,能够满足各式各样对于数轴显示的需求。

参数名称 类型 说明
x_range Sequence[float] 数轴刻度的范围
length float 数轴的长度
unit_size float 刻度之间的距离
include_ticks bool 是否包含刻度
tick_size float 刻度标记的长度
numbers_with_elongated_ticks Iterable[float] 拉伸的特殊刻度列表
longer_tick_multiple int 被拉伸刻度的拉伸比例
rotation float 数轴旋转的角度
stroke_width float 数轴线的粗细
include_tip bool 数轴是否包含箭头
tip_width float 箭头的宽度
tip_height float 箭头的高度
tip_shape ArrowTip 数轴的箭头类型
include_numbers bool 刻度是否包含数值
scaling _ScaleBase 数轴的比例
font_size float 刻度上文字的大小
label_direction Sequence[float] 刻度上文字的方向
label_constructor VMobject 构建刻度上文字的对象
line_to_number_buff float 数轴的线和文字的距离
decimal_number_config dict 刻度上文字的样式配置
numbers_to_exclude Iterable[float] 不需要显示文字的刻度列表
numbers_to_include Iterable[float] 需要显示文字的刻度列表

0.21 默认值:include_tip=False、include_numbers=False、label_constructor=MathTex、font_size=36、scaling=LinearBase();tip_shape 接收的是 ArrowTip 的类(不是实例)。

参数很多,但是主要分为3个部分(数轴的线,刻度和数值)的设置。

manim边做边学--数轴

比如,参数名称中含有 tick的,一般是设置上图中蓝色部分(刻度)的;

参数名称中含有tip或line的,一般是设置上图中红色线以及箭头部分(数轴线)的;

参数名称中含有label或number的,一般是设置上图中黄色数字部分(数值)的。

其他的参数也是与上面3部分相关的,后面的示例会演示各种参数的使用。

2. 主要方法

数轴提供的主要方法有:

名称 说明
add_labels 数轴上某些位置添加标签文字
add_numbers 数轴上添加数值
add_ticks 数轴上添加刻度
get_labels 获取数轴上的标签文字
get_number_mobject 获取数轴上的数值对象
get_tick 获取数轴上的刻度
get_tick_range 获取数轴上的刻度范围
n2p(number_to_point) 根据数值得到此数值在数轴上的位置
p2n(point_to_number) 根据数轴上的位置得到对应的数值

动态在数轴上添加,修改,删除内容时,这些方法很有用。

3. 使用示例

数轴(NumberLine)的参数和方法都不少,无法一一演示,下面的示例从数轴的样式,

刻度和数值设置,以及数据点在数轴上动态移动等几个方面演示数轴的使用。

所有示例都遵守两条:① 构造出来的对象必须 self.add / self.play 才会上屏,老文章里的示例只写了一堆 l1 = NumberLine(...) 就结束,画面自然是黑的;② 中文一律 Text(font="STLiti"),否则会显示成豆腐块。

3.1. 数轴大小和颜色

数轴(NumberLine)的大小和颜色是最常设置的,相关的参数主要有length,stroke_width和color。

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 NumberLineSizeColor(Scene):
"""3.1 length 控制整条数轴的显示长度,stroke_width + color 控制线的粗细与颜色。
x_range 相同(都是 -5~5)时,length 只改变视觉尺寸,不改变刻度代表的数值。
六个对象全部要上屏,老示例只构造不上屏,画面自然是黑的。
"""
def construct(self):
title = Text("length / stroke_width / color", font="STLiti", font_size=32).to_edge(UP)
left = VGroup()
for n in (2, 4, 6):
line = NumberLine(x_range=[-5, 5], length=n)
cap = Text("length = %d" % n, font="STLiti", font_size=20, color=YELLOW)
left.add(VGroup(cap, line).arrange(DOWN, buff=0.12))
left.arrange(DOWN, buff=0.42)
right = VGroup()
for w, c, name in ((1, BLUE, "细 蓝"), (3, RED, "中 红"), (6, GREEN, "粗 绿")):
line = NumberLine(x_range=[-5, 5], length=4, stroke_width=w, color=c)
cap = Text("width=%d %s" % (w, name), font="STLiti", font_size=20, color=c)
right.add(VGroup(cap, line).arrange(DOWN, buff=0.12))
right.arrange(DOWN, buff=0.42)
group = VGroup(left, right).arrange(RIGHT, buff=1.2).shift(DOWN * 0.35)
self.play(FadeIn(title), run_time=0.6)
self.play(LaggedStart(*[FadeIn(x) for x in group],
lag_ratio=0.15, run_time=2.0))
note = Text("x_range 不变,length 只改视觉尺寸;color 是继承自 VMobject 的通用参数",
font="STLiti", font_size=20, color=GREY).to_edge(DOWN)
self.play(FadeIn(note), run_time=0.6)
self.wait(3.0)

下载 Python 脚本

3.2. 数轴线的箭头

数轴默认是没有箭头的,通过tip相关参数,可以在数轴的正方向添加不同样式箭头。

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
from manim import *
class NumberLineTips(Scene):
"""3.2 include_tip 打开箭头,tip_shape 接收 ArrowTip 的「类」而不是实例。
tip_width / tip_height 控制箭头大小,默认 tip_shape=None 用三角箭头。
"""
def construct(self):
title = Text("include_tip 与 5 种 tip_shape", font="STLiti", font_size=32).to_edge(UP)
specs = [
("默认三角", None),
("ArrowCircleTip 空心圆", ArrowCircleTip),
("ArrowCircleFilledTip 实心圆", ArrowCircleFilledTip),
("ArrowSquareTip 方头", ArrowSquareTip),
("StealthTip 隐形式", StealthTip),
]
rows = VGroup()
for name, shape in specs:
kw = dict(x_range=[-5, 6], length=6, include_tip=True,
tip_width=0.18, tip_height=0.18, include_numbers=False)
if shape is not None:
kw["tip_shape"] = shape
line = NumberLine(**kw)
cap = Text(name, font="STLiti", font_size=19, color=YELLOW)
rows.add(VGroup(cap, line).arrange(RIGHT, buff=0.35))
rows.arrange(DOWN, buff=0.5).shift(DOWN * 0.3)
self.play(FadeIn(title), run_time=0.6)
self.play(LaggedStart(*[FadeIn(x) for x in rows],
lag_ratio=0.18, run_time=2.2))
note = Text("tip_shape 传类本身,箭头尺寸用 tip_width / tip_height",
font="STLiti", font_size=20, color=GREY).to_edge(DOWN)
self.play(FadeIn(note), run_time=0.6)
self.wait(3.0)

下载 Python 脚本

3.3. 刻度和数值

NumberLine 默认带刻度,但数值默认不显示(0.21 的 include_numbers 是 False),要写 include_numbers=True 或调用 add_numbers();x_range 的第三位控制刻度步长。

通过scaling参数,可以在相同间隔的刻度上显示不均匀的数值;还可以突出显示某些刻度。

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 NumberLineTicks(Scene):
"""3.3 x_range 第三位是刻度步长;include_numbers=True 才会把数值画出来
(0.21 里默认是 False)。scaling=LogBase(base=10) 让等距刻度显示 10 的幂。
"""
def construct(self):
title = Text("刻度步长 与 对数刻度", font="STLiti", font_size=32).to_edge(UP)
specs = [
("步长 1:x_range=[-6, 6, 1]", dict(x_range=[-6, 6, 1])),
("步长 2:x_range=[-6, 6, 2]", dict(x_range=[-6, 6, 2])),
("对数:scaling=LogBase(10)", dict(x_range=[0, 5, 1],
scaling=LogBase(base=10))),
]
rows = VGroup()
for name, kw in specs:
line = NumberLine(length=7, include_numbers=True, font_size=26, **kw)
cap = Text(name, font="STLiti", font_size=19, color=YELLOW)
rows.add(VGroup(cap, line).arrange(DOWN, buff=0.18))
rows.arrange(DOWN, buff=0.55).shift(DOWN * 0.3)
self.play(FadeIn(title), run_time=0.6)
self.play(LaggedStart(*[FadeIn(x) for x in rows],
lag_ratio=0.25, run_time=2.2))
note = Text("include_numbers 默认是 False;对数刻度等距显示 10^0 10^1 10^2 ...",
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. 数轴上的数据点

数轴上的点和显示在屏幕的位置是不一样的,通过数轴提供的函数n2p和p2n,

可以很容易的将屏幕上的点映射到数轴上,也可以根据数轴上的点计算其在屏幕上的位置。

下面的动画示例,首先根据数轴上的值获取其在屏幕上的位置,然后绘制这个点。

接下来,移动这个点,移动的过程中同时显示此点在数轴上的数值。

实现要点:用 ValueTracker 保存数值,always_redraw 让 Dot(line.n2p(x)) 与数值标签每帧重算;p2n 把点的屏幕坐标换回数值,两者互逆。老示例只写了一句 p = l.n2p(-4) 就结束,点根本没画出来,更没有移动。

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
from manim import *
class NumberLineDataPoint(Scene):
"""3.4 n2p(数值→屏幕点)与 p2n(屏幕点→数值)互逆。
用 ValueTracker 驱动点的位置,always_redraw 让点与数值标签实时跟随,
这才是原文描述的「移动点并同步显示数值」;老示例只算了一句 p = l.n2p(-4) 就结束。
"""
def construct(self):
title = Text("n2p / p2n 数轴上的数据点", font="STLiti", font_size=32).to_edge(UP)
line = NumberLine(x_range=[-6, 6, 1], length=10, include_numbers=True,
font_size=26).shift(DOWN * 0.6)
tracker = ValueTracker(-4)
self.add(tracker)
dot = always_redraw(lambda: Dot(line.n2p(tracker.get_value()),
color=YELLOW, radius=0.14))
readout = always_redraw(lambda: Text(
"x = " + str(round(line.p2n(line.n2p(tracker.get_value())), 1)),
font="STLiti", font_size=27, color=WHITE
).next_to(dot, UP, buff=0.35))
self.play(FadeIn(title), run_time=0.6)
self.play(FadeIn(line), run_time=0.6)
self.add(dot, readout)
self.wait(0.6)
self.play(tracker.animate.set_value(4), run_time=3.0)
note = Text("n2p 把数值换成屏幕坐标,p2n 再换回数值;两者互逆",
font="STLiti", font_size=20, color=GREY).to_edge(DOWN)
self.play(FadeIn(note), run_time=0.6)
self.wait(2.2)

下载 Python 脚本

4. 附件

本文 4 个脚本可直接运行(Manim CE 0.21.0),例如 manim -qh --disable_caching -a 20241016120549000.py;四个脚本分别对应 3.1~3.4 的视频,中文一律用 Text(font="STLiti"),否则会显示成豆腐块。