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=3)

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

Параметры:

parent_axes : matplotlib.axes.Axes Ось, в которую нужно поместить вставную ось. width, height : float or str Размер создаваемой вставной оси. Если указано число, это размер в дюймах, например, width=1.3. Если указана строка, это размер в относительных единицах, например, width='40%'. По умолчанию, если не указаны bbox_to_anchor или bbox_transform, значения относятся к parent_axes. В противном случае они относятся к области, указанной через bbox_to_anchor. loc : int or string, optional, default to 1 Расположение вставной оси. Допустимые расположения: '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 bbox_to_anchor : tuple or matplotlib.transforms.BboxBase, optional Прямоугольник, к которому будет привязана вставная ось. Если 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 в относительных единицах, кортеж [left, bottom] использовать нельзя. Обратите внимание, что, если bbox_transform не задан, единицы прямоугольника интерпретируются в координатах пикселей. При использовании bbox_to_anchor с кортежем, почти всегда имеет смысл также указать bbox_transform. Часто это трансформация оси parent_axes.transAxes. bbox_transform : matplotlib.transforms.Transform, optional Преобразование для прямоугольника, содержащего вставную ось. Если None, используется transforms.IdentityTransform. Значение bbox_to_anchor (или возвращаемое значение его метода get_points) преобразуется с помощью bbox_transform и затем интерпретируется как точки в координатах пикселей (зависит от dpi). Вы можете предоставить bbox_to_anchor в некоторых нормализованных координатах и указать соответствующую трансформацию (например, parent_axes.transAxes). axes_class : matplotlib.axes.Axes type, optional Если указано, созданная вставная ось будет создана с помощью конструктора этого класса. axes_kwargs : dict, optional Аргументы ключевых слов для передачи в конструктор вставной оси. Допустимые аргументы включают:

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

yscale {"линейный", "логарифмический", "симлогический", "логит", ...} yticklabels Список[строка] yticks список zorder вещественное число borderpad : float, optional Отступ между вставленным графиком и bbox_to_anchor. По умолчанию 0,5. Единицы - размер шрифта графика, т.е. для стандартного размера шрифта 10 пунктов borderpad = 0.5 эквивалентен отступу в 5 пунктов.
Возвращает:	inset_axes : axes_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

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

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

Демонстрация Inset Locator

Обзор инструментария axes_grid1