mpl_toolkits.mplot3d.axes3d.Axes3D.apply_aspect

Axes3D.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.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)