matplotlib.axes.Axes.table
-
Axes.
table
( 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 ) -
Add a table to an
Axes
.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 withAxes.add_table
.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
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
visible_edges
.
Returns: -
Table
-
The created table.
Other Parameters: - **kwargs
-
Table
properties.Property Description 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 contains
unknown 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
Examples using matplotlib.axes.Axes.table
© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.3/api/_as_gen/matplotlib.axes.Axes.table.html