manim learning-by-doing - Table

Tables are a common form of presenting data thatmanimoffersTablemodule is specialized for displaying data in tabular form.
tabularTableand the matrix introduced in the previous sectionMatrixare used to display two-dimensional data.
However.TableIt is more expressive, for example, it can display table header information, column name information, and so on.

TableModules are also subdivided into multiple objects:

• common (use)Table: show anything
• DecimalTable: Table contents in figures
• IntegerTable: Table contents are integers
• MathTable: Table contents are formulas
• MobjectTable: Table content is graphic

Among them.DecimalTable，IntegerTable，MathTablecap (a poem)MobjectTableAll inherited fromTableThe.
This article focuses onTableobject, the other objects areTableA special case of the

TableSeries inmanimThe locations in each module are roughly as shown in the diagram above.

1. Main parameters

Key parameters include:

Parameter name	typology	clarification
table	list[list]	Data shown in the table
row_labels	list[VMobject]	Row labels, equivalent to the first column of the table
col_labels	list[VMobject]	Column labels, equivalent to column names, the first row of a table
top_left_entry	VMobject	Displayed in the upper left corner of the table
v_buff	float	Table element row spacing
h_buff	float	Table element column spacing
include_outer_lines	bool	Whether to show the outer border of the form
add_background_rectangles_to_entries	bool	Whether the table background color is added to the table element
entries_background_color	manim color	Background color of form elements
include_background_rectangle	bool	Whether to add a table background color
background_rectangle_color	manim color	Background color of the table
arrange_in_grid_config	dict	Configuration of the table alignment direction
line_config	dict	Configuration of form lines

In general, the parameters are mainly used to set the table rows and columns, table background, lines and other related styles.

2. Main approaches

parametersis generally used when initializing a form, and themethodologiesis used to dynamically change the content and style of the table.
Some common methods are listed below:

name (of a thing)	clarification
add_background_to_entries	Adding a background to a form element
add_highlighted_cell	Highlight a cell
get_rows	Get all row objects
get_columns	Get all column objects
get_cell	Get Cells
get_row_labels	Get the label of the line
get_col_labels	Get the label of the column
get_horizontal_lines	Getting the horizontal lines of a table
get_vertical_lines	Get the vertical line of the table
scale	Zooming Tables
set_row_colors	Setting the line color
set_column_colors	Setting Column Colors
get_highlighted_cell	Getting the highlighted cell

3. Examples of use

The following examples demonstrate common parameters and methods.

3.1 Row labels

tabularTableis the default likematricesMatrixSame, only data is displayed, however, unlike the
Forms can be accessed through the propertiesrows_labelscap (a poem)col_labelsAdd a description of the row and column information.

data = [
    ["90", "100", "60"],
    ["66", "78", "83"], ]
]


# Default table
Table(data)

cols = [
    Text("Xiaohong"),
    
    Text("Xiao Ming"), [
]
rows = [Text("Language"), Text("Math")]

# Table with rows and columns labeled
Table(
    data, col_labels=cols
    col_labels=cols,
    row_labels=rows, )
)

included among theseLabeling of columnsis the name of the student.Labeling of rowsis the name of the subject.

3.2 Content alignment direction

The content in the table is centered by default and can be aligned with the parameterarrange_in_grid_configto adjust its alignment direction.

# left justification
Table(
    data,
    arrange_in_grid_config={
        "cell_alignment": LEFT,
    },
)

# right-aligned
t = Table(
    data,
    arrange_in_grid_config={
        "cell_alignment": RIGHT,
    },
)

3.3 Table borders

The default form has no outer borders, which are made possible by theinclude_outer_linesparameter plus the outer border.
In addition, the line_config parameter sets the thickness and color of the border.

# outer frame
Table(
    data,
    include_outer_lines=True,
)

# Border color and thickness
Table(
    data,
    include_outer_lines=True,
    line_config={
        "stroke_width": 1,
        "color": GREEN,
    },
)

3.4 Background of the table

The background of the form is transparent by default and has two parametersadd_background_rectangles_to_entriescap (a poem)include_background_rectangle，
You can set the background of the form element and the background of the whole form separately.

# Preserve the background of the table element
Table(
    data, add_background_rectangles_to_entries=True
    add_background_rectangles_to_entries=True, )
)

