mpl_toolkits.axisartist.axislines.Axes

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

Bases: Axes

Построение осей в окне фигуры.

Параметры:

figFigure

Оси строятся в Figure fig.

*args

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

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

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

Оси x или y совмещаются с осями x или y в входном Axes. Обратите внимание, что отключить совместное использование осей невозможно.

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

Определяет, отображается ли рамка осей.

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

Устанавливает фиксированное соотношение сторон для области осей, т. е. отношение высоты к ширине. Подробнее см. set_box_aspect.

forward_navigation_eventsbool или "auto", по умолчанию: "auto"

Управление тем, передаются ли события масштабирования/перемещения осей под данной осью. "auto" — True для осей с невидимым прямоугольником и False в противном случае.

**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`
`forward_navigation_events`	логическое значение или "auto"
`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`	(нижняя граница: число, верхняя граница: число)
`ylabel`	строка
`ylim`	(нижняя граница: число, верхняя граница: число)
`ymargin`	число больше -0.5
`yscale`	неизвестно
`yticklabels`	неизвестно
`yticks`	неизвестно
`zorder`	число

Возвращаемое значение:

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, ymaxчисло, необязательно

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

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

optionbool или строка

Если 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, ymaxчисло: Пределы оси.

См. также

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>, forward_navigation_events=<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`	функция фильтра, которая принимает массив чисел с плавающей точкой (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`
`forward_navigation_events`	логическое значение или "auto"
`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`	(нижняя граница: число, верхняя граница: число)
`ylabel`	строка
`ylim`	(нижняя граница: число, верхняя граница: число)
`ymargin`	число, больше чем -0,5
`yscale`	неизвестно
`yticklabels`	неизвестно
`yticks`	неизвестно
`zorder`	число