Skip to content

armgit / manim

Public Imported from GitHub
0

A community-maintained Python framework for creating mathematical animations.

Merge master into extend_subcmds

Aathish1576a4f4d3ca
diff --git a/.gitignore b/.gitignore
index 1325f8a6d..364e29921 100644
--- a/.gitignore
+++ b/.gitignore
@@ -55,6 +55,7 @@ coverage.xml
# Sphinx documentation
docs/_build/
+docs/build/
# PyBuilder
target/
diff --git a/README.md b/README.md
index 2917c0d43..1f2ac2e3b 100644
--- a/README.md
+++ b/README.md
@@ -207,10 +207,10 @@ If you have installed MacTeX and are comfortable with it, do not install BasicTe
### Installing Manim-Community itself
-Manim runs on Python 3.7+. If you'd like to just use the library, you can install it from PyPI via pip:
+Manim-Community runs on Python 3.6+. If you'd like to just use the library, you can install it from PyPI via pip:
```sh
-pip3 install manimlib
+pip3 install manimce
```
However, if you'd like to contribute to and/or help develop
diff --git a/docs/Makefile b/docs/Makefile
index 69fe55ecf..d0c3cbf10 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -1,9 +1,10 @@
# Minimal makefile for Sphinx documentation
#
-# You can set these variables from the command line.
-SPHINXOPTS =
-SPHINXBUILD = sphinx-build
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS ?=
+SPHINXBUILD ?= sphinx-build
SOURCEDIR = source
BUILDDIR = build
@@ -16,4 +17,4 @@ help:
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
- @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
\ No newline at end of file
+ @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
diff --git a/docs/make.bat b/docs/make.bat
index 543c6b13b..6247f7e23 100644
--- a/docs/make.bat
+++ b/docs/make.bat
@@ -25,11 +25,11 @@ if errorlevel 9009 (
exit /b 1
)
-%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
goto end
:help
-%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
:end
popd
diff --git a/docs/source/_static/quickstart/first_scene.gif b/docs/source/_static/quickstart/first_scene.gif
new file mode 100644
index 000000000..c23d42b29
Binary files /dev/null and b/docs/source/_static/quickstart/first_scene.gif differ
diff --git a/docs/source/_static/quickstart/first_scene_4k.gif b/docs/source/_static/quickstart/first_scene_4k.gif
new file mode 100644
index 000000000..4bde21aef
Binary files /dev/null and b/docs/source/_static/quickstart/first_scene_4k.gif differ
diff --git a/docs/source/_static/quickstart/second_scene.gif b/docs/source/_static/quickstart/second_scene.gif
new file mode 100644
index 000000000..abefa7e3e
Binary files /dev/null and b/docs/source/_static/quickstart/second_scene.gif differ
diff --git a/docs/source/about.rst b/docs/source/about.rst
deleted file mode 100644
index 2a86dfd9b..000000000
--- a/docs/source/about.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-About
-=====
-
-Animating technical concepts is traditionally pretty tedious, since it can be
-difficult to make the animations precise enough to convey them accurately.
-``Manim`` uses Python to generate animations programmatically, which makes it
-possible to specify exactly how each one should run.
-
-This project is still very much a work in progress, but I hope that the
-information here will make it easier for newcomers to get started using
-``Manim``.
diff --git a/docs/source/animation.rst b/docs/source/animation.rst
deleted file mode 100644
index e38db6333..000000000
--- a/docs/source/animation.rst
+++ /dev/null
@@ -1,210 +0,0 @@
-Animation
-=========
-
-
-
-The simplest of which is ``Scene.add``. The object appears on the first frame
-without any animation::
-
- class NoAnimation(Scene):
- def construct(self):
- square = Square()
- self.add(square))
-
-Animation are used in conjunction with ``scene.Play``
-
-Fade
-----
-
-.. raw:: html
-
- <video width="560" height="315" controls>
- <source src="_static/AnimationFadeIn.mp4" type="video/mp4">
- </video>
-
-.. code-block:: python
-
- class AnimationFadeIn(Scene):
- def construct(self):
- square = Square()
-
- anno = TextMobject("Fade In")
- anno.shift(2 * DOWN)
- self.add(anno)
- self.play(FadeIn(square))
-
-.. raw:: html
-
- <video width="560" height="315" controls>
- <source src="_static/AnimationFadeOut.mp4" type="video/mp4">
- </video>
-
-.. code-block:: python
-
- class AnimationFadeOut(Scene):
- def construct(self):
- square = Square()
-
- anno = TextMobject("Fade Out")
- anno.shift(2 * DOWN)
- self.add(anno)
- self.add(square)
- self.play(FadeOut(square))
-
-
-
-.. raw:: html
-
- <video width="560" height="315" controls>
- <source src="_static/AnimationFadeInFrom.mp4" type="video/mp4">
- </video>
-
-.. code-block:: python
-
- class AnimationFadeInFrom(Scene):
- def construct(self):
- square = Square()
- for label, edge in zip(
- ["LEFT", "RIGHT", "UP", "DOWN"], [LEFT, RIGHT, UP, DOWN]
- ):
- anno = TextMobject(f"Fade In from {label}")
- anno.shift(2 * DOWN)
- self.add(anno)
-
- self.play(FadeInFrom(square, edge))
- self.remove(anno, square)
-
-
-
-.. raw:: html
-
- <video width="560" height="315" controls>
- <source src="_static/AnimationFadeOutAndShift.mp4" type="video/mp4">
- </video>
-
-.. code-block:: python
-
- class AnimationFadeOutAndShift(Scene):
- def construct(self):
- square = Square()
- for label, edge in zip(
- ["LEFT", "RIGHT", "UP", "DOWN"], [LEFT, RIGHT, UP, DOWN]
- ):
- anno = TextMobject(f"Fade Out and shift {label}")
- anno.shift(2 * DOWN)
- self.add(anno)
-
- self.play(FadeOutAndShift(square, edge))
- self.remove(anno, square)
-
-
-
-.. raw:: html
-
- <video width="560" height="315" controls>
- <source src="_static/AnimationFadeInFromLarge.mp4" type="video/mp4">
- </video>
-
-.. code-block:: python
-
- class AnimationFadeInFromLarge(Scene):
- def construct(self):
- square = Square()
-
- for factor in [0.1, 0.5, 0.8, 1, 2, 5]:
- anno = TextMobject(f"Fade In from large scale\_factor={factor}")
- anno.shift(2 * DOWN)
- self.add(anno)
-
- self.play(FadeInFromLarge(square, scale_factor=factor))
- self.remove(anno, square)
-
-.. raw:: html
-
- <video width="560" height="315" controls>
- <source src="_static/AnimationFadeInFromPoint.mp4" type="video/mp4">
- </video>
-
-.. code-block:: python
-
- class AnimationFadeInFromPoint(Scene):
- def construct(self):
- square = Square()
- for i in range(-6, 7, 2):
- anno = TextMobject(f"Fade In from point {i}")
- anno.shift(2 * DOWN)
- self.add(anno)
- self.play(FadeInFromPoint(square, point=i))
- self.remove(anno, square)
-
-
-
-Grow
-----
-
-.. raw:: html
-
- <video width="560" height="315" controls>
- <source src="_static/AnimationGrowFromEdge.mp4" type="video/mp4">
- </video>
-
-.. code-block:: python
-
- class AnimationGrowFromEdge(Scene):
- def construct(self):
-
- for label, edge in zip(
- ["LEFT", "RIGHT", "UP", "DOWN"], [LEFT, RIGHT, UP, DOWN]
- ):
- anno = TextMobject(f"Grow from {label} edge")
- anno.shift(2 * DOWN)
- self.add(anno)
- square = Square()
- self.play(GrowFromEdge(square, edge))
- self.remove(anno, square)
-
-
-
-.. raw:: html
-
- <video width="560" height="315" controls>
- <source src="_static/AnimationGrowFromCenter.mp4" type="video/mp4">
- </video>
-
-.. code-block:: python
-
- class AnimationGrowFromCenter(Scene):
- def construct(self):
- square = Square()
-
- anno = TextMobject("Grow from center")
- anno.shift(2 * DOWN)
- self.add(anno)
-
- self.play(GrowFromCenter(square))
-
-
-
-
-Diagonal Directions
--------------------
-
-You can combine cardinal directions to form diagonal animations
-
-.. raw:: html
-
- <video width="560" height="315" controls>
- <source src="_static/AnimationFadeInFromDiagonal.mp4" type="video/mp4">
- </video>
-
-.. code-block:: python
-
- class AnimationFadeInFromDiagonal(Scene):
- def construct(self):
- square = Square()
- for diag in [UP + LEFT, UP + RIGHT, DOWN + LEFT, DOWN + RIGHT]:
- self.play(FadeInFrom(square, diag))
-
-.. note::
- You can also use the abbreviated forms like ``UL, UR, DL, DR``.
- See :ref:`ref-directions`.
diff --git a/docs/source/assets/AnimationFadeIn.mp4 b/docs/source/assets/AnimationFadeIn.mp4
deleted file mode 100644
index 783a6fa89..000000000
Binary files a/docs/source/assets/AnimationFadeIn.mp4 and /dev/null differ
diff --git a/docs/source/assets/AnimationFadeInFrom.mp4 b/docs/source/assets/AnimationFadeInFrom.mp4
deleted file mode 100644
index 90ead0726..000000000
Binary files a/docs/source/assets/AnimationFadeInFrom.mp4 and /dev/null differ
diff --git a/docs/source/assets/AnimationFadeInFromDiagonal.mp4 b/docs/source/assets/AnimationFadeInFromDiagonal.mp4
deleted file mode 100644
index 25b0145c4..000000000
Binary files a/docs/source/assets/AnimationFadeInFromDiagonal.mp4 and /dev/null differ
diff --git a/docs/source/assets/AnimationFadeInFromLarge.mp4 b/docs/source/assets/AnimationFadeInFromLarge.mp4
deleted file mode 100644
index 589789ea4..000000000
Binary files a/docs/source/assets/AnimationFadeInFromLarge.mp4 and /dev/null differ
diff --git a/docs/source/assets/AnimationFadeInFromPoint.mp4 b/docs/source/assets/AnimationFadeInFromPoint.mp4
deleted file mode 100644
index cdfdc84cc..000000000
Binary files a/docs/source/assets/AnimationFadeInFromPoint.mp4 and /dev/null differ
diff --git a/docs/source/assets/AnimationFadeInFromSmall.mp4 b/docs/source/assets/AnimationFadeInFromSmall.mp4
deleted file mode 100644
index 9e8f80974..000000000
Binary files a/docs/source/assets/AnimationFadeInFromSmall.mp4 and /dev/null differ
diff --git a/docs/source/assets/AnimationFadeOut.mp4 b/docs/source/assets/AnimationFadeOut.mp4
deleted file mode 100644
index 5938ab7e7..000000000
Binary files a/docs/source/assets/AnimationFadeOut.mp4 and /dev/null differ
diff --git a/docs/source/assets/AnimationFadeOutAndShift.mp4 b/docs/source/assets/AnimationFadeOutAndShift.mp4
deleted file mode 100644
index 834145cb4..000000000
Binary files a/docs/source/assets/AnimationFadeOutAndShift.mp4 and /dev/null differ
diff --git a/docs/source/assets/AnimationGrowFromCenter.mp4 b/docs/source/assets/AnimationGrowFromCenter.mp4
deleted file mode 100644
index 634863bb7..000000000
Binary files a/docs/source/assets/AnimationGrowFromCenter.mp4 and /dev/null differ
diff --git a/docs/source/assets/AnimationGrowFromEdge.mp4 b/docs/source/assets/AnimationGrowFromEdge.mp4
deleted file mode 100644
index 7da5f313d..000000000
Binary files a/docs/source/assets/AnimationGrowFromEdge.mp4 and /dev/null differ
diff --git a/docs/source/assets/SquareToCircle.mp4 b/docs/source/assets/SquareToCircle.mp4
deleted file mode 100644
index 5b1e9b902..000000000
Binary files a/docs/source/assets/SquareToCircle.mp4 and /dev/null differ
diff --git a/docs/source/assets/coordinate/CoorAlias.mp4 b/docs/source/assets/coordinate/CoorAlias.mp4
deleted file mode 100644
index 3df8e0fdc..000000000
Binary files a/docs/source/assets/coordinate/CoorAlias.mp4 and /dev/null differ
diff --git a/docs/source/assets/coordinate/CoorArithmetic.mp4 b/docs/source/assets/coordinate/CoorArithmetic.mp4
deleted file mode 100644
index cea6c0877..000000000
Binary files a/docs/source/assets/coordinate/CoorArithmetic.mp4 and /dev/null differ
diff --git a/docs/source/assets/coordinate/CoorPolygon.png b/docs/source/assets/coordinate/CoorPolygon.png
deleted file mode 100644
index 5c9793fae..000000000
Binary files a/docs/source/assets/coordinate/CoorPolygon.png and /dev/null differ
diff --git a/docs/source/assets/coordinate/DotMap.mp4 b/docs/source/assets/coordinate/DotMap.mp4
deleted file mode 100644
index 6e7d0c3d0..000000000
Binary files a/docs/source/assets/coordinate/DotMap.mp4 and /dev/null differ
diff --git a/docs/source/changelog.rst b/docs/source/changelog.rst
new file mode 100644
index 000000000..e35dcd8ef
--- /dev/null
+++ b/docs/source/changelog.rst
@@ -0,0 +1,4 @@
+Changelog
+=========
+
+This is a stub file.
diff --git a/docs/source/conf.py b/docs/source/conf.py
index ec8e26948..25d20277a 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -2,7 +2,7 @@
#
# This file only contains a selection of the most common options. For a full
# list see the documentation:
-# http://www.sphinx-doc.org/en/master/config
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
# -- Path setup --------------------------------------------------------------
@@ -17,21 +17,24 @@
# -- Project information -----------------------------------------------------
-project = "Manim"
-copyright = "2019, EulerTour"
-author = "EulerTour"
+project = 'manim'
+copyright = '2020, The Manim Community Dev Team'
+author = 'The Manim Community Dev Team'
# -- General configuration ---------------------------------------------------
-master_doc = "index"
# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
-extensions = []
+extensions = [
+ 'sphinx.ext.autodoc',
+ 'sphinx_rtd_theme',
+ 'recommonmark',
+]
# Add any paths that contain templates here, relative to this directory.
-templates_path = ["_templates"]
+templates_path = ['_templates']
# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
@@ -44,9 +47,9 @@ exclude_patterns = []
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
#
-html_theme = "sphinx_rtd_theme"
+html_theme = 'sphinx_rtd_theme'
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ["assets"]
+html_static_path = ['_static']
diff --git a/docs/source/config.rst b/docs/source/config.rst
new file mode 100644
index 000000000..0e6cb75a6
--- /dev/null
+++ b/docs/source/config.rst
@@ -0,0 +1,4 @@
+.. automodule:: manim.config
+ :members:
+ :undoc-members:
+ :show-inheritance:
diff --git a/docs/source/configuration.rst b/docs/source/configuration.rst
new file mode 100644
index 000000000..1514c4260
--- /dev/null
+++ b/docs/source/configuration.rst
@@ -0,0 +1,4 @@
+Configuration
+=============
+
+This is a stub file.
diff --git a/docs/source/constants.rst b/docs/source/constants.rst
index 7bc34d147..b0fb2c6e8 100644
--- a/docs/source/constants.rst
+++ b/docs/source/constants.rst
@@ -1,94 +1,7 @@
-Manim Constants
-===============
+Constants
+=========
-The ``constants.py`` under ``manimlib/`` contains variables that are used
-during setup and running manim. Some variables are not documented here as they are
-only used internally by manim.
-
-Directories
------------
-
- MEDIA_DIR
- The directory where ``VIDEO_DIR`` and ``TEX_DIR`` will be created,
- if they aren't specified via flags.
- VIDEO_DIR
- Used to store the scenes rendered by Manim. When a scene is
- finished rendering, it will be stored under
- ``VIDEO_DIR/module_name/scene_name/quality/scene_name.mp4``.
- Created under ``MEDIA_DIR`` by default.
- TEX_DIR
- Files written by Latex are stored here. It also acts as a cache
- so that the files aren't rewritten each time Latex is needed.
-
-Those directories are created if they don't exist.
-
-Tex
----
- TEX_USE_CTEX
- A boolean value. Change it to True if you need to use Chinese typesetting.
- TEX_TEXT_TO_REPLACE
- Placeholder text used by manim when generating tex files
- TEMPLATE_TEX_FILE
- By default ``manimlib/tex_template.tex`` is used. If ``TEX_USE_CTEX``
- is set to True then ``manimlib/ctex_template.tex`` is used.
-
-Numerical Constants
--------------------
-
- PI
- alias to ``numpy.pi``
- TAU
- PI * 2
-
- DEGREES
- TAU / 360
-
-Camera Configuration
---------------------
-
-Render setting presets
-
- PRODUCTION_QUALITY_CAMERA_CONFIG
- 2560x1440 @ 60fps # This is the default when rendering a scene
- HIGH_QUALITY_CAMERA_CONFIG
- 1920x1080 @ 60fps. # Used when the ``-h`` or ``--high_quality`` flag
- is passed.
- MEDIUM_QUALITY_CAMERA_CONFIG
- 1280x720 @ 30fps. # Used when the ``-m`` or ``--medium_quality``
- flag is passed.
- LOW_QUALITY_CAMERA_CONFIG
- 854x480 @ 15fps. # Used when the ``-l`` or ``--low_quality`` flag is
- passed.
-
-.. _ref-directions:
-
-Coordinates
------------
-
-Used for 2d/3d animations and placements::
-
- ORIGIN
- UP
- DOWN
- RIGHT
- LEFT
- IN # 3d camera only, away from camera
- OUT # 3d camera only, close to camera
-
- UL = UP + LEFT # diagonal abbreviations. You can use either one
- UR = UP + RIGHT
- DL = DOWN + LEFT
- DR = DOWN + RIGHT
-
- TOP
- BOTTOM
- LEFT_SIDE
- RIGHT_SIDE``
-
-Colors
-------
-
- COLOR_MAP
- A predefined color maps
- PALETTE
- A list of color hex strings, derived from COLOR_MAP
+.. automodule:: manim.constants
+ :members:
+ :undoc-members:
+ :show-inheritance:
diff --git a/docs/source/coordinate.rst b/docs/source/coordinate.rst
deleted file mode 100644
index 27edb2566..000000000
--- a/docs/source/coordinate.rst
+++ /dev/null
@@ -1,178 +0,0 @@
-Coordinate
-==========
-
-By default, the scene in manim is made up by 8 x 14 grid. The grid is addressed using a numpy
-array in the form of [x, y, z]. For 2D animations only the x and y axes are used.
-
-.. code-block:: python
-
- class DotMap(Scene):
- def construct(self):
- dots = dict()
- annos = dict()
- var_index = 0
- for x in range(-7, 8):
- for y in range(-4, 5):
- annos[f"{x}{y}"] = TexMobject(f"({x}, {y})")
- dots[f"{var_index}"] = Dot(np.array([x, y, 0]))
- var_index = var_index + 1
- for anno, dot in zip(annos.values(), dots.values()):
- self.add(anno)
- self.add(dot)
- self.wait(0.2)
- self.remove(anno)
-
-.. raw:: html
-
- <video width="700" height="394" controls>
- <source src="_static/coordinate/DotMap.mp4" type="video/mp4">
- </video>
-
-.. note::
- You can place objects outside this boundary, but it won't show up in the render.
-
-Using Coordinates
------------------
-
-Coordinates are used for creating geometries (`VMobject` in manim) and animations.
-
-Here coordinates are used to create this Polygon
-
-.. code-block:: python
-
- class CoorPolygon(Scene):
- def construct(self):
- for x in range(-7, 8):
- for y in range(-4, 5):
- self.add(Dot(np.array([x, y, 0]), color=DARK_GREY))
- polygon = Polygon(
- np.array([3, 2, 0]),
- np.array([1, -1, 0]),
- np.array([-5, -4, 0]),
- np.array([-4, 4, 0]))
- self.add(polygon)
-
-
-.. Image:: assets/coordinate/CoorPolygon.png
- :width: 700px
-
-Coordinate Aliasing
--------------------
-
-From some animations typing a ``np.array`` everytime you need a coordinate can be tedious.
-Manim provides aliases to the most common coordinates::
-
- UP == np.array([0, 1, 0])
- DOWN == np.array([0, -1, 0])
- LEFT == np.array([-1, 0, 0])
- RIGHT == np.array([1, 0, 0])
- UL == np.array([-1, 1, 0])
- DL == np.array([-1, -1, 0])
- UR == np.array([1, 1, 0])
- DR == np.array([1, -1, 0])
-
-Here coordinates are used for animations
-
-.. code-block:: python
-
- class CoorAlias(Scene):
- def construct(self):
- for x in range(-7, 8):
- for y in range(-4, 5):
- self.add(Dot(np.array([x, y, 0]), color=DARK_GREY))
-
- aliases = {
- "UP": UP,
- "np.array([0,1,0])": np.array([0, 1, 0]),
- "DOWN": DOWN,
- "np.array([0,-1,0])": np.array([0, -1, 0]),
- "LEFT": LEFT,
- "np.array([-1,0,0])": np.array([-1, 0, 0]),
- "RIGHT": RIGHT,
- "np.array([1,0,0])": np.array([1, 0, 0]),
- "UL": UL,
- "np.array([-1,1,0])": np.array([-1, 1, 0]),
- "DL": DL,
- "np.array([-1,-1,0])": np.array([-1, -1, 0]),
- "UR": UR,
- "np.array([1,1,0])": np.array([1, 1, 0]),
- "DR": DR,
- "np.array([1,-1,0])": np.array([1, -1, 0])}
- circle = Circle(color=RED, radius=0.5)
- self.add(circle)
- self.wait(0.5)
-
- for text, aliase in aliases.items():
- anno = TexMobject(f"\\texttt{{{text}}}")
- self.play(Write(anno, run_time=0.2))
- self.play(ApplyMethod(circle.shift, aliase))
- self.wait(0.2)
- self.play(FadeOut(anno, run_time=0.2))
-
-.. raw:: html
-
- <video width="700" height="394" controls>
- <source src="_static/coordinate/CoorAlias.mp4" type="video/mp4">
- </video>
-
-Coordinate Arithmetic
----------------------
-
-Numpy array allows arithmetic operations::
-
- >>> numpy.array([2,2,0]) + 4
- array([6, 6, 4])
-
- >>> np.array([1, -3, 0]) + np.array([-4, 2, 0])
- array([-3, -1, 0])
-
- >>> np.array([2, 2, 0]) - np.array([3,6, 0])
- array([-1, -4, 0])
-
- >>> numpy.array([2,2,0]) - 3
- array([-1, -1, -3])
-
- >>> np.array([1, -3, 0]) * 3
- array([ 3, -9, 0])
-
- >>> numpy.array([2,2,0]) / 2
- array([1., 1., 0.])
-
- >>> numpy.array([2,2,0]) / numpy.array([1, 4, 0])
- __main__:1: RuntimeWarning: invalid value encountered in true_divide
- array([2. , 0.5, nan])
-
-.. code-block:: python
-
- class CoorArithmetic(Scene):
- def construct(self):
- for x in range(-7, 8):
- for y in range(-4, 5):
- self.add(Dot(np.array([x, y, 0]), color=DARK_GREY))
-
- circle = Circle(color=RED, radius=0.5)
- self.add(circle)
- self.wait(0.5)
-
- aliases = {
- "LEFT * 3": LEFT * 3,
- "UP + RIGHT / 2": UP + RIGHT / 2,
- "DOWN + LEFT * 2": DOWN + LEFT * 2,
- "RIGHT * 3.75 * DOWN": RIGHT * 3.75 * DOWN,
- # certain arithmetic won't work as you expected
- # In [4]: RIGHT * 3.75 * DOWN
- # Out[4]: array([ 0., -0., 0.])
- "RIGHT * 3.75 + DOWN": RIGHT * 3.75 + DOWN}
-
- for text, aliase in aliases.items():
- anno = TexMobject(f"\\texttt{{{text}}}")
- self.play(Write(anno, run_time=0.2))
- self.play(ApplyMethod(circle.shift, aliase))
- self.wait(0.2)
- self.play(FadeOut(anno, run_time=0.2))
-
-.. raw:: html
-
- <video width="700" height="394" controls>
- <source src="_static/coordinate/CoorArithmetic.mp4" type="video/mp4">
- </video>
diff --git a/docs/source/getting_started/animating_mobjects.rst b/docs/source/getting_started/animating_mobjects.rst
deleted file mode 100644
index efc0a1098..000000000
--- a/docs/source/getting_started/animating_mobjects.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-Animating Mobjects
-==================
-
-Learn about animations.
diff --git a/docs/source/getting_started/index.rst b/docs/source/getting_started/index.rst
deleted file mode 100644
index 11f8e9d0b..000000000
--- a/docs/source/getting_started/index.rst
+++ /dev/null
@@ -1,18 +0,0 @@
-Getting Started
-===============
-
-Todd Zimmerman put together `a very nice tutorial`_ on getting started with
-``manim``, which has been updated to run on python 3.7. Note that you'll want
-to change `from big_ol_pile_of_manim_imports import *` to `from
-manimlib.imports import *` to work with the current codebase.
-
-.. _a very nice tutorial: https://talkingphysics.wordpress.com/2019/01/08/getting-started-animating-with-manim-and-python-3-7/
-
-.. toctree::
- :caption: Contents
- :maxdepth: 2
-
- learning_by_example
- mathematical_objects
- animating_mobjects
- making_a_scene
diff --git a/docs/source/getting_started/learning_by_example.rst b/docs/source/getting_started/learning_by_example.rst
deleted file mode 100644
index dee86d7cc..000000000
--- a/docs/source/getting_started/learning_by_example.rst
+++ /dev/null
@@ -1,131 +0,0 @@
-Learning by Example
-===================
-
-SquareToCircle
---------------
-
-``example_scenes.py`` contains simple examples that we can use to learn about manim.
-
-Go ahead and try out the ``SquareToCircle`` scene by running it with ``$ manim example_scenes.py SquareToCircle -p``
-in manim directory.
-
-.. code-block:: python
- :linenos:
-
- from manimlib.imports import *
-
- class SquareToCircle(Scene):
- def construct(self):
- circle = Circle()
- square = Square()
- square.flip(RIGHT)
- square.rotate(-3 * TAU / 8)
- circle.set_fill(PINK, opacity=0.5)
-
- self.play(ShowCreation(square))
- self.play(Transform(square, circle))
- self.play(FadeOut(square))
-
-.. raw:: html
-
- <video width="560" height="315" controls>
- <source src="../_static/SquareToCircle.mp4" type="video/mp4">
- </video>
-
-
-.. note::
-
- The flag ``-p`` plays the rendered video with default video player.
-
- Other frequently used flags are:
-
- * ``-l`` for rendering video in lower resolution (which renders faster)
- * ``-s`` to show the last frame of the video.
-
- Run ``manim -h`` all the available flags (``python -m manim -h`` if you installed it to a venv)
-
-
-Let's step through each line of ``SquareToCircle``
-
-.. code-block:: python
- :lineno-start: 3
-
- class SquareToCircle(Scene):
-
-You create videos in manim by writing :class:`~scene.scene.Scene` classes.
-
-Each :class:`~scene.scene.Scene` in manim is self-contained. That means everything
-you created under this scene does not exist outside the class.
-
-.. code-block:: python
- :lineno-start: 4
-
- def construct(self):
-
-:meth:`~scene.scene.Scene.construct` specifies what is displayed on the screen
-when the :class:`~scene.scene.Scene` is rendered to video.
-
-.. code-block:: python
- :lineno-start: 5
-
- circle = Circle()
- square = Square()
-
-``Circle()`` and ``Square()`` create :class:`~mobject.geometry.Circle` and :class:`~mobject.geometry.Square`.
-
-Both of these are instances of :class:`~mobject.mobject.Mobject` subclasses, the base class for objects in manim. Note
-that instantiating a :class:`~mobject.mobject.Mobject` does not add it to the
-:class:`~scene.scene.Scene`, so you wouldn't see anything if you were to render
-the :class:`~scene.scene.Scene` at this point.
-
-.. code-block:: python
- :lineno-start: 7
-
- square.flip(RIGHT)
- square.rotate(-3 * TAU / 8)
- circle.set_fill(PINK, opacity=0.5)
-
-``flip()`` ``rotate()`` ``set_fill()`` apply various modifications to the mobjects before animating
-them. The call to :meth:`~mobject.mobject.Mobject.flip` flips the
-:class:`~mobject.geometry.Square` across the RIGHT vector. This is equivalent
-to a refection across the x-axis.
-
-The call to :meth:`~mobject.mobject.Mobject.rotate` rotates the
-:class:`~mobject.geometry.Square` 3/8ths of a full rotation counterclockwise.
-
-The call to :meth:`~mobject.mobject.Mobject.set_fill` sets
-the fill color for the :class:`~mobject.geometry.Circle` to pink, and its opacity to 0.5.
-
-.. code-block:: python
- :lineno-start: 11
-
- self.play(ShowCreation(square))
- self.play(Transform(square, circle))
- self.play(FadeOut(square))
-
-To generated animation, :class:`~animation.animation.Animation` classes are used.
-
-Each :class:`~animation.animation.Animation` takes one or more :class:`~mobject.mobject.Mobject` instances as arguments, which it animates
-when passed to :meth:`~scene.scene.Scene.play`. This is how video is typically
-created in manim.
-
-:class:`~mobject.mobject.Mobject` instances are automatically
-added to the :class:`~scene.scene.Scene` when they are animated. You can add a
-:class:`~mobject.mobject.Mobject` to the :class:`~scene.scene.Scene` manually
-by passing it as an argument to :meth:`~scene.scene.Scene.add`.
-
-
-:class:`~animation.creation.ShowCreation` draws a :class:`~mobject.mobject.Mobject` to the screen.
-
-:class:`~animation.transform.Transform` morphs one :class:`~mobject.mobject.Mobject` into another.
-
-:class:`~animation.creation.FadeOut` fades a :class:`~mobject.mobject.Mobject` out of the :class:`~scene.scene.Scene`.
-
-.. note::
-
- Only the first argument to :class:`~animation.transform.Transform` is modified,
- the second is not added to the :class:`~scene.scene.Scene`. :class:`~animation.tranform.Transform`
- only changes the appearance but not the underlying properties.
-
- After the call to ``transform()`` ``square`` is still a :class:`~mobject.geometry.Square` instance
- but with the shape of :class:`~mobject.geometry.Circle`.
diff --git a/docs/source/getting_started/making_a_scene.rst b/docs/source/getting_started/making_a_scene.rst
deleted file mode 100644
index 619cb571d..000000000
--- a/docs/source/getting_started/making_a_scene.rst
+++ /dev/null
@@ -1,15 +0,0 @@
-Making a Scene
-==============
-
-A scene is what renders when manim is executed. Each scene contains mobjects, which can then be animated as
-previously explained. In code, a scene is a class that extends ``Scene`` and implements the ``construct``
-function, like so. Manim will execute this function to render the scene.
-
-.. code-block:: python
- :linenos:
-
- from manimlib.imports import *
-
- class ExampleScene(Scene):
- def construct(self):
- # Add and animate mobjects here
\ No newline at end of file
diff --git a/docs/source/getting_started/mathematical_objects.rst b/docs/source/getting_started/mathematical_objects.rst
deleted file mode 100644
index ebe595b6d..000000000
--- a/docs/source/getting_started/mathematical_objects.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-Mathematical Objects
-====================
-
-Everything that appears on screen in a manim video is a
-:class:`~mobject.mobject.Mobject`, or Mathematical Object. A
-:class:`~mobject.mobject.Mobject`'s appearance is determined by 3
-factors:
-
-* ``m.points``, an Nx3 ``numpy.array`` specifying how to draw ``m``
-* ``m``'s style attributes, such as ``m.color``, ``m.stroke_width``, and
- ``m.fill_opacity``
-* ``m.submobjects``, a list of :class:`~mobject.mobject.Mobject` instances that
- are considered part of ``m``
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 865bd82c7..7fb4115f3 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -1,30 +1,30 @@
-.. Manim documentation master file, created by
- sphinx-quickstart on Mon May 27 14:19:19 2019.
+.. manim documentation master file, created by
+ sphinx-quickstart on Tue Aug 4 13:58:07 2020.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
-Welcome to Manim's documentation!
-=================================
+Manim Community Overview
+========================
-These docs are generated from the master branch of the
-`Manim repo <https://github.com/3b1b/manim>`_. You can contribute by submitting
-a pull request there.
+Animating technical concepts is traditionally pretty tedious, since it can be
+difficult to make the animations precise enough to convey them accurately.
+``Manim`` uses Python to generate animations programmatically, which makes it
+possible to specify exactly how each one should run.
-.. toctree::
- :maxdepth: 2
- :caption: Contents
+This project is still very much a work in progress, but I hope that the
+information here will make it easier for newcomers to get started using
+``Manim``.
- about
- installation/index
- getting_started/index
- coordinate
- animation
- constants
+.. toctree::
+ :maxdepth: 2
+ :caption: Documentation
-Indices and tables
-==================
+ quickstart
+ tutorial
+ configuration
+ reference
+ changelog
* :ref:`genindex`
* :ref:`modindex`
-* :ref:`search`
diff --git a/docs/source/installation/index.rst b/docs/source/installation/index.rst
deleted file mode 100644
index 664d154d8..000000000
--- a/docs/source/installation/index.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-Installation
-============
-
-Instructions on installing Manim
-
-.. toctree::
- :maxdepth: 2
- :caption: Contents
-
- linux
- mac
- windows
diff --git a/docs/source/installation/linux.rst b/docs/source/installation/linux.rst
deleted file mode 100644
index ff11bc3cd..000000000
--- a/docs/source/installation/linux.rst
+++ /dev/null
@@ -1,64 +0,0 @@
-Linux
-=====
-
-Ubuntu
-------
-
-Install system libraries::
-
- # apt install sox ffmpeg libcairo2 libcairo2-dev
-
-Install Latex distribution::
-
- # apt install texlive-full
-
-Install manim via pypi::
-
- # pip3 install manimlib
-
-OR Install manim via the git repository with venv::
-
- $ git clone https://github.com/3b1b/manim
- $ cd manim
- $ python3 -m venv ./
- $ source bin/activate
- $ pip3 install -r requirement.txt
-
-To use manim in virtual environment you need to activate the environment with
-the ``activate`` binary by doing ``source bin/activate``, to exit use the ``deactivate`` command.
-
-.. note:: The git repository is updated first before the one on pypi. The git repository also
- includes project files used to produce 3b1b videos. Some of the old projects might not
- work as due to api changes.
-
-
-.. note:: The required latex packages are dictated by
- ``manimlib/tex_template.tex`` which ``texlive-full`` will satisfy. The download size
- can be quite large. If you wish to install only the packages required to use
- manim, substitude ``texlive-full`` with::
-
- texlive texlive-latex-extra texlive-fonts-extra
- texlive-latex-recommended texlive-science texlive-fonts-extra tipa
-
-Arch Linux
-----------
-Install system libraries::
-
- # pacman -S cairo ffmpeg opencv sox
-
-Install Latex distribution::
-
- # pacman -S texlive-most
-
-OR install python-manimlib_:sup:`AUR` package::
-
- $ git clone https://aur.archlinux.org/python-manimlib.git
- $ cd python-manimlib
- $ makepkg -si
-
-You can use AUR helpers such as yay_:sup:`AUR`::
-
- $ yay -S python-manimlib
-
-.. _python-manimlib: https://aur.archlinux.org/packages/python-manimlib/
-.. _yay: https://aur.archlinux.org/packages/yay/
diff --git a/docs/source/installation/mac.rst b/docs/source/installation/mac.rst
deleted file mode 100644
index 43c7bfdb6..000000000
--- a/docs/source/installation/mac.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-Mac
-===
-
-The simplest way to install the system dependencies on Mac OS X is with Homebrew.
-Mac come preinstalled with python2, but to use manim, python3 is required
-
-1. Install python3 https://docs.python.org/3/using/mac.html
-2. Install Cairo: ``brew install cairo``
-3. Install Sox: ``brew install sox``
-4. Install ffmpeg: ``brew install ffmpeg``
-5. Install latex (MacTeX): ``brew cask install mactex``
-6. Install manimlib ``pip install manimlib`` (or ``pip install --user manimlib`` to just yourself)
diff --git a/docs/source/installation/windows.rst b/docs/source/installation/windows.rst
deleted file mode 100644
index e58d125c7..000000000
--- a/docs/source/installation/windows.rst
+++ /dev/null
@@ -1,60 +0,0 @@
-Windows
-=======
-
-Install System Libraries
-------------------------
-
-Make sure you have *Python 3* for Windows installed first:
-
-https://www.python.org/downloads/windows/
-
-Install ffmpeg:
-
-https://ffmpeg.org/download.html#build-windows
-
-Install sox:
-
-http://sox.sourceforge.net/Main/HomePage
-
-Install a latex distribution. On Windows MikTex is commonly used:
-
-https://miktex.org/howto/install-miktex
-
-Path configuration
-------------------
-
-To invoke commandline without supplying path to the binary
-the PATH environment needs to be configured. Below are template examples, please change
-the path according to your username and specific python version. Assuming all the
-softwares are installed with no alteration to the installation paths::
-
- C:\Users\$username\AppData\local\Programs\Python\Python$version\
- C:\Users\$username\AppData\local\Programs\Python\Python$version\Scripts\
- C:\MikTex\miktex\bin\x64\
- C:\ffmpeg\bin\
-
-The path entries should be separated by semicolon.
-
-Installing python packages and manim
-------------------------------------
-
-Make sure you can start pip using ``pip`` in your commandline. Then do
-``pip install pyreadline`` for the ``readline`` package.
-
-Grab the pycairo wheel binary ``pycairo‑1.18.0‑cp37‑cp37m‑win32.whl`` from https://www.lfd.uci.edu/~gohlke/pythonlibs/#pycairo
-and install it via ``python -m pip install C:\absolute\path\to\the\whl\file``
-
-clone the manim repository if you have git ``git clone https://github.com/3b1b/manim`` or download the zip file from
-the repository page with ``Clone or download`` button and unzip it.
-
-Open the commandline within the manim directory with ``Shift + Right click`` on an empty space in the folder and select ``open command window here``
-
-Install manim python dependencies with ``pip install -r requirements.txt``
-
-Test the installation
----------------------
-
-Type in ``python -m manim -h`` and if nothing went wrong during the installation process you should see the help text.
-
-Use ``python -m manim example_scenes.py SquareToCircle -pl`` to render the example scene and the file should play after rendering. The movie file should be
-in ``media/videos/example_scenes/480p15``
diff --git a/docs/source/mobject.rst b/docs/source/mobject.rst
new file mode 100644
index 000000000..c798c363f
--- /dev/null
+++ b/docs/source/mobject.rst
@@ -0,0 +1,16 @@
+MObject
+=======
+
+The MObject is Manim's main python class representing objects that will be
+rendered on screen.
+
+
+.. automodule:: manim.mobject.mobject
+ :members:
+ :undoc-members:
+ :show-inheritance:
+
+.. automodule:: manim.mobject.geometry
+ :members:
+ :undoc-members:
+ :show-inheritance:
diff --git a/docs/source/quickstart.md b/docs/source/quickstart.md
new file mode 100644
index 000000000..223235ce5
--- /dev/null
+++ b/docs/source/quickstart.md
@@ -0,0 +1,116 @@
+# Quickstart
+
+This document will lead you step by step through the necessary procedure to get
+`manim` up and running as soon as possible.
+
+
+## Installation
+
+[INSTALLATION INSTRUCTIONS GO HERE]. Note: when this section is done, delete
+installation instructions from the GitHub repo README.
+
++ mention pip isntall
++ mention choco package
++ mention things about Cairo and LaTeX
+
+
+## Start a new project
+
+To start a new manim video project, all you need to do is choose a single
+folder where all of the files related to the video will reside. For this
+example, this folder will be called `project`,
+
+```
+project/
+```
+
+Every file containing code that produces a video with manim will be stored
+here, as well as `manim`'s output files and configuration files.
+
+
+## Your first Scene
+
+To produce your first scene, create a new file in your project folder
+
+```
+project/
+└─scene.py
+```
+
+and copy the following code in it
+
+```python
+from manim import *
+
+# all code must be contained inside the construct
+# method of a class that inherits from Scene
+class SquareToCircle(Scene):
+ def construct(self):
+ circle = Circle() # create a circle
+ circle.set_fill(PINK, opacity=0.5) # set the color and transparency
+ self.play(ShowCreation(circle)) # show the circle on screen
+```
+
+Then open your command line, navigate to your project directory, and execute
+the following command:
+
+```bash
+$ manim scene.py SquareToCircle -pl
+```
+
+After some output, `manim` should render the scene into a .mp4 file, and open
+that file with the default movie player application. You should see a video
+playing the following animation.
+
+![first scene output](_static/quickstart/first_scene.gif)
+
+If you see the video and it looks correct, congrats! You just wrote your first
+`manim` scene from scratch. If you get an error message instead, or if do not
+see a video, or if the video output does not look like this, it is likely that
+`manim` has not been installed correctly. Please refer to the Troubleshooting
+page for more information.
+
+## Some bells and whistles
+
+Our scene is a little basic, so let's add some bells and whistles. Modify the
+`scene.py` file to contain the following:
+
+```python
+from manim import *
+
+class SquareToCircle(Scene):
+ def construct(self):
+ circle = Circle() # create a circle
+ circle.set_fill(PINK, opacity=0.5) # set color and transparency
+
+ square = Square() # create a square
+ square.flip(RIGHT) # flip horizontally
+ square.rotate(-3 * TAU / 8) # rotate a certain amount
+
+ self.play(ShowCreation(square)) # animate the creation of the square
+ self.play(Transform(square, circle)) # interpolate the square into the circle
+ self.play(FadeOut(square)) # fade out animation
+```
+
+And render it using the following command:
+
+```bash
+$ manim scene.py SquareToCircle -pl
+```
+
+The output should look as follows.
+
+![second scene output](_static/quickstart/second_scene.gif)
+
+This example shows one of the most basic features of `manim`: the ability to
+implement complicated and perhaps mathematically-intensive animations (such as
+cleanly interpolating between two geometric shapes) in very few lines of code.
+
+
+## You're done!
+
+With a working installation of manim, and the bare basics under your belt, it
+is now time to start creating awesome mathematical animations. For a more
+extensive review of manim's features, as well as its configuration and other
+settings, see the Tutorial page. For a list of all available features, see the
+Reference page.
diff --git a/docs/source/reference.rst b/docs/source/reference.rst
new file mode 100644
index 000000000..5bde2c4d6
--- /dev/null
+++ b/docs/source/reference.rst
@@ -0,0 +1,14 @@
+Manim Reference
+===============
+
+This reference manual details functions, modules, and objects included in
+Manim, describing what they are and what they do. For learning how to use
+Manim, see the quickstart and tutorial documents.
+
+
+.. toctree::
+ :maxdepth: 0
+
+ mobject
+ config
+ constants
diff --git a/docs/source/tutorial.md b/docs/source/tutorial.md
new file mode 100644
index 000000000..9105bef81
--- /dev/null
+++ b/docs/source/tutorial.md
@@ -0,0 +1,84 @@
+[NOTE:] this is some text I wrote that was originally meant to be part of the
+quickstart. However, after some thought I've decided that it's probably a bit
+too much for the quickstart, as the quickstart document is supposed to showcase
+the quickest way of getting up and running with manim. I've moved it here for
+now, but feel free to edit/delete/move this text elsewhere in the
+documentation.
+
+
+## A deeper look
+
+Let's dissect what just happened step by step. First, the following command
+
+```bash
+$ manim scene.py SquareToCircle -pl
+```
+
+executes `manim` on the file `scene.py`, which contains our animation code.
+Further, this command tells manim exactly which `Scene` to be rendered, in this
+case it is `SquareToCircle`. A single scene file may contain more than one
+scene. Next, the flag `-p` tells manim to play the scene once it's rendered,
+and the `-l` flag tells manim to render the scene in low quality.
+
+After the video is rendered, you will see that manim has generated some new
+files and the project folder will look as follows.
+
+```
+project/
+├─scene.py
+└─media
+ ├─videos
+ | └─scene
+ | └─480p15
+ | ├─SquareToCircle.mp4
+ | └─partial_movie_files
+ ├─text
+ └─Tex
+```
+
+There are quite a few new files. The main output is in
+`media/videos/scene/480p15/SquareToCircle.mp4`. By default, the `media` folder
+will contain all of manim's output files. The `media/videos` subfolder
+contains the rendered videos. Inside of it, you will find one folder for each
+different video quality. In our case, since we used the `-l` flag, the video
+was generated at 480p at 15 frames per second from the `scene.py` file.
+Therefore, the output can be found inside `media/videos/scene/480p15`. The
+additional folders `media/videos/scene/480p15/partial_movie_files` as well as
+`media/text` and `media/Tex` contain files that are used by manim internally.
+
+You can see how manim makes use of the generated folder structure by executing
+the following command,
+
+```bash
+$ manim scene.py SquareToCircle -pk
+```
+
+The `-l` flag (for low quality) has been replaced by the `-k` flag, for 4K
+quality. Manim will take considerably longer to render this file, and it will
+play it once it's done since we are using the `-p` flag. The output should
+look like this:
+
+![first scene output](_static/quickstart/first_scene_4k.gif)
+
+And the folder structure should look as follows.
+
+```
+project/
+├─scene.py
+└─media
+ ├─videos
+ | └─scene
+ | ├─480p15
+ | | ├─SquareToCircle.mp4
+ | | └─partial_movie_files
+ | └─2160p60
+ | ├─SquareToCircle.mp4
+ | └─partial_movie_files
+ ├─text
+ └─Tex
+```
+
+Manim has created a new folder `media/videos/2160p60`, which corresponds to the
+resolution and the 60 frames per second corresponding to 4k quality. Inside of
+it, you can find the new `SquareToCircle.mp4`, as well as the corresponding
+`partial_movie_files`.
diff --git a/manim/__main__.py b/manim/__main__.py
index 85bcbfae3..37f757208 100644
--- a/manim/__main__.py
+++ b/manim/__main__.py
@@ -18,7 +18,7 @@ from .logger import logger, console
def open_file_if_needed(file_writer):
- if file_writer_config["quiet"]:
+ if file_writer_config["verbose"] != "DEBUG":
curr_stdout = sys.stdout
sys.stdout = open(os.devnull, "w")
@@ -59,7 +59,7 @@ def open_file_if_needed(file_writer):
sp.call(commands, stdout=FNULL, stderr=sp.STDOUT)
FNULL.close()
- if file_writer_config["quiet"]:
+ if file_writer_config["verbose"] != "DEBUG":
sys.stdout.close()
sys.stdout = curr_stdout
diff --git a/manim/config.py b/manim/config.py
index a6584a49d..e9216deff 100644
--- a/manim/config.py
+++ b/manim/config.py
@@ -88,6 +88,7 @@ def _parse_config(config_parser, args):
args, config_parser, file_writer_config, successfully_read_files = _run_config()
+logger.setLevel(file_writer_config["verbose"])
if _from_command_line():
logger.info(
f"Read configuration files: {[os.path.abspath(cfgfile) for cfgfile in successfully_read_files]}"
diff --git a/manim/constants.py b/manim/constants.py
index e9f41a79f..81674b220 100644
--- a/manim/constants.py
+++ b/manim/constants.py
@@ -152,3 +152,11 @@ COLOR_MAP.update(
)
PALETTE = list(COLOR_MAP.values())
locals().update(COLOR_MAP)
+VERBOSE_FFMPEG_MAP = {
+ "DEBUG": "error",
+ "INFO": "error",
+ "WARNING": "error",
+ "ERROR": "error",
+ "CRITICAL": "fatal",
+}
+VERBOSE_CHOICES = VERBOSE_FFMPEG_MAP.keys()
diff --git a/manim/default.cfg b/manim/default.cfg
index 0a4cae0f4..38d759745 100644
--- a/manim/default.cfg
+++ b/manim/default.cfg
@@ -36,8 +36,11 @@ preview = False
# -f, --show_file_in_finder
show_file_in_finder = False
-# -q, --quiet
-quiet = False
+# -v, --verbose
+verbose = INFO
+
+# --progress_bar
+progress_bar = True
# --sound
sound = False
@@ -155,10 +158,14 @@ logging_level_info = blue
logging_level_warning = red
logging_level_error = red bold
logging_level_critical = red bold reverse
-log_level =
+log_level =
log_time = cyan dim
-log_message =
+log_message =
log_path = dim
log_width = -1
log_height = -1
-log_timestamps = True
\ No newline at end of file
+log_timestamps = True
+
+[ffmpeg]
+# Uncomment the following line to manually set the loglevel for ffmpeg. See ffmpeg manpage for accepted values
+# loglevel = error
diff --git a/manim/mobject/geometry.py b/manim/mobject/geometry.py
index 9c0008562..d56712841 100644
--- a/manim/mobject/geometry.py
+++ b/manim/mobject/geometry.py
@@ -1,3 +1,10 @@
+"""
+geometry.py
+-----------
+
+Classes implementing geometric objects, mostly derived from MObject.
+
+"""
import warnings
import numpy as np
import math
diff --git a/manim/mobject/mobject.py b/manim/mobject/mobject.py
index d7947ab4d..ea90c2b3b 100644
--- a/manim/mobject/mobject.py
+++ b/manim/mobject/mobject.py
@@ -1,3 +1,10 @@
+"""
+mobject.py
+----------
+
+Base classes for all MObjects.
+
+"""
from functools import reduce
import copy
import itertools as it
diff --git a/manim/scene/graph_scene.py b/manim/scene/graph_scene.py
index 0b34384e5..34c482d17 100644
--- a/manim/scene/graph_scene.py
+++ b/manim/scene/graph_scene.py
@@ -31,14 +31,12 @@ class GraphScene(Scene):
"x_min": -1,
"x_max": 10,
"x_axis_width": 9,
- "x_tick_frequency": 1,
"x_leftmost_tick": None, # Change if different from x_min
"x_labeled_nums": None,
"x_axis_label": "$x$",
"y_min": -1,
"y_max": 10,
"y_axis_height": 6,
- "y_tick_frequency": 1,
"y_bottom_tick": None, # Change if different from y_min
"y_labeled_nums": None,
"y_axis_label": "$y$",
@@ -57,10 +55,8 @@ class GraphScene(Scene):
"y_axis_visibility": True, # show or hide the y axis
"x_label_position": UP + RIGHT, # where to place the label of the x axis
"y_label_position": UP + RIGHT, # where to place the label of the y axis
- "x_add_start": 0, # extend the x axis to the left
- "x_add_end": 0, # extend the x axis to the right
- "y_add_start": 0, # extend the y axis to the bottom
- "y_add_end": 0, # extend the y axis to the top
+ "x_axis_config": {},
+ "y_axis_config": {},
}
def setup(self):
@@ -91,18 +87,23 @@ class GraphScene(Scene):
self.x_labeled_nums = []
if self.x_leftmost_tick is None:
self.x_leftmost_tick = self.x_min
- x_axis = NumberLine(
- x_min=self.x_min,
- x_max=self.x_max,
- unit_size=self.space_unit_to_x,
- tick_frequency=self.x_tick_frequency,
- leftmost_tick=self.x_leftmost_tick,
- numbers_with_elongated_ticks=self.x_labeled_nums,
- color=self.axes_color,
- include_tip=self.include_tip,
- add_start=self.x_add_start,
- add_end=self.x_add_end,
+
+ # The dictionary we update here are sensible defaults
+ # that can be overridden through x_axis_config
+ self.x_axis_config = dict(
+ {
+ "x_min": self.x_min,
+ "x_max": self.x_max,
+ "unit_size": self.space_unit_to_x,
+ "leftmost_tick": self.x_leftmost_tick,
+ "numbers_with_elongated_ticks": self.x_labeled_nums,
+ "color": self.axes_color,
+ "include_tip": self.include_tip,
+ },
+ **self.x_axis_config,
)
+
+ x_axis = NumberLine(**self.x_axis_config)
x_axis.shift(self.graph_origin - x_axis.number_to_point(0))
if len(self.x_labeled_nums) > 0:
if self.exclude_zero_label:
@@ -126,20 +127,25 @@ class GraphScene(Scene):
self.y_labeled_nums = []
if self.y_bottom_tick is None:
self.y_bottom_tick = self.y_min
- y_axis = NumberLine(
- x_min=self.y_min,
- x_max=self.y_max,
- unit_size=self.space_unit_to_y,
- tick_frequency=self.y_tick_frequency,
- leftmost_tick=self.y_bottom_tick,
- numbers_with_elongated_ticks=self.y_labeled_nums,
- color=self.axes_color,
- line_to_number_vect=LEFT,
- label_direction=LEFT,
- include_tip=self.include_tip,
- add_start=self.y_add_start,
- add_end=self.y_add_end,
+
+ # The dictionary we update here are sensible defaults
+ # that can be overridden through y_axis_config
+ self.y_axis_config = dict(
+ {
+ "x_min": self.y_min,
+ "x_max": self.y_max,
+ "unit_size": self.space_unit_to_y,
+ "leftmost_tick": self.y_bottom_tick,
+ "numbers_with_elongated_ticks": self.y_labeled_nums,
+ "color": self.axes_color,
+ "line_to_number_vect": LEFT,
+ "label_direction": LEFT,
+ "include_tip": self.include_tip,
+ },
+ **self.y_axis_config,
)
+
+ y_axis = NumberLine(**self.y_axis_config)
y_axis.shift(self.graph_origin - y_axis.number_to_point(0))
y_axis.rotate(np.pi / 2, about_point=y_axis.number_to_point(0))
if len(self.y_labeled_nums) > 0:
diff --git a/manim/scene/scene.py b/manim/scene/scene.py
index 2985b4bdd..70ba5bc4e 100644
--- a/manim/scene/scene.py
+++ b/manim/scene/scene.py
@@ -681,6 +681,7 @@ class Scene(Container):
total=n_iterations,
leave=file_writer_config["leave_progress_bars"],
ascii=True if platform.system() == "Windows" else None,
+ disable=not file_writer_config["progress_bar"],
)
return time_progression
diff --git a/manim/scene/scene_file_writer.py b/manim/scene/scene_file_writer.py
index 67d084c5a..ad5512e1f 100644
--- a/manim/scene/scene_file_writer.py
+++ b/manim/scene/scene_file_writer.py
@@ -389,7 +389,7 @@ class SceneFileWriter(object):
"-", # The imput comes from a pipe
"-an", # Tells FFMPEG not to expect any audio
"-loglevel",
- "error",
+ file_writer_config["ffmpeg_loglevel"],
]
# TODO, the test for a transparent background should not be based on
# the file extension.
@@ -474,7 +474,7 @@ class SceneFileWriter(object):
"-i",
file_list,
"-loglevel",
- "error",
+ file_writer_config["ffmpeg_loglevel"],
]
if self.write_to_movie:
@@ -518,7 +518,7 @@ class SceneFileWriter(object):
"-map",
"1:a:0",
"-loglevel",
- "error",
+ file_writer_config["ffmpeg_loglevel"],
# "-shortest",
temp_file_path,
]
diff --git a/manim/scene/three_d_scene.py b/manim/scene/three_d_scene.py
index 60ef0831d..0da81db6a 100644
--- a/manim/scene/three_d_scene.py
+++ b/manim/scene/three_d_scene.py
@@ -7,9 +7,11 @@ from ..mobject.geometry import Line
from ..mobject.three_dimensions import Sphere
from ..mobject.types.vectorized_mobject import VGroup
from ..mobject.types.vectorized_mobject import VectorizedPoint
+from ..mobject.value_tracker import ValueTracker
from ..scene.scene import Scene
from ..utils.config_ops import digest_config
from ..utils.config_ops import merge_dicts_recursively
+import numpy as np
class ThreeDScene(Scene):
@@ -79,6 +81,38 @@ class ThreeDScene(Scene):
self.camera.theta_tracker.clear_updaters()
self.remove(self.camera.theta_tracker)
+ def begin_3dillusion_camera_rotation(
+ self, rate=1, origin_theta=-60 * DEGREES, origin_phi=75 * DEGREES
+ ):
+ val_tracker_theta = ValueTracker(0)
+
+ def uptate_theta(m, dt):
+ val_tracker_theta.increment_value(dt * rate)
+ val_for_left_right = 0.2 * np.sin(val_tracker_theta.get_value())
+ return m.set_value(origin_theta + val_for_left_right)
+
+ self.camera.theta_tracker.add_updater(uptate_theta)
+ self.add(self.camera.theta_tracker)
+
+ val_tracker_phi = ValueTracker(0)
+
+ def update_phi(m, dt):
+ val_tracker_phi.increment_value(dt * rate)
+ val_for_up_down = 0.1 * np.cos(val_tracker_phi.get_value())
+ return m.set_value(origin_phi + val_for_up_down)
+
+ self.camera.phi_tracker.add_updater(update_phi)
+ self.add(self.camera.phi_tracker)
+
+ def stop_3dillusion_camera_rotation(self):
+ """
+ This method stops all illusion camera rotations.
+ """
+ self.camera.theta_tracker.clear_updaters()
+ self.remove(self.camera.theta_tracker)
+ self.camera.phi_tracker.clear_updaters()
+ self.remove(self.camera.phi_tracker)
+
def move_camera(
self,
phi=None,
@@ -239,10 +273,7 @@ class SpecialThreeDScene(ThreeDScene):
CONFIG = {
"cut_axes_at_radius": True,
- "camera_config": {
- "should_apply_shading": True,
- "exponential_projection": True,
- },
+ "camera_config": {"should_apply_shading": True, "exponential_projection": True},
"three_d_axes_config": {
"num_axis_pieces": 1,
"axis_config": {
@@ -252,7 +283,7 @@ class SpecialThreeDScene(ThreeDScene):
"stroke_width": 2,
},
},
- "sphere_config": {"radius": 2, "resolution": (24, 48),},
+ "sphere_config": {"radius": 2, "resolution": (24, 48)},
"default_angled_camera_position": {
"phi": 70 * DEGREES,
"theta": -110 * DEGREES,
@@ -260,9 +291,9 @@ class SpecialThreeDScene(ThreeDScene):
# When scene is extracted with -l flag, this
# configuration will override the above configuration.
"low_quality_config": {
- "camera_config": {"should_apply_shading": False,},
- "three_d_axes_config": {"num_axis_pieces": 1,},
- "sphere_config": {"resolution": (12, 24),},
+ "camera_config": {"should_apply_shading": False},
+ "three_d_axes_config": {"num_axis_pieces": 1},
+ "sphere_config": {"resolution": (12, 24)},
},
}
@@ -290,13 +321,13 @@ class SpecialThreeDScene(ThreeDScene):
p1 = axis.number_to_point(-1)
p2 = axis.number_to_point(1)
p3 = axis.get_end()
- new_pieces = VGroup(Line(p0, p1), Line(p1, p2), Line(p2, p3),)
+ new_pieces = VGroup(Line(p0, p1), Line(p1, p2), Line(p2, p3))
for piece in new_pieces:
piece.shade_in_3d = True
new_pieces.match_style(axis.pieces)
axis.pieces.submobjects = new_pieces.submobjects
for tick in axis.tick_marks:
- tick.add(VectorizedPoint(1.5 * tick.get_center(),))
+ tick.add(VectorizedPoint(1.5 * tick.get_center()))
return axes
def get_sphere(self, **kwargs):
diff --git a/manim/utils/config_utils.py b/manim/utils/config_utils.py
index a30db759c..a076bfb3f 100644
--- a/manim/utils/config_utils.py
+++ b/manim/utils/config_utils.py
@@ -50,7 +50,6 @@ def _parse_file_writer_config(config_parser, args):
for boolean_opt in [
"preview",
"show_file_in_finder",
- "quiet",
"sound",
"leave_progress_bars",
"write_to_movie",
@@ -133,6 +132,24 @@ def _parse_file_writer_config(config_parser, args):
[fw_config["save_last_frame"], fw_config["from_animation_number"]]
)
+ # Parse the verbose flag to read in the log level
+ verbose = getattr(args, "verbose")
+ verbose = default["verbose"] if verbose is None else verbose
+ fw_config["verbose"] = verbose
+
+ # Parse the ffmpeg log level in the config
+ ffmpeg_loglevel = config_parser["ffmpeg"].get("loglevel", None)
+ fw_config["ffmpeg_loglevel"] = (
+ constants.VERBOSE_FFMPEG_MAP[verbose]
+ if ffmpeg_loglevel is None
+ else ffmpeg_loglevel
+ )
+
+ # Parse the progress_bar flag
+ progress_bar = getattr(args, "progress_bar")
+ if progress_bar is None:
+ progress_bar = default.getboolean("progress_bar")
+ fw_config["progress_bar"] = progress_bar
return fw_config
@@ -193,9 +210,6 @@ def _parse_cli(arg_list, input=True):
const=True,
help="Show the output file in finder",
)
- parser.add_argument(
- "-q", "--quiet", action="store_const", const=True, help="Quiet mode",
- )
parser.add_argument(
"--sound",
action="store_const",
@@ -351,6 +365,31 @@ def _parse_cli(arg_list, input=True):
parser.add_argument(
"--config_file", help="Specify the configuration file",
)
+
+ # Specify the verbosity
+ parser.add_argument(
+ "-v",
+ "--verbose",
+ type=str,
+ help="Verbosity level. Also changes the ffmpeg log level unless the latter is specified in the config",
+ choices=constants.VERBOSE_CHOICES,
+ )
+
+ # Specify if the progress bar should be displayed
+ def _str2bool(s):
+ if s == "True":
+ return True
+ elif s == "False":
+ return False
+ else:
+ raise argparse.ArgumentTypeError("True or False expected")
+
+ parser.add_argument(
+ "--progress_bar",
+ type=_str2bool,
+ help="Display the progress bar",
+ metavar="True/False",
+ )
parsed = parser.parse_args(arg_list)
if hasattr(parsed, "subcommands"):
if _subcommand_name() == "cfg":
diff --git a/requirements.txt b/requirements.txt
index ada73006e..931676c0f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -8,5 +8,7 @@ pydub
pygments
pyreadline; sys_platform == 'win32'
rich>=4.2.1
+sphinx-rtd-theme
+recommonmark>=0.5.0
# pytest (for development only)
# black (for development only)
diff --git a/tests/test_cli/write_cfg_sbcmd_input.txt b/tests/test_cli/write_cfg_sbcmd_input.txt
index 984eea70f..ade1d50b5 100644
--- a/tests/test_cli/write_cfg_sbcmd_input.txt
+++ b/tests/test_cli/write_cfg_sbcmd_input.txt
@@ -6,6 +6,7 @@
+
False
diff --git a/tests/test_graph.py b/tests/test_graph.py
index 18306f87a..7c5ba21ab 100644
--- a/tests/test_graph.py
+++ b/tests/test_graph.py
@@ -22,5 +22,33 @@ class PlotFunctions(GraphScene):
self.play(Animation(f))
+class NumberLineTest(GraphScene):
+ CONFIG = {
+ "x_min": -10,
+ "x_max": 10.3,
+ "y_min": -1.5,
+ "y_max": 1.5,
+ "graph_origin": ORIGIN,
+ "axes_color": YELLOW,
+ "x_labeled_nums": range(-10, 12, 2),
+ "y_labeled_nums": range(-1, 2),
+ "x_axis_config": {
+ "x_min": -5,
+ "decimal_number_config": {"num_decimal_places": 1,},
+ },
+ "y_axis_config": {
+ "color": RED,
+ "decimal_number_config": {"num_decimal_places": 2,},
+ },
+ }
+
+ def construct(self):
+ constants.TEX_TEMPLATE = TexTemplate()
+ self.setup_axes()
+ f = self.get_graph(lambda x: x ** 2)
+
+ self.play(Animation(f))
+
+
def test_scenes():
utils_test_scenes(get_scenes_to_test(__name__), "graph", caching_needed=True)
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.aux b/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.dvi
new file mode 100644
index 000000000..6a6834c77
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.svg b/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.svg
new file mode 100644
index 000000000..3f9ac88e9
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='5.241955pt' height='6.22665pt' viewBox='169.234572 -4.289468 5.241955 6.22665'>
+<defs>
+<path id='g0-121' d='M4.841843-3.795766C4.881694-3.935243 4.881694-3.955168 4.881694-4.024907C4.881694-4.204234 4.742217-4.293898 4.592777-4.293898C4.493151-4.293898 4.333748-4.234122 4.244085-4.084682C4.224159-4.034869 4.144458-3.726027 4.104608-3.5467C4.034869-3.287671 3.965131-3.01868 3.905355-2.749689L3.457036-.956413C3.417186-.806974 2.988792-.109589 2.331258-.109589C1.823163-.109589 1.713574-.547945 1.713574-.916563C1.713574-1.374844 1.882939-1.992528 2.221669-2.86924C2.381071-3.277709 2.420922-3.387298 2.420922-3.58655C2.420922-4.034869 2.102117-4.403487 1.603985-4.403487C.657534-4.403487 .288917-2.958904 .288917-2.86924C.288917-2.769614 .388543-2.769614 .408468-2.769614C.508095-2.769614 .518057-2.789539 .56787-2.948941C.836862-3.88543 1.235367-4.184309 1.574097-4.184309C1.653798-4.184309 1.823163-4.184309 1.823163-3.865504C1.823163-3.616438 1.723537-3.35741 1.653798-3.16812C1.255293-2.11208 1.075965-1.544209 1.075965-1.075965C1.075965-.18929 1.703611 .109589 2.291407 .109589C2.67995 .109589 3.01868-.059776 3.297634-.33873C3.16812 .179328 3.048568 .667497 2.650062 1.195517C2.391034 1.534247 2.012453 1.823163 1.554172 1.823163C1.414695 1.823163 .966376 1.793275 .797011 1.404732C.956413 1.404732 1.085928 1.404732 1.225405 1.285181C1.325031 1.195517 1.424658 1.066002 1.424658 .876712C1.424658 .56787 1.155666 .52802 1.05604 .52802C.826899 .52802 .498132 .687422 .498132 1.175592C.498132 1.673724 .936488 2.042341 1.554172 2.042341C2.580324 2.042341 3.606476 1.135741 3.88543 .009963L4.841843-3.795766Z'/>
+</defs>
+<g id='page1'>
+<use x='169.234572' y='0' xlink:href='#g0-121'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.tex b/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.tex
new file mode 100644
index 000000000..6314f26a7
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/3623b72242f36fa9.tex
@@ -0,0 +1,8 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+\centering $y$
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.aux b/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.dvi
new file mode 100644
index 000000000..7579a460a
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.svg b/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.svg
new file mode 100644
index 000000000..eda70d79a
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='5.241955pt' height='6.22665pt' viewBox='0 -4.289468 5.241955 6.22665'>
+<defs>
+<path id='g0-121' d='M4.841843-3.795766C4.881694-3.935243 4.881694-3.955168 4.881694-4.024907C4.881694-4.204234 4.742217-4.293898 4.592777-4.293898C4.493151-4.293898 4.333748-4.234122 4.244085-4.084682C4.224159-4.034869 4.144458-3.726027 4.104608-3.5467C4.034869-3.287671 3.965131-3.01868 3.905355-2.749689L3.457036-.956413C3.417186-.806974 2.988792-.109589 2.331258-.109589C1.823163-.109589 1.713574-.547945 1.713574-.916563C1.713574-1.374844 1.882939-1.992528 2.221669-2.86924C2.381071-3.277709 2.420922-3.387298 2.420922-3.58655C2.420922-4.034869 2.102117-4.403487 1.603985-4.403487C.657534-4.403487 .288917-2.958904 .288917-2.86924C.288917-2.769614 .388543-2.769614 .408468-2.769614C.508095-2.769614 .518057-2.789539 .56787-2.948941C.836862-3.88543 1.235367-4.184309 1.574097-4.184309C1.653798-4.184309 1.823163-4.184309 1.823163-3.865504C1.823163-3.616438 1.723537-3.35741 1.653798-3.16812C1.255293-2.11208 1.075965-1.544209 1.075965-1.075965C1.075965-.18929 1.703611 .109589 2.291407 .109589C2.67995 .109589 3.01868-.059776 3.297634-.33873C3.16812 .179328 3.048568 .667497 2.650062 1.195517C2.391034 1.534247 2.012453 1.823163 1.554172 1.823163C1.414695 1.823163 .966376 1.793275 .797011 1.404732C.956413 1.404732 1.085928 1.404732 1.225405 1.285181C1.325031 1.195517 1.424658 1.066002 1.424658 .876712C1.424658 .56787 1.155666 .52802 1.05604 .52802C.826899 .52802 .498132 .687422 .498132 1.175592C.498132 1.673724 .936488 2.042341 1.554172 2.042341C2.580324 2.042341 3.606476 1.135741 3.88543 .009963L4.841843-3.795766Z'/>
+</defs>
+<g id='page1'>
+<use x='0' y='0' xlink:href='#g0-121'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.tex b/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.tex
new file mode 100644
index 000000000..333c5610b
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/4c165d8733e6b394.tex
@@ -0,0 +1,8 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+$y$
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.aux b/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.dvi
new file mode 100644
index 000000000..904f439a2
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.svg b/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.svg
new file mode 100644
index 000000000..2e3b30338
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='4.981339pt' height='6.420368pt' viewBox='169.364866 -6.420368 4.981339 6.420368'>
+<defs>
+<path id='g0-54' d='M1.315068-3.267746V-3.506849C1.315068-6.027397 2.550436-6.386052 3.058531-6.386052C3.297634-6.386052 3.716065-6.326276 3.935243-5.987547C3.785803-5.987547 3.387298-5.987547 3.387298-5.539228C3.387298-5.230386 3.626401-5.080946 3.845579-5.080946C4.004981-5.080946 4.303861-5.17061 4.303861-5.559153C4.303861-6.156912 3.865504-6.635118 3.038605-6.635118C1.763387-6.635118 .418431-5.349938 .418431-3.148194C.418431-.488169 1.574097 .219178 2.500623 .219178C3.606476 .219178 4.552927-.71731 4.552927-2.032379C4.552927-3.297634 3.666252-4.254047 2.560399-4.254047C1.882939-4.254047 1.514321-3.745953 1.315068-3.267746ZM2.500623-.059776C1.872976-.059776 1.574097-.657534 1.514321-.806974C1.334994-1.275218 1.334994-2.072229 1.334994-2.251557C1.334994-3.028643 1.653798-4.024907 2.550436-4.024907C2.709838-4.024907 3.16812-4.024907 3.476961-3.407223C3.656289-3.038605 3.656289-2.530511 3.656289-2.042341C3.656289-1.564134 3.656289-1.066002 3.486924-.707347C3.188045-.109589 2.729763-.059776 2.500623-.059776Z'/>
+</defs>
+<g id='page1'>
+<use x='169.364866' y='0' xlink:href='#g0-54'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.tex b/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.tex
new file mode 100644
index 000000000..331337733
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/5b246d8c932af71a.tex
@@ -0,0 +1,10 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+\begin{align*}
+6
+\end{align*}
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.aux b/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.dvi
new file mode 100644
index 000000000..a700d92dc
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.svg b/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.svg
new file mode 100644
index 000000000..6604dd2f4
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='4.981339pt' height='6.420368pt' viewBox='169.364866 -6.420368 4.981339 6.420368'>
+<defs>
+<path id='g0-52' d='M2.929016-1.643836V-.777086C2.929016-.418431 2.909091-.308842 2.171856-.308842H1.96264V0C2.371108-.029888 2.889166-.029888 3.307597-.029888S4.254047-.029888 4.662516 0V-.308842H4.4533C3.716065-.308842 3.696139-.418431 3.696139-.777086V-1.643836H4.692403V-1.952677H3.696139V-6.485679C3.696139-6.684932 3.696139-6.744707 3.536737-6.744707C3.447073-6.744707 3.417186-6.744707 3.337484-6.625156L.278954-1.952677V-1.643836H2.929016ZM2.988792-1.952677H.557908L2.988792-5.668742V-1.952677Z'/>
+</defs>
+<g id='page1'>
+<use x='169.364866' y='0' xlink:href='#g0-52'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.tex b/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.tex
new file mode 100644
index 000000000..454c71f5e
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/62daeedc9e87677e.tex
@@ -0,0 +1,10 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+\begin{align*}
+4
+\end{align*}
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.aux b/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.dvi
new file mode 100644
index 000000000..de7c4bdef
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.svg b/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.svg
new file mode 100644
index 000000000..f51309f7f
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='7.748748pt' height='6.641773pt' viewBox='167.98117 -5.811546 7.748748 6.641773'>
+<defs>
+<path id='g0-0' d='M6.56538-2.291407C6.734745-2.291407 6.914072-2.291407 6.914072-2.49066S6.734745-2.689913 6.56538-2.689913H1.175592C1.006227-2.689913 .826899-2.689913 .826899-2.49066S1.006227-2.291407 1.175592-2.291407H6.56538Z'/>
+</defs>
+<g id='page1'>
+<use x='167.98117' y='0' xlink:href='#g0-0'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.tex b/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.tex
new file mode 100644
index 000000000..533775924
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/66150e0224a73e5f.tex
@@ -0,0 +1,10 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+\begin{align*}
+-
+\end{align*}
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.aux b/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.dvi
new file mode 100644
index 000000000..c3d16507b
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.svg b/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.svg
new file mode 100644
index 000000000..2e465e6b3
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='4.981339pt' height='6.420368pt' viewBox='169.364866 -6.420368 4.981339 6.420368'>
+<defs>
+<path id='g0-49' d='M2.929016-6.37609C2.929016-6.615193 2.929016-6.635118 2.699875-6.635118C2.082192-5.997509 1.205479-5.997509 .886675-5.997509V-5.688667C1.085928-5.688667 1.673724-5.688667 2.191781-5.947696V-.787049C2.191781-.428394 2.161893-.308842 1.265255-.308842H.946451V0C1.295143-.029888 2.161893-.029888 2.560399-.029888S3.825654-.029888 4.174346 0V-.308842H3.855542C2.958904-.308842 2.929016-.418431 2.929016-.787049V-6.37609Z'/>
+</defs>
+<g id='page1'>
+<use x='169.364866' y='0' xlink:href='#g0-49'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.tex b/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.tex
new file mode 100644
index 000000000..e76c2410b
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/6896c368b863add8.tex
@@ -0,0 +1,10 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+\begin{align*}
+1
+\end{align*}
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.aux b/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.dvi
new file mode 100644
index 000000000..bb9557707
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.svg b/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.svg
new file mode 100644
index 000000000..3edc77a56
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='4.981339pt' height='6.420368pt' viewBox='169.364866 -6.420368 4.981339 6.420368'>
+<defs>
+<path id='g0-50' d='M1.265255-.767123L2.321295-1.793275C3.875467-3.16812 4.473225-3.706102 4.473225-4.702366C4.473225-5.838107 3.576588-6.635118 2.361146-6.635118C1.235367-6.635118 .498132-5.718555 .498132-4.83188C.498132-4.273973 .996264-4.273973 1.026152-4.273973C1.195517-4.273973 1.544209-4.393524 1.544209-4.801993C1.544209-5.061021 1.364882-5.32005 1.016189-5.32005C.936488-5.32005 .916563-5.32005 .886675-5.310087C1.115816-5.957659 1.653798-6.326276 2.231631-6.326276C3.138232-6.326276 3.566625-5.519303 3.566625-4.702366C3.566625-3.905355 3.068493-3.118306 2.520548-2.500623L.607721-.368618C.498132-.259029 .498132-.239103 .498132 0H4.194271L4.473225-1.733499H4.224159C4.174346-1.43462 4.104608-.996264 4.004981-.846824C3.935243-.767123 3.277709-.767123 3.058531-.767123H1.265255Z'/>
+</defs>
+<g id='page1'>
+<use x='169.364866' y='0' xlink:href='#g0-50'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.tex b/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.tex
new file mode 100644
index 000000000..b638b4c62
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/7399563bee7ad4e5.tex
@@ -0,0 +1,10 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+\begin{align*}
+2
+\end{align*}
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.aux b/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.dvi
new file mode 100644
index 000000000..793891cad
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.svg b/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.svg
new file mode 100644
index 000000000..e3543b2e9
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='4.981339pt' height='6.420368pt' viewBox='169.364866 -6.420368 4.981339 6.420368'>
+<defs>
+<path id='g0-48' d='M4.582814-3.188045C4.582814-3.985056 4.533001-4.782067 4.184309-5.519303C3.726027-6.475716 2.909091-6.635118 2.49066-6.635118C1.892902-6.635118 1.165629-6.37609 .757161-5.449564C.438356-4.762142 .388543-3.985056 .388543-3.188045C.388543-2.440847 .428394-1.544209 .836862-.787049C1.265255 .019925 1.992528 .219178 2.480697 .219178C3.01868 .219178 3.775841 .009963 4.214197-.936488C4.533001-1.62391 4.582814-2.400996 4.582814-3.188045ZM2.480697 0C2.092154 0 1.504359-.249066 1.325031-1.205479C1.215442-1.803238 1.215442-2.719801 1.215442-3.307597C1.215442-3.945205 1.215442-4.60274 1.295143-5.140722C1.484433-6.326276 2.231631-6.41594 2.480697-6.41594C2.809465-6.41594 3.466999-6.236613 3.656289-5.250311C3.755915-4.692403 3.755915-3.935243 3.755915-3.307597C3.755915-2.560399 3.755915-1.882939 3.646326-1.24533C3.496887-.298879 2.929016 0 2.480697 0Z'/>
+</defs>
+<g id='page1'>
+<use x='169.364866' y='0' xlink:href='#g0-48'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.tex b/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.tex
new file mode 100644
index 000000000..04ec34a57
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/89a469c6726623e3.tex
@@ -0,0 +1,10 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+\begin{align*}
+0
+\end{align*}
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.aux b/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.dvi
new file mode 100644
index 000000000..9d8048295
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.svg b/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.svg
new file mode 100644
index 000000000..286acd2b8
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='5.693932pt' height='4.289468pt' viewBox='0 -4.289468 5.693932 4.289468'>
+<defs>
+<path id='g0-120' d='M3.327522-3.008717C3.387298-3.267746 3.616438-4.184309 4.313823-4.184309C4.363636-4.184309 4.60274-4.184309 4.811955-4.054795C4.533001-4.004981 4.333748-3.755915 4.333748-3.516812C4.333748-3.35741 4.443337-3.16812 4.712329-3.16812C4.931507-3.16812 5.250311-3.347447 5.250311-3.745953C5.250311-4.26401 4.662516-4.403487 4.323786-4.403487C3.745953-4.403487 3.39726-3.875467 3.277709-3.646326C3.028643-4.303861 2.49066-4.403487 2.201743-4.403487C1.165629-4.403487 .597758-3.118306 .597758-2.86924C.597758-2.769614 .697385-2.769614 .71731-2.769614C.797011-2.769614 .826899-2.789539 .846824-2.879203C1.185554-3.935243 1.843088-4.184309 2.181818-4.184309C2.371108-4.184309 2.719801-4.094645 2.719801-3.516812C2.719801-3.20797 2.550436-2.540473 2.181818-1.145704C2.022416-.52802 1.673724-.109589 1.235367-.109589C1.175592-.109589 .946451-.109589 .737235-.239103C.986301-.288917 1.205479-.498132 1.205479-.777086C1.205479-1.046077 .986301-1.125778 .836862-1.125778C.537983-1.125778 .288917-.86675 .288917-.547945C.288917-.089664 .787049 .109589 1.225405 .109589C1.882939 .109589 2.241594-.587796 2.271482-.647572C2.391034-.278954 2.749689 .109589 3.347447 .109589C4.373599 .109589 4.941469-1.175592 4.941469-1.424658C4.941469-1.524284 4.851806-1.524284 4.821918-1.524284C4.732254-1.524284 4.712329-1.484433 4.692403-1.414695C4.363636-.348692 3.686177-.109589 3.367372-.109589C2.978829-.109589 2.819427-.428394 2.819427-.767123C2.819427-.986301 2.879203-1.205479 2.988792-1.643836L3.327522-3.008717Z'/>
+</defs>
+<g id='page1'>
+<use x='0' y='0' xlink:href='#g0-120'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.tex b/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.tex
new file mode 100644
index 000000000..5887b3a5f
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/9f4cc7daf5892d94.tex
@@ -0,0 +1,8 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+$x$
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.aux b/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.dvi
new file mode 100644
index 000000000..2b30f2a2c
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.svg b/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.svg
new file mode 100644
index 000000000..20c2bac79
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='5.693932pt' height='4.289468pt' viewBox='169.008582 -4.289468 5.693932 4.289468'>
+<defs>
+<path id='g0-120' d='M3.327522-3.008717C3.387298-3.267746 3.616438-4.184309 4.313823-4.184309C4.363636-4.184309 4.60274-4.184309 4.811955-4.054795C4.533001-4.004981 4.333748-3.755915 4.333748-3.516812C4.333748-3.35741 4.443337-3.16812 4.712329-3.16812C4.931507-3.16812 5.250311-3.347447 5.250311-3.745953C5.250311-4.26401 4.662516-4.403487 4.323786-4.403487C3.745953-4.403487 3.39726-3.875467 3.277709-3.646326C3.028643-4.303861 2.49066-4.403487 2.201743-4.403487C1.165629-4.403487 .597758-3.118306 .597758-2.86924C.597758-2.769614 .697385-2.769614 .71731-2.769614C.797011-2.769614 .826899-2.789539 .846824-2.879203C1.185554-3.935243 1.843088-4.184309 2.181818-4.184309C2.371108-4.184309 2.719801-4.094645 2.719801-3.516812C2.719801-3.20797 2.550436-2.540473 2.181818-1.145704C2.022416-.52802 1.673724-.109589 1.235367-.109589C1.175592-.109589 .946451-.109589 .737235-.239103C.986301-.288917 1.205479-.498132 1.205479-.777086C1.205479-1.046077 .986301-1.125778 .836862-1.125778C.537983-1.125778 .288917-.86675 .288917-.547945C.288917-.089664 .787049 .109589 1.225405 .109589C1.882939 .109589 2.241594-.587796 2.271482-.647572C2.391034-.278954 2.749689 .109589 3.347447 .109589C4.373599 .109589 4.941469-1.175592 4.941469-1.424658C4.941469-1.524284 4.851806-1.524284 4.821918-1.524284C4.732254-1.524284 4.712329-1.484433 4.692403-1.414695C4.363636-.348692 3.686177-.109589 3.367372-.109589C2.978829-.109589 2.819427-.428394 2.819427-.767123C2.819427-.986301 2.879203-1.205479 2.988792-1.643836L3.327522-3.008717Z'/>
+</defs>
+<g id='page1'>
+<use x='169.008582' y='0' xlink:href='#g0-120'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.tex b/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.tex
new file mode 100644
index 000000000..1803ea0d9
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/cc5e695bd773416a.tex
@@ -0,0 +1,8 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+\centering $x$
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.aux b/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.dvi
new file mode 100644
index 000000000..c1bf61bb9
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.svg b/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.svg
new file mode 100644
index 000000000..1ea8384fd
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='2.767408pt' height='1.051612pt' viewBox='170.47183 -1.051612 2.767408 1.051612'>
+<defs>
+<path id='g0-58' d='M1.912827-.52802C1.912827-.816936 1.673724-1.05604 1.384807-1.05604S.856787-.816936 .856787-.52802S1.09589 0 1.384807 0S1.912827-.239103 1.912827-.52802Z'/>
+</defs>
+<g id='page1'>
+<use x='170.47183' y='0' xlink:href='#g0-58'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.tex b/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.tex
new file mode 100644
index 000000000..f8d3c4305
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/d436dfd178d0a32a.tex
@@ -0,0 +1,10 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+\begin{align*}
+.
+\end{align*}
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.aux b/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.aux
new file mode 100644
index 000000000..9c28a69b6
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.aux
@@ -0,0 +1,2 @@
+\relax
+\@nameuse{bbl@beforestart}
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.dvi b/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.dvi
new file mode 100644
index 000000000..61cf9014b
Binary files /dev/null and b/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.dvi differ
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.svg b/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.svg
new file mode 100644
index 000000000..66583c3df
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.svg
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This file was generated by dvisvgm 2.9.1 -->
+<svg version='1.1' xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' width='4.981339pt' height='6.420368pt' viewBox='169.364866 -6.420368 4.981339 6.420368'>
+<defs>
+<path id='g0-56' d='M1.62391-4.552927C1.165629-4.851806 1.125778-5.190535 1.125778-5.3599C1.125778-5.967621 1.77335-6.386052 2.480697-6.386052C3.20797-6.386052 3.845579-5.867995 3.845579-5.150685C3.845579-4.582814 3.457036-4.104608 2.859278-3.755915L1.62391-4.552927ZM3.078456-3.606476C3.795766-3.975093 4.283935-4.493151 4.283935-5.150685C4.283935-6.067248 3.39726-6.635118 2.49066-6.635118C1.494396-6.635118 .687422-5.897883 .687422-4.971357C.687422-4.79203 .707347-4.343711 1.125778-3.875467C1.235367-3.755915 1.603985-3.506849 1.853051-3.337484C1.275218-3.048568 .418431-2.49066 .418431-1.504359C.418431-.448319 1.43462 .219178 2.480697 .219178C3.606476 .219178 4.552927-.607721 4.552927-1.673724C4.552927-2.032379 4.443337-2.480697 4.064757-2.899128C3.875467-3.108344 3.716065-3.20797 3.078456-3.606476ZM2.082192-3.188045L3.307597-2.410959C3.58655-2.221669 4.054795-1.92279 4.054795-1.315068C4.054795-.577833 3.307597-.059776 2.49066-.059776C1.633873-.059776 .916563-.67746 .916563-1.504359C.916563-2.082192 1.235367-2.719801 2.082192-3.188045Z'/>
+</defs>
+<g id='page1'>
+<use x='169.364866' y='0' xlink:href='#g0-56'/>
+</g>
+</svg>
\ No newline at end of file
diff --git a/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.tex b/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.tex
new file mode 100644
index 000000000..30f7389e1
--- /dev/null
+++ b/tests/tests_cache/graph/NumberLineTest/Tex/e4a76237723951d2.tex
@@ -0,0 +1,10 @@
+\documentclass[preview]{standalone}\usepackage[english]{babel}\usepackage{amsmath}\usepackage{amssymb}\usepackage{dsfont}\usepackage{setspace}\usepackage{tipa}\usepackage{relsize}\usepackage{textcomp}\usepackage{mathrsfs}\usepackage{calligra}\usepackage{wasysym}\usepackage{ragged2e}\usepackage{physics}\usepackage{xcolor}\usepackage{microtype}\linespread{1}
+\DisableLigatures{encoding = *, family = *}
+
+\begin{document}
+
+\begin{align*}
+8
+\end{align*}
+
+\end{document}
\ No newline at end of file
diff --git a/tests/tests_data/graph/NumberLineTest.npy b/tests/tests_data/graph/NumberLineTest.npy
new file mode 100644
index 000000000..4115e4419
Binary files /dev/null and b/tests/tests_data/graph/NumberLineTest.npy differ