table(ax, cellText=None, cellColours=None, cellLoc='right', colWidths=None, rowLabels=None, rowColours=None, rowLoc='left', colLabels=None, colColours=None, colLoc='center', loc='bottom', bbox=None, edges='closed', **kwargs)

At least one of cellText or cellColours must be specified. These parameters must be 2D lists, in which the outer lists define the rows and the inner list define the column values per row. Each row must have the same number of elements.

The table can optionally have row and column headers, which are configured using rowLabels, rowColours, rowLoc and colLabels, colColours, colLoc respectively.

For finer grained control over tables, use the .Table class and add it to the axes with :None:None:`.Axes.add_table`.

Other Parameters

**kwargs :

.Table properties.

Properties: :

agg_filter: a filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array alpha: scalar or None animated: bool clip_box: .Bbox clip_on: bool clip_path: Patch or (Path, Transform) or None figure: .Figure fontsize: float gid: str in_layout: bool label: object path_effects: .AbstractPathEffect picker: None or bool or float or callable rasterized: bool sketch_params: (scale: float, length: float, randomness: float) snap: bool or None transform: .Transform url: str visible: bool zorder: float

Parameters

cellText : 2D list of str, optional

The texts to place into the table cells.

Note: Line breaks in the strings are currently not accounted for and will result in the text exceeding the cell boundaries.

cellColours : 2D list of colors, optional

The background colors of the cells.

cellLoc : {'left', 'center', 'right'}, default: 'right'

The alignment of the text within the cells.

colWidths : list of float, optional

The column widths in units of the axes. If not given, all columns will have a width of 1 / ncols.

rowLabels : list of str, optional

The text of the row header cells.

rowColours : list of colors, optional

The colors of the row header cells.

rowLoc : {'left', 'center', 'right'}, default: 'left'

The text alignment of the row header cells.

colLabels : list of str, optional

The text of the column header cells.

colColours : list of colors, optional

The colors of the column header cells.

colLoc : {'left', 'center', 'right'}, default: 'left'

The text alignment of the column header cells.

loc : str, optional

The position of the cell with respect to ax. This must be one of the :None:None:`~.Table.codes`.

bbox : `.Bbox`, optional

A bounding box to draw the table into. If this is not None, this overrides loc.

edges : substring of 'BRTL' or {'open', 'closed', 'horizontal', 'vertical'}

The cell edges to be drawn with a line. See also :None:None:`~.Cell.visible_edges`.

Returns

`~matplotlib.table.Table`

The created table.

Add a table to an :None:None:`~.axes.Axes`.

Examples

See :

Back References

The following pages refer to to this document either explicitly or contain code examples using this.

matplotlib.axes._base._AxesBase.add_table matplotlib.pyplot.table matplotlib.table matplotlib.table.Table

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them

---

File: /matplotlib/table.py#647
type: <class 'function'>
Commit: