mpl_toolkits.axes_grid1.anchored_artists.AnchoredSizeBar

classmpl_toolkits.axes_grid1.anchored_artists.AnchoredSizeBar(transform, size, label, loc, pad=0.1, borderpad=0.1, sep=2, frameon=True, size_vertical=0, color='black', label_top=False, fontproperties=None, fill_bar=None, **kwargs)[source]

Bases: AnchoredOffsetbox

Отображает горизонтальную шкалу с меткой, выровненной по центру снизу.

Параметры:

transformmatplotlib.transforms.Transform

Объект преобразования для используемой системы координат, т.е. matplotlib.axes.Axes.transData.

sizefloat

Горизонтальная длина шкалы, заданная в координатах transform.

labelstr

Метка для отображения.

locstr

Положение шкалы. Допустимые значения: 'верхний левый', 'верхний центр', 'верхний правый', 'центр слева', 'центр', 'центр справа', 'нижний левый', 'нижний центр', 'нижний правый'. Для обратной совместимости также принимаются числовые значения. Подробнее см. параметр loc в Legend.

padfloat, по умолчанию: 0.1

Отступ вокруг метки и шкалы, в долях размера шрифта.

borderpadfloat, по умолчанию: 0.1

Отступ по границе, в долях размера шрифта.

sepfloat, по умолчанию: 2

Отступ между меткой и шкалой, в пунктах.

frameonbool, по умолчанию: True

Если True, рисуется рамка вокруг горизонтальной шкалы и метки.

size_verticalfloat, по умолчанию: 0

Вертикальная длина шкалы, заданная в координатах transform.

colorstr, по умолчанию: 'черный'

Цвет шкалы и метки.

label_topbool, по умолчанию: False

Если True, метка будет над шкалой.

fontpropertiesmatplotlib.font_manager.FontProperties, необязательно

Свойства шрифта для текста метки.

fill_barbool, необязательно

Если True и size_vertical не равно нулю, шкала будет залита цветом, заданным для шкалы. По умолчанию True, если size_vertical больше нуля, и False в противном случае.

**kwargs

Ключевые аргументы, переданные в AnchoredOffsetbox.

Примечания

Если prop передан в качестве ключевого аргумента, но fontproperties нет, то prop предполагается как предназначенное fontproperties. Одновременное использование как prop, так и fontproperties не поддерживается.

Примеры

>>> import matplotlib.pyplot as plt
>>> import numpy as np
>>> from mpl_toolkits.axes_grid1.anchored_artists import (
...     AnchoredSizeBar)
>>> fig, ax = plt.subplots()
>>> ax.imshow(np.random.random((10, 10)))
>>> bar = AnchoredSizeBar(ax.transData, 3, '3 data units', 4)
>>> ax.add_artist(bar)
>>> fig.show()

Использование всех необязательных параметров

>>> import matplotlib.font_manager as fm
>>> fontprops = fm.FontProperties(size=14, family='monospace')
>>> bar = AnchoredSizeBar(ax.transData, 3, '3 units', 4, pad=0.5,
...                       sep=5, borderpad=0.5, frameon=False,
...                       size_vertical=0.5, color='white',
...                       fontproperties=fontprops)

Атрибуты:

size_barmatplotlib.offsetbox.AuxTransformBox

Контейнер для шкалы.

txt_labelmatplotlib.offsetbox.TextArea

Контейнер для метки шкалы.

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

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

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

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

Примеры использования mpl_toolkits.axes_grid1.anchored_artists.AnchoredSizeBar

Демонстрация вставки

Демонстрация вставки

Простые закрепленные элементы

Простые закрепленные элементы