matplotlib.axes.Axes.apply_aspect

Axes.apply_aspect(position=None)[исходный код]

Настроить Axes для заданного соотношения сторон данных.

В зависимости от get_adjustable будет изменена либо рамка Axes (позиция), либо пределы просмотра. В первом случае на позицию будет влиять get_anchor.

Параметры:

positionNone или .Bbox

Примечание

Этот параметр сохранён по историческим причинам и считается внутренним. Конечным пользователям не следует его использовать.

Если не None, этот параметр задаёт позицию Axes в пределах фигуры в виде Bbox. Дополнительные сведения см. в разделе get_position.

См. также

matplotlib.axes.Axes.set_aspect

Описание обработки соотношения сторон.

matplotlib.axes.Axes.set_adjustable

Задать способ настройки Axes для достижения требуемого соотношения сторон.

matplotlib.axes.Axes.set_anchor

Задать позицию в случае наличия свободного пространства.

matplotlib.figure.Figure.draw_without_rendering

Обновить все устаревшие компоненты фигуры.

Примечания

Этот метод автоматически вызывается при отрисовке каждой Axes. Возможно, его потребуется вызвать самостоятельно, если нужно обновить позицию Axes и/или пределы просмотра до отрисовки Figure.

Альтернативой с более широкой областью действия является Figure.draw_without_rendering, которая обновляет все устаревшие компоненты фигуры, а не только позицию и пределы просмотра одной Axes.

Примеры

Типичный пример использования приведён ниже. imshow устанавливает соотношение сторон, равное 1, но настройка позиции и размеров Axes с учётом этого откладывается до этапа отрисовки из соображений производительности. Если размер Axes нужен заранее, следует вызвать apply_aspect, чтобы получить корректные значения.

>>> fig, ax = plt.subplots()
>>> ax.imshow(np.zeros((3, 3)))
>>> ax.bbox.width, ax.bbox.height
(496.0, 369.59999999999997)
>>> ax.apply_aspect()
>>> ax.bbox.width, ax.bbox.height
(369.59999999999997, 369.59999999999997)