数轴

合格名称：manim.mobject.graphing.number\_line.NumberLine

Python
class NumberLine(x_range=None, length=None, unit_size=1, include_ticks=True, tick_size=0.1, numbers_with_elongated_ticks=None, longer_tick_multiple=2, exclude_origin_tick=False, rotation=0, stroke_width=2.0, include_tip=False, tip_width=0.35, tip_height=0.35, tip_shape=None, include_numbers=False, font_size=36, label_direction=array([ 0., -1., 0.]), label_constructor=<class 'manim.mobject.text.tex_mobject.MathTex'>, scaling=<manim.mobject.graphing.scale.LinearBase object>, line_to_number_buff=0.25, decimal_number_config=None, numbers_to_exclude=None, numbers_to_include=None, **kwargs)

Bases: Line

创建带有刻度线的数轴。

参数

x_range ( Sequence [ float ] | None ) –用于创建线条的值。[x_min, x_max, x_step]
length ( float | None ) – 数轴的长度。
unit_size ( float ) – 线条的每个刻度之间的距离。如果指定，则被覆盖length。
include_ticks ( bool ) – 是否在数轴上包含刻度。
tick_size ( float ) – 每个刻度线的长度。
Numbers_with_elongated_ticks ( Iterable [ float ] | None ) – 具有拉长刻度的特定值的可迭代。
long_tick_multiple ( int ) – 影响细长刻度比常规刻度大多少倍 (2 = 2x)。
rotation( float ) – 线旋转的角度（以弧度为单位）。
stroke_width ( float ) – 线条的粗细。
include_tip ( bool ) – 是否在行尾添加提示。
tip_width ( float ) – 尖端的宽度。
tip_height ( float ) – 尖端的高度。
tip_shape ( type [ ArrowTip ] | None ) – 用于构造提示的 mobject 类，或者None（默认）用于默认箭头提示。传递的类必须继承自ArrowTip.
include_numbers ( bool ) – 是否向刻度线添加数字。小数位数由步长决定，可以通过覆盖此默认值decimal_number_config。
scaling( _ScaleBasex_range ) –值缩放的方式，即LogBase对于对数数轴。默认为LinearBase.
font_size ( float ) – 标签 mobject 的大小。默认为 36。
label_direction ( Sequence [ float ] ) – 在线上添加标签 mobject 的具体位置。
label_constructor ( VMobject ) – 确定将用于构造数轴标签的 mobject 类。
line_to_number_buff ( float ) – 线条和标签 mobject 之间的距离。
decimal_number_config ( dict | None ) – 可以传递DecimalNumber以影响数字 mobject 的参数。
Numbers_to_exclude ( Iterable [ float ] | None ) – 不添加到数轴的数字的显式迭代。
Numbers_to_include ( Iterable [ float ] | None ) – 要添加到数轴的数字的显式迭代
kwargs – 要传递给的附加参数Line。
except_origin_tick (bool) –

提示：包含负值和正值的数字范围将从 0 点生成，并且可能不包含最小/最大值处的刻度，因为刻度位置取决于步长。

例子

示例：NumberLine 示例

Python
from manim import *

class NumberLineExample(Scene):
    def construct(self):
        l0 = NumberLine(
            x_range=[-10, 10, 2],
            length=10,
            color=BLUE,
            include_numbers=True,
            label_direction=UP,
        )

        l1 = NumberLine(
            x_range=[-10, 10, 2],
            unit_size=0.5,
            numbers_with_elongated_ticks=[-2, 4],
            include_numbers=True,
            font_size=24,
        )
        num6 = l1.numbers[8]
        num6.set_color(RED)

        l2 = NumberLine(
            x_range=[-2.5, 2.5 + 0.5, 0.5],
            length=12,
            decimal_number_config={"num_decimal_places": 2},
            include_numbers=True,
        )

        l3 = NumberLine(
            x_range=[-5, 5 + 1, 1],
            length=6,
            include_tip=True,
            include_numbers=True,
            rotation=10 * DEGREES,
        )

        line_group = VGroup(l0, l1, l2, l3).arrange(DOWN, buff=1)
        self.add(line_group)

方法


`add_labels`	`NumberLine`使用向中添加专门定位的标签`dict`。
`add_numbers`	添加`DecimalNumber`代表其在数轴每个刻度处位置的 mobject。
`add_ticks`	在数轴上添加刻度。
`get_labels`
`get_number_mobject`	生成`DecimalNumber`根据生成的定位 mobject `label_constructor`。
`get_number_mobjects`
`get_tick`	生成一个刻度并将其沿数轴定位。
`get_tick_marks`
`get_tick_range`	`x_range`根据数轴的属性生成在其上绘制标签的值范围。
`get_unit_size`
`get_unit_vector`
`n2p`
`number_to_point`	接受沿数轴的值并返回相对于场景的点。
`p2n`	`point_to_number()`的缩写。
`point_to_number`	接受相对于场景的点并返回沿数轴的浮点数。
`rotate_about_number`
`rotate_about_zero`

属性

_create_label_tex(label_tex, label_constructor=None, **kwargs)

检查标签是否为 a ，否则，通过传递toVMobject创建标签。label_texlabel_constructor

参数： - label_tex (str | float | manim.mobject.types.vectorized_mobject.VMobject) – 应为其创建 mobject 的标签。如果标签已经是一个 mobject，则不会创建新的 mobject。 - label_constructor (Optional[Callable]) – 可选。label_tex作为参数传递时返回 mobject 的类或函数。如果None传递（默认），则label_constructor 使用属性中的标签构造函数。

返回： The label.