# Keep the entire table background
Table(
    data, include_background_rectangle=True, ) # Keep the entire table background.
    include_background_rectangle=True, )
)

3.5. Customizing the upper-left corner element

After the table has been set up with row and column names, there is an extra upper-left corner position, which is empty by default.
You can fill the upper left corner of the form with anything you want, including math formulas and graphs.

cols = [
    Text("Xiaohong"),
    Text("Xiaohua"),
    Text("Xiao Ming"), [
]
rows = [Text("Language"), Text("Math")]

# The top left corner is empty by default
Table(
    data, row_labels=rows, table()
    row_labels=rows, col_labels=cols
    col_labels=cols, )
)

# Fill in the top left corner with the formula
mt = MathTex("y=\sum x_i", color=RED)
t = Table(
    data, row_labels=rows, color=RED
    row_labels=rows,
    col_labels=cols.
    top_left_entry=mt, )
)

# Fill in the top left corner with the graphic
star = Star(color=RED).scale(0.5)
Table(
    data, row_labels=rows, table()
    
    col_labels=cols, top_left_entry=star, # table(
    top_left_entry=star, )
)

3.6 Line operations

The row and column operation methods allow you to get row and column objects and add more customized operations.

cols = [
    Text("little red"),
    Text("Siu Wah"),
    Text("Xiaoming (1904-1971), Soviet trained Chinese * leader, a martyr of the Cultural Revolution"),
]
rows = [Text("multilingualism"), Text("math")]

# by row Setting the color
t = Table(
    data,
    row_labels=rows,
    col_labels=cols,
)
.set_row_colors(
    BLUE, RED, YELLOW
)

# by column Setting the color
t = Table(
    data,
    row_labels=rows,
    col_labels=cols,
)
.set_column_colors(
    BLUE, RED, YELLOW, GREEN
)

# Get Row Objects
t = Table(
    data,
    row_labels=rows,
    col_labels=cols,
)
rows = t.get_rows()
(SurroundingRectangle(rows[1]))

# Getting Column Objects
t = Table(
    data,
    row_labels=rows,
    col_labels=cols,
)
cols = t.get_columns()
(SurroundingRectangle(cols[1]))
(SurroundingRectangle(cols[3]))

3.7 Cell manipulation

Cell operation is more detailed than the rows and columns form operation.

cols = [
    Text("little red"),
    Text("Siu Wah"),
    Text("Xiaoming (1904-1971), Soviet trained Chinese * leader, a martyr of the Cultural Revolution"),
]
rows = [Text("multilingualism"), Text("math")]

# Cell Color
t = Table(
    data,
    include_outer_lines=True,
    row_labels=rows,
    col_labels=cols,
)
cell1 = t.get_cell(pos=(2, 2))
cell2 = t.get_cell(pos=(3, 4))
cell1.set_color(RED)
cell2.set_color(BLUE)
(cell1, cell2)

# high brightness unit cell
t = Table(
    data,
    include_outer_lines=True,
    row_labels=rows,
    col_labels=cols,
)
(Create(t), run_time=run_time)
t.add_highlighted_cell(
    pos=(2, 2),
    color=GREEN,
)
t.add_highlighted_cell(
    pos=(3, 4),
    color=YELLOW,
)

3.8 Border operations

Finally, the borders of the form can also be customized, theget_horizontal_linescap (a poem)get_vertical_linesmethod provides us with a way to get the table's horizontal and vertical line objects.

cols = [
    Text("little red"),
    Text("Siu Wah"),
    Text("Xiaoming (1904-1971), Soviet trained Chinese * leader, a martyr of the Cultural Revolution"),
]
rows = [Text("multilingualism"), Text("math")]

# Setting the color of the horizontal line
t = Table(
    data,
    row_labels=rows,
    col_labels=cols,
)
lines = t.get_horizontal_lines()
lines[0].set_color(RED)
lines[1].set_color(BLUE)

# Setting the color of the vertical line
t = Table(
    data,
    row_labels=rows,
    col_labels=cols,
)
lines = t.get_vertical_lines()
lines[0].set_color(RED)
lines[1].set_color(BLUE)
lines[2].set_color(YELLOW)

4. Annexes

The complete code for the article is on a web disk (），
Download at.Full Code (Access code: 6872)