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

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

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кортеж или matplotlib.transforms.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_transformmatplotlib.transforms.Transform, необязательно

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

axes_classmatplotlib.axes.Axes тип, по умолчанию: HostAxes

Тип вновь созданных встроенных осей.

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

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

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

ylim	(нижняя граница: число, верхняя граница: число)
ymargin	число больше -0,5
yscale	{"линейная", "логарифмическая", "симметричная логарифмическая", "логит", ...} или ScaleBase
yticklabels	неизвестно
yticks	неизвестно
zorder	число

borderpadfloat, default: 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 (по умолчанию — тождественное преобразование) и затем интерпретируется как точка в пиксельных координатах (что зависит от dpi).

Таким образом, следующие три вызова идентичны и создают вставленный график относительно 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