返回类型： VMobject

Python
_original__init__(x_range=None, length=None, unit_size=1, include_ticks=True, tick_size=0.1, numbers_with_elongated_ticks=None, longer_tick_multiple=2, exclude_origin_tick=False, rotation=0, stroke_width=2.0, include_tip=False, tip_width=0.35, tip_height=0.35, tip_shape=None, include_numbers=False, font_size=36, label_direction=array([ 0., -1., 0.]), label_constructor=<class 'manim.mobject.text.tex_mobject.MathTex'>, scaling=<manim.mobject.graphing.scale.LinearBase object>, line_to_number_buff=0.25, decimal_number_config=None, numbers_to_exclude=None, numbers_to_include=None, **kwargs)

初始化自身。请参阅 help(type(self)) 以获取准确的签名。

参数： x_range (Sequence[float] | None) – length (float | None) – unit_size (float) – include_ticks (bool) – tick_size (float) – numbers_with_elongated_ticks (Iterable[float] | None) – longer_tick_multiple (int) – exclude_origin_tick (bool) – rotation (float) – stroke_width (float) – include_tip (bool) – tip_width (float) – tip_height (float) – tip_shape (type[ArrowTip] | None) – include_numbers (bool) – font_size (float) – label_direction (Sequence[float]) – label_constructor (VMobject) – scaling (_ScaleBase) – line_to_number_buff (float) – decimal_number_config (dict | None) – numbers_to_exclude (Iterable[float] | None) – numbers_to_include (Iterable[float] | None) –

Python
add_labels(dict_values, direction=None, buff=None, font_size=None, label_constructor=None)

NumberLine使用向中添加专门定位的标签dict。创建后可以通过访问标签self.labels。

参数

dict_values ( dict [ float , str | float | VMobject ] ) – 一个字典，由数轴上的位置和要添加的 mobject 组成：。如果值不是 mobject (或)，则将用于构造标签。{1: Tex("Monday"), 3: Tex("Tuesday")}``label_constructor``str``float
Direction ( Sequence [ float ] ) – 确定标签位于线条旁边的方向。
buff ( float | None ) – 标签与线条的距离。
font_size ( float | None ) – 要定位的 mobject 的字体大小。
label_constructor ( VMobject | None ) –VMobject将用于构造标签的类。如果未指定，则默认label_constructor为数轴的属性。

额外 AttributeError – 如果标签没有属性font_size，AttributeError则会引发错误。

Python
add_numbers(x_values=None, excluding=None, font_size=None, label_constructor=None, **kwargs)

添加DecimalNumber代表其在数轴每个刻度处位置的 mobject。创建后可以通过访问这些号码self.numbers。

参数

x_values ( Iterable [ float ] | None ) – 用于定位和创建标签的值的可迭代。默认为由产生的输出get_tick_range()
excluding( Iterable [ float ] | None ) – 要排除的值的列表x_values。
font_size ( float | None ) – 标签的字体大小。默认font_size为数轴的属性。
label_constructor ( VMobject | None ) –VMobject将用于构造标签的类。如果未指定，则默认label_constructor为数轴的属性。

add_ticks()

在数轴上添加刻度。创建后可以通过访问蜱虫self.ticks。

Python
get_number_mobject(x, direction=None, buff=None, font_size=None, label_constructor=None, **number_config)

生成DecimalNumber根据生成的定位 mobject label_constructor。

参数

x ( float ) – mobject 应定位的 x 值。
Direction ( Sequence [ float ] | None ) – 确定标签位于线条旁边的方向。
buff ( float | None ) – 标签与线条的距离。
font_size ( float | None ) – 标签 mobject 的字体大小。
label_constructor ( VMobject | None ) –VMobject将用于构造标签的类。如果未指定，则默认label_constructor为数轴的属性。

返回

定位的对象。

返回类型

DecimalNumber

get_tick(x, size=None)

生成一个刻度并将其沿数轴定位。

参数

x ( float ) – 刻度线的位置。
size ( float | None ) – 刻度缩放的因子。

返回

定位的刻度线。

返回类型

Line

get_tick_range()

x_range根据数轴的属性生成在其上绘制标签的值范围。

返回

代表数轴上的值的 numpy 浮点数组。

返回类型

np.ndarray

n2p(number)

的缩写number_to_point()。

参数

number( float | np.ndarray ) –

返回类型

np.ndarray

number_to_point(number)

接受沿数轴的值并返回相对于场景的点。

参数

number ( float | np.ndarray ) – 要转换为坐标的值。或者值列表。

返回

相对于场景坐标系的点。或者点列表。

返回类型

np.ndarray

例子

Python
from manim import NumberLine
number_line = NumberLine()
number_line.number_to_point(0)
array([0., 0., 0.])
number_line.number_to_point(1)
array([1., 0., 0.])
number_line.number_to_point([1,2,3])
array([[1., 0., 0.],
       [2., 0., 0.],
       [3., 0., 0.]])

p2n(point)

point_to_number()的缩写。

参数

point(Sequence[float]) –

返回类型

float

point_to_number(point)

接受相对于场景的点并返回沿数轴的浮点数。

参数

point (Sequence[float]) – 由组成的值序列。(x_coord, y_coord, z_coord)

返回

表示沿数轴的值的浮点数。

返回类型

float

例子

Python
from manim import NumberLine
number_line = NumberLine()
number_line.point_to_number((0,0,0))
0.0
number_line.point_to_number((1,0,0))
1.0
number_line.point_to_number([[0.5,0,0],[1,0,0],[1.5,0,0]])
array([0.5, 1. , 1.5])