matplotlib.table

Рисование таблиц.

Используйте фабричную функцию table для создания готовой таблицы из текстов. Если вам нужен больший контроль, используйте класс Table и его методы.

Таблица состоит из сетки ячеек, которые индексируются по (строка, столбец). Ячейка (0, 0) расположена в левом верхнем углу.

Благодарим Джона Гиля за предоставление класса и таблицы.

classmatplotlib.table.Cell(xy, width, height, *, edgecolor='k', facecolor='w', fill=True, text='', loc='right', fontproperties=None, visible_edges='closed')[source]

Bases: Rectangle

Ячейка — это Rectangle с некоторыми связанными Text.

Скорее всего, вы, как пользователь, не будете создавать ячейки самостоятельно. Вместо этого вы должны использовать функцию-фабрику table или Table.add_cell.

Параметры:

xy2-кортеж

Положение левого нижнего угла ячейки.

widthвещественное число

Ширина ячейки.

heightвещественное число

Высота ячейки.

edgecolorцвет, по умолчанию: 'k'

Цвет границы ячейки.

facecolorцвет, по умолчанию: 'w'

Цвет заливки ячейки.

fillлогическое значение, по умолчанию: True

Заливать ли фон ячейки.

textстрока, необязательно

Текст ячейки.

loc{'right', 'center', 'left'}

Выравнивание текста внутри ячейки.

fontpropertiesсловарь, необязательно

Словарь, определяющий свойства шрифта текста. Поддерживаемые ключи и значения — это ключевые аргументы, принимаемые FontProperties.

visible_edges{'closed', 'open', 'horizontal', 'vertical'} или подстрока 'BRTL'

Границы ячейки, которые будут нарисованы линией: подстрока 'BRTL' (bottom, right, top, left), или одно из 'open' (никаких границ не рисовать), 'closed' (все границы нарисованы), 'horizontal' (нижняя и верхняя), 'vertical' (правая и левая).

PAD=0.1

Отступ между текстом и прямоугольником.

auto_set_font_size(renderer)[source]

Уменьшать размер шрифта до тех пор, пока текст не поместится в ширину ячейки.

draw(renderer)[source]

Отрисовать элемент (и его потомков) с помощью данного рендерера.

Это не имеет эффекта, если элемент не отображается (Artist.get_visible возвращает False).

Параметры:

rendererRendererBase подкласс.

Примечания

Этот метод переопределяется в подклассах Artist.

get_fontsize()[source]

Возвращает размер шрифта ячейки.

get_path()[source]

Возвращает Path для visible_edges.

get_required_width(renderer)[source]

Возвращает минимальную необходимую ширину ячейки.

get_text()[source]

Возвращает экземпляр Text ячейки.

get_text_bounds(renderer)[source]

Возвращает границы текста как (x, y, ширина, высота) в координатах таблицы.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, angle=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, bounds=<UNSET>, capstyle=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, fill=<UNSET>, fontsize=<UNSET>, gid=<UNSET>, hatch=<UNSET>, height=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, text_props=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, width=<UNSET>, x=<UNSET>, xy=<UNSET>, y=<UNSET>, zorder=<UNSET>)[source]

Установить сразу несколько свойств.

Поддерживаемые свойства:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения
alpha	скаляр или None
angle	неизвестно
animated	bool
antialiased или aa	bool или None
bounds	(левый, нижний, ширина, высота)
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
color	цвет
edgecolor или ec	цвет или None
facecolor или fc	цвет или None
figure	неизвестно
fill	bool
fontsize	неизвестно
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
height	неизвестно
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или ls	{'-', '--', '-.', ':', '', (смещение, последовательность вкл-выкл), ...}
linewidth или lw	число с плавающей точкой или None
mouseover	bool
path_effects	список AbstractPathEffect
picker	None или bool или число с плавающей точкой или вызываемая функция
rasterized	bool
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	bool или None
text_props	неизвестно
transform	неизвестно
url	строка
visible	bool
width	неизвестно
x	неизвестно
xy	(число с плавающей точкой, число с плавающей точкой)
y	неизвестно
zorder	число с плавающей точкой

set_figure(fig)[source]

Установить экземпляр Figure, к которому относится объект.

Параметры:

figFigure

set_fontsize(size)[source]

Установить размер шрифта текста.

set_text_props(**kwargs)[source]

Обновите свойства текста.

