mpl_toolkits.axes_grid1.inset_locator.inset_axes

mpl_toolkits.axes_grid1.inset_locator.inset_axes(parent_axes, width, height, loc='upper right', bbox_to_anchor=None, bbox_transform=None, axes_class=None, axes_kwargs=None, borderpad=0.5) [source]

Создаёт вставную ось с заданной шириной и высотой.

Оба размера могут быть указаны в дюймах или процентах. Например:

inset_axes(parent_axes, width='40%', height='30%', loc='lower left')

создаёт вставную ось в нижнем левом углу parent_axes, занимающую 30% высоты и 40% ширины parent_axes. Поскольку использование inset_axes может стать немного сложным при выходе за пределы таких стандартных случаев, рекомендуется ознакомиться с примерами.

Параметры:

parent_axesmatplotlib.axes.Axes

Ось, на которой будет расположена вставная ось.

width, heightfloat или str

Размер вставной оси. Если float, то размер в дюймах, например, width=1.3. Если строка, то размер в относительных единицах, например, width='40%'. По умолчанию, если не указаны bbox_to_anchor или bbox_transform, они относятся к parent_axes. В противном случае они относятся к заданной области.

locstr, по умолчанию: 'upper right'

Расположение вставной оси. Допустимые значения: 'upper left', 'upper center', 'upper right', 'center left', 'center', 'center right', 'lower left', 'lower center', 'lower right'. Для обратной совместимости принимаются и числовые значения. Подробности см. в параметре loc Legend.

bbox_to_anchorкортеж или BboxBase, необязательно

Прямоугольная область, к которой будет привязана вставная ось. Если None, используется кортеж (0, 0, 1, 1), если bbox_transform установлен на parent_axes.transAxes или parent_axes.figure.transFigure. В противном случае используется parent_axes.bbox. Если кортеж, может быть [left, bottom, width, height] или [left, bottom]. Если параметры width и/или height заданы в относительных единицах, 2-кортеж [left, bottom] использовать нельзя. Обратите внимание, что, если bbox_transform не установлен, единицы прямоугольной области интерпретируются в координатах пикселей. При использовании bbox_to_anchor с кортежем, почти всегда имеет смысл также указать bbox_transform. Это часто может быть преобразование осей parent_axes.transAxes.

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

Преобразование для прямоугольной области, содержащей вставную ось. Если None, используется transforms.IdentityTransform. Значение bbox_to_anchor (или возвращаемое значение его метода get_points) преобразуется с помощью bbox_transform и затем интерпретируется как точки в координатах пикселей (зависит от dpi). Можно указать bbox_to_anchor в каких-либо нормированных координатах и задать соответствующее преобразование (например, parent_axes.transAxes).

axes_classAxes тип, по умолчанию: HostAxes

Тип вновь созданной вставной оси.

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

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

Свойство	Описание
adjustable	{'box', 'datalim'}
agg_filter	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
anchor	(число, число) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	логическое значение
aspect	{'auto', 'equal'} или число
autoscale_on	логическое значение
autoscalex_on	неизвестно
autoscaley_on	неизвестно
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	логическое значение или 'line'
box_aspect	число или None
clip_box	Bbox
clip_on	логическое значение
clip_path	Объект Patch или (Путь, Преобразование) или None
facecolor или fc	цвет
figure	Figure
frame_on	логическое значение
gid	строка
in_layout	логическое значение
label	объект
mouseover	логическое значение
navigate	логическое значение
navigate_mode	неизвестно
path_effects	AbstractPathEffect
picker	None или логическое значение или число с плавающей точкой или вызываемый объект
position	[левое, нижнее, ширина, высота] или Bbox
prop_cycle	неизвестно
rasterization_zorder	число с плавающей точкой или None
rasterized	логическое значение
sketch_params	(масштаб: число, длина: число, случайность: число)
snap	логическое значение или None
subplotspec	неизвестно
title	строка
transform	Transform
url	строка
visible	логическое значение
xbound	неизвестно
xlabel	строка
xlim	(нижняя граница: число, верхняя граница: число)
xmargin	число, большее -0,5
xscale	неизвестно
xticklabels	неизвестно
xticks	неизвестно
ybound	неизвестно

ylabel	str
ylim	(bottom: float, top: float)
ymargin	число, большее -0,5
yscale	неизвестно
yticklabels	неизвестно
yticks	неизвестно
zorder	число с плавающей точкой

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

Отступ между вставленными осями и bbox_to_anchor. Единицы — размер шрифта осей, т.е. для стандартного размера шрифта 10 пунктов borderpad = 0.5 эквивалентно отступу в 5 пунктов.

Возвращает:

inset_axesaxes_class

Созданный объект вставленных осей.

Примечания

Значение bbox_to_anchor и bbox_to_transform интерпретируется иначе, чем в случае с легендами. Значение bbox_to_anchor (или значение, возвращаемое методом get_points; по умолчанию — parent_axes.bbox) преобразуется с помощью bbox_transform (по умолчанию — тождественное преобразование) и затем интерпретируется как точка в пиксельных координатах (которые зависят от разрешения).

Таким образом, следующие три вызова идентичны и создают вставленные оси относительно parent_axes:

axins = inset_axes(parent_axes, "30%", "40%")
axins = inset_axes(parent_axes, "30%", "40%",
                   bbox_to_anchor=parent_axes.bbox)
axins = inset_axes(parent_axes, "30%", "40%",
                   bbox_to_anchor=(0, 0, 1, 1),
                   bbox_transform=parent_axes.transAxes)

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

Добавление цветовой шкалы к вставленным осям

Добавление цветовой шкалы к вставленным осям

Управление положением и размером цветовых шкал с помощью вставленных осей

Управление положением и размером цветовых шкал с помощью вставленных осей

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

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