mpl_toolkits.axisartist.axislines.Axes

classmpl_toolkits.axisartist.axislines.Axes(*args, grid_helper=None, **kwargs)[source]

Bases: Axes

Создать Axes в figure.

Параметры:

figFigure

Axes создается в Figure fig.

*args

*args может быть единственным (left, bottom, width, height) прямоугольником или единственным Bbox. Это задаёт прямоугольник (в координатах figure) , где размещается Axes.

*args также может состоять из трёх чисел или одного трёхзначного числа; в последнем случае цифры рассматриваются как независимые числа. Числа интерпретируются как (nrows, ncols, index): (nrows, ncols) задаёт размер массива subplot, а index — 1-основанный индекс subplot, который создаётся. Наконец, *args также может быть напрямую SubplotSpec экземпляром.

sharex, shareyAxes, необязательно

Ось x или y делится с осью x или y в входном Axes.

frameonbool, по умолчанию: True

Отображать ли рамку Axes.

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

Задать фиксированный аспект для области Axes, т.е. отношение высоты к ширине. См. set_box_aspect для подробностей.

**kwargs

Другие необязательные ключевые аргументы:

Свойство	Описание
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	BboxBase или None
clip_on	булево значение
clip_path	Patch или (Path, Transform) или None
facecolor или fc	цвет
figure	Figure
frame_on	булево значение
gid	строка
in_layout	булево значение
label	объект
mouseover	булево значение
navigate	булево значение
navigate_mode	неизвестно
path_effects	список AbstractPathEffect
picker	None или булево значение или число с плавающей точкой или вызываемая функция
position	[слева, снизу, ширина, высота] или Bbox
prop_cycle	Cycler
rasterization_zorder	число с плавающей точкой или None
rasterized	булево значение
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	булево значение или None
subplotspec	неизвестно
title	строка
transform	Transform
url	строка
visible	булево значение
xbound	(нижняя: число с плавающей точкой, верхняя: число с плавающей точкой)
xlabel	строка
xlim	(левый: число с плавающей точкой, правый: число с плавающей точкой)
xmargin	число с плавающей точкой больше -0.5
xscale	неизвестно
xticklabels	неизвестно
xticks	неизвестно

ybound	(нижняя: float, верхняя: float)
ylabel	строка
ylim	(нижняя: float, верхняя: float)
ymargin	float больше -0.5
yscale	неизвестно
yticklabels	неизвестно
yticks	неизвестно
zorder	float

Возвращает:

Axes

Новый объект Axes.

__call__(*args, **kwargs)[source]

[Устарело]

Примечания

Устарело начиная с версии 3.8: Используйте ax.axis вместо этого.

свойствоaxis

Удобный метод для получения или установки некоторых свойств осей.

Варианты вызова:

xmin, xmax, ymin, ymax = axis()
xmin, xmax, ymin, ymax = axis([xmin, xmax, ymin, ymax])
xmin, xmax, ymin, ymax = axis(option)
xmin, xmax, ymin, ymax = axis(**kwargs)

Параметры:

xmin, xmax, ymin, ymaxfloat, необязательно

Пределы осей, которые нужно установить. Это также можно сделать с помощью

ax.set(xlim=(xmin, xmax), ylim=(ymin, ymax))

optionbool или str

Если bool, включает или выключает линии и метки осей. Если строка, возможные значения:

