数轴是数学中的一个基本概念,它规定了原点、正方向和单位长度的直线。
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个部分(数轴的线,刻度和数值)的设置。

比如,参数名称中含有 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"),否则会显示成豆腐块。
主观感受,仅供参考。本文采用 本文采用 CC BY-NC-SA 4.0 许可 协议,
完整转载请注明来自
数学动画引擎。