Допустимыми ключевыми аргументами являются:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
animated	bool
antialiased	bool
backgroundcolor	цвет
bbox	словарь со свойствами для patches.FancyBboxPatch
clip_box	неизвестно
clip_on	неизвестно
clip_path	неизвестно
color или c	цвет
figure	Figure
fontfamily или family или fontname	{ШРИФТ, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties или font или font_properties	font_manager.FontProperties или str или pathlib.Path
fontsize или size	число или {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch или stretch	{числовое значение в диапазоне 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
fontstyle или style	{'normal', 'italic', 'oblique'}
fontvariant или variant	{'normal', 'small-caps'}
fontweight или weight	{числовое значение в диапазоне 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
gid	строка
horizontalalignment или ha	{'left', 'center', 'right'}
in_layout	bool
label	объект
linespacing	число (кратное размеру шрифта)
math_fontfamily	строка
mouseover	bool
multialignment или ma	{'left', 'right', 'center'}
parse_math	bool
path_effects	список AbstractPathEffect
picker	None или bool или float или вызываемый объект
position	(число, число)
rasterized	bool
rotation	число или {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(масштаб: число, длина: число, случайность: число)
snap	bool или None
text	объект
transform	Transform
transform_rotates_text	bool
url	строка
usetex	bool, по умолчанию: rcParams["text.usetex"] (по умолчанию: False)

verticalalignment или va	{'основание', 'низ', 'центр', 'центр_основание', 'верх'}
visible	bool
wrap	bool
x	float
y	float
zorder	float

set_transform(t)[source]

Установить преобразование объекта.

Параметры:

tTransform

свойствоvisible_edges

Границы ячейки, которые должны быть нарисованы линией.

Чтение этого свойства возвращает подстроку 'BRTL' (низ, право, верх, лево).

При установке этого свойства можно использовать подстроку 'BRTL' или одно из значений {'open', 'closed', 'horizontal', 'vertical'}.

matplotlib.table.CustomCell[source]

Псевдоним для Cell

классmatplotlib.table.Table(ax, loc=None, bbox=None, **kwargs)[source]

Базы: Artist

Таблица ячеек.

Таблица состоит из сетки ячеек, индексируемых по (строка, столбец).

Для простой таблицы у вас будет полная сетка ячеек с индексами от (0, 0) до (num_rows-1, num_cols-1), в которой ячейка (0, 0) расположена в левом верхнем углу. Однако вы также можете добавлять ячейки с отрицательными индексами. Вам не нужно добавлять ячейку в каждую позицию сетки, поэтому вы можете создавать таблицы с пропусками.

Примечание: Обычно вы не создаете пустую таблицу с нуля. Вместо этого используйте table для создания таблицы из данных.

Параметры:

axAxes

График Axes для отображения таблицы.

locстрока, необязательно

Позиция ячейки относительно ax. Это должно быть одно из значений codes.

bboxBbox или [xmin, ymin, ширина, высота], необязательно

Прямоугольник, в который должна быть нарисована таблица. Если это не None, это переопределяет loc.

Другие параметры:

**kwargs

Свойства Artist.

AXESPAD=0.02

Граница между осями и краем таблицы в единицах осей.

FONTSIZE=10

add_cell(row, col, *args, **kwargs)[source]

Создайте ячейку и добавьте ее в таблицу.

Параметры:

rowint

Индекс строки.

colint

Индекс столбца.

*args, **kwargs

Все остальные параметры передаются в Cell.

Возвращает:

Cell

Созданная ячейка.

auto_set_column_width(col)[source]

Автоматически устанавливает ширину заданных столбцов на оптимальные значения.

Параметры:

colint или последовательность целых чисел

Индексы столбцов для автоматического масштабирования.

auto_set_font_size(value=True)[source]

Автоматически устанавливает размер шрифта.

codes={'best': 0, 'bottom': 17, 'bottom left': 12, 'bottom right': 13, 'center': 9, 'center left': 5, 'center right': 6, 'left': 15, 'lower center': 7, 'lower left': 3, 'lower right': 4, 'right': 14, 'top': 16, 'top left': 11, 'top right': 10, 'upper center': 8, 'upper left': 2, 'upper right': 1}

Возможные значения для размещения таблицы относительно осей.

contains(mouseevent)[source]

Проверяет, содержит ли объект художник событие мыши.

Параметры:

mouseeventMouseEvent

Возвращает:

containsbool

Принадлежит ли хотя бы одно значение радиусу.

detailsdict

Словарь с данными, специфичными для объекта художника, такими как точки, содержащиеся в радиусе выбора. Смотрите подклассы отдельных объектов художников для подробностей.

draw(renderer)[source]

Отобразить объект художника (и его дочерние элементы) с помощью данного рендерера.

Это не имеет эффекта, если художник не виден (Artist.get_visible возвращает False).

Параметры:

rendererRendererBase подкласс.

Примечания

Этот метод переопределен в подклассах объектов художника.

свойствоedges

Значение по умолчанию visible_edges для новых ячеек, добавленных с помощью add_cell.

Примечания

Это значение в настоящее время влияет только на недавно созданные ячейки, используемые с помощью add_cell.

Чтобы изменить существующие ячейки, нужно явно задать их края:

for c in tab.get_celld().values():
    c.visible_edges = 'horizontal'

get_celld()[source]

Возвращает словарь ячеек в таблице, сопоставляющий (строка, столбец) с Cell.

Примечания

Вы также можете напрямую индексировать объект Table для доступа к отдельным ячейкам:

cell = table[row, col]

get_children()[source]

Возвращает объекты художников, содержащихся в таблице.

get_window_extent(renderer=None)[source]

Получить область элемента управления в пространстве отображения.

Ширина и высота области неотрицательны.

Подклассы должны переопределять для включения в вычисление "плотной" области. По умолчанию возвращается пустая область в координатах 0, 0.

Будьте осторожны при использовании этой функции, результаты не обновятся, если область элемента управления изменяется. Область может измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или используемого холста (как это делается при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но будут сохранены неправильно.

scale(xscale, yscale)[source]

Изменить ширину столбцов на xscale и высоту строк на yscale.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, fontsize=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[source]

Установить сразу несколько свойств.

Поддерживаемые свойства:

Свойство	Описание
agg_filter	Функция фильтра, которая принимает массив (m, n, 3) с плавающей точкой и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
animated	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Объект Patch или (Path, Transform) или None
figure	Figure
fontsize	float
gid	str
in_layout	bool
label	объект
mouseover	bool
path_effects	список AbstractPathEffect
picker	None или bool или float или вызываемый объект
rasterized	bool
sketch_params	(масштаб: float, длина: float, случайность: float)
snap	bool или None
transform	Transform
url	str
visible	bool
zorder	float

set_fontsize(size)[source]

Установить размер шрифта ячейки в пунктах.

Параметры:

sizefloat

Примечания

Пока не отключен автоматический размер шрифта, значение будет ограничено так, чтобы текст помещался по горизонтали в ячейку.

Вы можете отключить это поведение, используя auto_set_font_size.

>>> the_table.auto_set_font_size(False)
>>> the_table.set_fontsize(20)

Однако, автоматического изменения высоты строки нет, поэтому текст может выходить за пределы ячейки.

matplotlib.table.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)[source]

Добавление таблицы в Axes.

По крайней мере, один из параметров cellText или cellColours должен быть указан. Эти параметры должны быть двумерными списками, где внешние списки определяют строки, а внутренние списки — значения столбцов по строкам. Каждая строка должна содержать одинаковое количество элементов.

Таблица может также содержать заголовки строк и столбцов, которые настраиваются с помощью параметров rowLabels, rowColours, rowLoc и colLabels, colColours, colLoc соответственно.

Для более тонкого управления таблицами используйте класс Table и добавьте его в Axes с помощью Axes.add_table.

Параметры:

cellText2D list of str, optional

Тексты для размещения в ячейках таблицы.

Примечание: Переводы строк в строках в настоящее время не учитываются и могут привести к тому, что текст выйдет за границы ячейки.

cellColours2D list of цвет, optional

Цвета фона ячеек.

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

Выравнивание текста в ячейках.

colWidthslist of float, optional

Ширина столбцов в единицах осей. Если не задано, все столбцы будут иметь ширину 1 / ncols.

rowLabelslist of str, optional

Текст ячеек заголовков строк.

rowColourslist of цвет, optional

Цвета ячеек заголовков строк.

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

Выравнивание текста ячеек заголовков строк.

colLabelslist of str, optional

Текст ячеек заголовков столбцов.

colColourslist of цвет, optional

Цвета ячеек заголовков столбцов.

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

Выравнивание текста ячеек заголовков столбцов.

locstr, default: 'bottom'

Положение ячейки относительно ax. Должно быть одно из значений codes.

bboxBbox или [xmin, ymin, width, height], optional

Прямоугольная область для рисования таблицы. Если это не None, это переопределяет loc.

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

Границы ячеек, которые будут нарисованы линией. Смотрите также visible_edges.

Возвращаемое значение:

Table

Созданная таблица.

Другие параметры:

**kwargs

Свойства Table.

Свойство	Описание
agg_filter	функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi и возвращает (m, n, 3) массив и два смещения от нижнего левого угла изображения
alpha	скаляр или None
animated	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
figure	Figure
fontsize	float
gid	str
in_layout	bool
label	объект
mouseover	bool
path_effects	список AbstractPathEffect
picker	None или bool или float или вызываемый объект
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	str
visible	bool
zorder	float