Значение	Описание
'off' или False	Скрывает все декорации осей, т.е. метки осей, линии, отметки, подписи меток и линии сетки. Это то же самое, что set_axis_off().
'on' или True	Не скрывает все декорации осей, т.е. метки осей, линии, отметки, подписи меток и линии сетки. Это то же самое, что set_axis_on().
'equal'	Устанавливает равномерное масштабирование (т.е., делает окружности круглыми), изменяя пределы осей. Это то же самое, что ax.set_aspect('equal', adjustable='datalim'). Явные пределы данных в этом случае могут не учитываться.
'scaled'	Устанавливает равномерное масштабирование (т.е., делает окружности круглыми), изменяя размеры области графика. Это то же самое, что ax.set_aspect('equal', adjustable='box', anchor='C'). Кроме того, дальнейшее автоматическое масштабирование будет отключено.
'tight'	Устанавливает пределы, достаточно большие для отображения всех данных, затем отключает дальнейшее автоматическое масштабирование.
'auto'	Автоматическое масштабирование (заполняет область графика данными).
'image'	'scaled' с пределами осей, равными пределам данных.
'square'	Квадратный график; аналогично 'scaled', но изначально принудительно устанавливает xmax-xmin == ymax-ymin.

emitbool, по умолчанию: True

Указывает, уведомляются ли наблюдатели об изменении пределов осей. Этот параметр передается в set_xlim и set_ylim.

Возвращает:

xmin, xmax, ymin, ymaxfloat

Пределы осей.

См. также

matplotlib.axes.Axes.set_xlim

matplotlib.axes.Axes.set_ylim

Примечания

Для 3D осей этот метод дополнительно принимает zmin, zmax в качестве параметров и аналогичным образом возвращает их.

clear()[source]

Очистить область Axes.

get_children()[source]

Возвращает список дочерних элементов Artist этого объекта Artist.

get_grid_helper()[source]

grid(visible=None, which='major', axis='both', **kwargs)[source]

Включает или отключает линии сетки и, необязательно, настраивает свойства линий.

new_fixed_axis(loc, offset=None)[source]

new_floating_axis(nth_coord, value, axis_direction='bottom')[source]

set(*, adjustable=<UNSET>, agg_filter=<UNSET>, alpha=<UNSET>, anchor=<UNSET>, animated=<UNSET>, aspect=<UNSET>, autoscale_on=<UNSET>, autoscalex_on=<UNSET>, autoscaley_on=<UNSET>, axes_locator=<UNSET>, axisbelow=<UNSET>, box_aspect=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, facecolor=<UNSET>, frame_on=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, navigate=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, position=<UNSET>, prop_cycle=<UNSET>, rasterization_zorder=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, subplotspec=<UNSET>, title=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, xbound=<UNSET>, xlabel=<UNSET>, xlim=<UNSET>, xmargin=<UNSET>, xscale=<UNSET>, xticklabels=<UNSET>, xticks=<UNSET>, ybound=<UNSET>, ylabel=<UNSET>, ylim=<UNSET>, ymargin=<UNSET>, yscale=<UNSET>, yticklabels=<UNSET>, yticks=<UNSET>, zorder=<UNSET>)[source]

Устанавливает сразу несколько свойств.

Поддерживаются следующие свойства

Свойство	Описание
adjustable	{'box', 'datalim'}
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (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	неизвестно
autoscaley_on	неизвестно
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	bool или 'line'
box_aspect	float или None
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
facecolor или fc	цвет
figure	Figure
frame_on	bool
gid	строка
in_layout	bool
label	объект
mouseover	bool
navigate	bool
navigate_mode	неизвестно
path_effects	список AbstractPathEffect
picker	None или bool или float или вызываемый объект
position	[left, bottom, width, height] или Bbox
prop_cycle	Cycler
rasterization_zorder	float или None
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
subplotspec	неизвестно
title	строка
transform	Transform
url	строка
visible	bool
xbound	(lower: float, upper: float)
xlabel	строка
xlim	(left: float, right: float)
xmargin	float больше -0.5
xscale	неизвестно
xticklabels	неизвестно
xticks	неизвестно

ybound	(нижняя граница: float, верхняя граница: float)
ylabel	строка
ylim	(нижняя граница: float, верхняя граница: float)
ymargin	вещественное число больше -0.5
yscale	неизвестно
yticklabels	неизвестно
yticks	неизвестно
zorder	вещественное число

toggle_axisline(b=None)[source]