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_axesmatplotlib.axes.Axes Ось для размещения вставной оси. width, heightfloat or str Размер вставной оси для создания. Если предоставлено число с плавающей точкой, это размер в дюймах, например, width=1.3. Если предоставлена строка, это размер в относительных единицах, например, width='40%'. По умолчанию, то есть если не указаны bbox_to_anchor или bbox_transform, они относительны к parent_axes. В противном случае они интерпретируются относительно рамки, заданной через bbox_to_anchor. locint or str, 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_anchortuple 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 заданы в относительных единицах, 2-кортеж [left, bottom] использовать нельзя. Обратите внимание, что, если не задан bbox_transform, единицы рамки интерпретируются в координатах пикселей. При использовании bbox_to_anchor с кортежем, почти всегда имеет смысл также указать bbox_transform. Часто это преобразование осей parent_axes.transAxes. bbox_transformmatplotlib.transforms.Transform, optional Преобразование для рамки, содержащей вставную ось. Если None, используется transforms.IdentityTransform. Значение bbox_to_anchor (или возвращаемое значение метода get_points) преобразуется с помощью bbox_transform и затем интерпретируется как точки в координатах пикселей (зависимых от dpi). Вы можете указать bbox_to_anchor в каких-либо нормализованных координатах и задать соответствующее преобразование (например, parent_axes.transAxes). axes_classmatplotlib.axes.Axes type, optional Если указано, вставная ось будет создана с помощью конструктора данного класса. axes_kwargsdict, optional

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

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

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

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

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

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