mpl_toolkits.axes_grid1.anchored_artists

class mpl_toolkits.axes_grid1.anchored_artists.AnchoredAuxTransformBox(transform, loc, pad=0.4, borderpad=0.5, prop=None, frameon=True, **kwargs)

Базы: matplotlib.offsetbox.AnchoredOffsetbox

Якорная контейнерная область с преобразованными координатами.

Элементы, добавленные в drawing_area, масштабируются в соответствии с координатами используемого преобразования. Размеры этого элемента будут масштабироваться, чтобы содержать добавленные элементы.

Параметры:

transform : matplotlib.transforms.Transform Объект преобразования для используемой системы координат, т.е. matplotlib.axes.Axes.transData. loc : int Положение этого элемента. Допустимые коды положений: 'upper right' : 1, 'upper left' : 2, 'lower left' : 3, 'lower right' : 4, 'right' : 5, 'center left' : 6, 'center right' : 7, 'lower center' : 8, 'upper center' : 9, 'center' : 10 pad : int или float, необязательно Отступ вокруг дочерних элементов, в долях размера шрифта. По умолчанию 0,4. borderpad : int или float, необязательно Отступ границы, в долях размера шрифта. По умолчанию 0,5. prop : matplotlib.font_manager.FontProperties, необязательно Свойства шрифта, используемые в качестве эталона для отступов. frameon : bool, необязательно Если True, отобразить рамку вокруг этого элемента. По умолчанию True. **kwargs : Ключевые аргументы для передачи в matplotlib.offsetbox.AnchoredOffsetbox.

Примеры

Чтобы отобразить эллипс в верхнем левом углу с шириной 0,1 и высотой 0,4 в координатах данных:

>>> box = AnchoredAuxTransformBox(ax.transData, loc=2)
>>> el = Ellipse((0,0), width=0.1, height=0.4, angle=30)
>>> box.drawing_area.add_artist(el)
>>> ax.add_artist(box)

Атрибуты

drawing_area

(matplotlib.offsetbox.AuxTransformBox) Контейнер для отображения элементов.

class mpl_toolkits.axes_grid1.anchored_artists.AnchoredDrawingArea(width, height, xdescent, ydescent, loc, pad=0.4, borderpad=0.5, prop=None, frameon=True, **kwargs)

Базы: matplotlib.offsetbox.AnchoredOffsetbox

Якорная контейнерная область с фиксированным размером и области рисования с возможностью заполнения.

Элементы, добавленные в drawing_area, будут интерпретироваться как пиксели. Любые преобразования, установленные для элементов, будут переопределены.

Параметры:

width, height : int или float Ширина и высота контейнера в пикселях. xdescent, ydescent : int или float Опускание контейнера по x и y, в пикселях. loc : int Положение этого элемента. Допустимые коды положений: 'upper right' : 1, 'upper left' : 2, 'lower left' : 3, 'lower right' : 4, 'right' : 5, 'center left' : 6, 'center right' : 7, 'lower center' : 8, 'upper center' : 9, 'center' : 10 pad : int или float, необязательно Отступ вокруг дочерних элементов, в долях размера шрифта. По умолчанию 0,4. borderpad : int или float, необязательно Отступ границы, в долях размера шрифта. По умолчанию 0,5. prop : matplotlib.font_manager.FontProperties, необязательно Свойства шрифта, используемые в качестве эталона для отступов. frameon : bool, необязательно Если True, отобразить рамку вокруг этого элемента. По умолчанию True. **kwargs : Ключевые аргументы для передачи в matplotlib.offsetbox.AnchoredOffsetbox.

Примеры

Чтобы отобразить синие и красные круги разного размера в правом верхнем углу осей ax:

>>> ada = AnchoredDrawingArea(20, 20, 0, 0, loc=1, frameon=False)
>>> ada.drawing_area.add_artist(Circle((10, 10), 10, fc="b"))
>>> ada.drawing_area.add_artist(Circle((30, 10), 5, fc="r"))
>>> ax.add_artist(ada)

Атрибуты

drawing_area

(matplotlib.offsetbox.DrawingArea) Контейнер для отображения элементов.

class mpl_toolkits.axes_grid1.anchored_artists.AnchoredEllipse(transform, width, height, angle, loc, pad=0.1, borderpad=0.1, prop=None, frameon=True, **kwargs)

Базы: matplotlib.offsetbox.AnchoredOffsetbox

Отображает якорный эллипс заданного размера.

Параметры:

transform : matplotlib.transforms.Transform Объект преобразования для используемой системы координат, т.е. matplotlib.axes.Axes.transData. width, height : int или float Ширина и высота эллипса, заданные в координатах transform. angle : int или float Поворот эллипса, в градусах, против часовой стрелки. loc : int Положение этой шкалы размера. Допустимые коды положений: 'upper right' : 1, 'upper left' : 2, 'lower left' : 3, 'lower right' : 4, 'right' : 5, 'center left' : 6, 'center right' : 7, 'lower center' : 8, 'upper center' : 9, 'center' : 10 pad : int или float, необязательно Отступ вокруг эллипса, в долях размера шрифта. По умолчанию 0,1. borderpad : int или float, необязательно Отступ границы, в долях размера шрифта. По умолчанию 0,1. frameon : bool, необязательно Если True, отобразить рамку вокруг эллипса. По умолчанию True. prop : matplotlib.font_manager.FontProperties, необязательно Свойства шрифта, используемые в качестве эталона для отступов. **kwargs : Ключевые аргументы для передачи в matplotlib.offsetbox.AnchoredOffsetbox.

Атрибуты

ellipse

(matplotlib.patches.Ellipse) Отображаемый эллипс.

class mpl_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, **kwargs)

Bases: matplotlib.offsetbox.AnchoredOffsetbox

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

Параметры:

transform : matplotlib.transforms.Transform Объект преобразования для используемой системы координат, т.е. matplotlib.axes.Axes.transData. size : int или float Горизонтальная длина линейки масштаба, заданная в координатах transform. label : str Текст подписи. loc : int Положение линейки масштаба. Допустимые коды расположения: 'upper right' : 1, 'upper left' : 2, 'lower left' : 3, 'lower right' : 4, 'right' : 5, 'center left' : 6, 'center right' : 7, 'lower center' : 8, 'upper center' : 9, 'center' : 10 pad : int или float, необязательно Отступ вокруг подписи и линейки масштаба, в долях размера шрифта. По умолчанию 0.1. borderpad : int или float, необязательно Отступ от границ, в долях размера шрифта. По умолчанию 0.1. sep : int или float, необязательно Отступ между подписью и линейкой масштаба, в пунктах. По умолчанию 2. frameon : bool, необязательно Если True, рисует рамку вокруг горизонтальной линейки и подписи. По умолчанию True. size_vertical : int или float, необязательно Вертикальная длина линейки масштаба, заданная в координатах transform. По умолчанию 0. color : str, необязательно Цвет линейки масштаба и подписи. По умолчанию черный. label_top : bool, необязательно Если True, подпись будет над линейкой масштаба. По умолчанию False. fontproperties : matplotlib.font_manager.FontProperties, необязательно Свойства шрифта для текста подписи. **kwargs : Ключевые параметры для передачи в matplotlib.offsetbox.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_bar	(matplotlib.offsetbox.AuxTransformBox) Контейнер для линейки масштаба.
txt_label	(matplotlib.offsetbox.TextArea) Контейнер для подписи линейки масштаба.