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, default: 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'} или число autoscale_on bool autoscalex_on bool autoscaley_on bool axes_locator Callable[[Axes, Renderer], Bbox] axisbelow bool или 'line' box_aspect None или число 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 или вызываемый объект position [left, bottom, width, height] или Bbox prop_cycle неизвестно rasterization_zorder число с плавающей точкой или None rasterized bool или None sketch_params (scale: float, length: float, randomness: float) snap bool или None title строка transform Transform url строка visible bool xbound неизвестно xlabel строка xlim (нижняя: float, верхняя: float) xmargin число, большее, чем -0,5 xscale {"линейный", "логарифмический", "симлогический", "логит", ...} xticklabels неизвестно xticks неизвестно ybound неизвестно ylabel строка ylim (нижняя: float, верхняя: float) ymargin число, большее, чем -0,5

yscale {"линейный", "логарифмический", "симлогический", "логит", ...} 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

Демонстрация полосы цвета вставленной оси

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

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

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