mpl_toolkits.mplot3d.axes3d.Axes3D.plot_surface
- Axes3D.plot_surface(X, Y, Z, *, norm=None, vmin=None, vmax=None, lightsource=None, axlim_clip=False, **kwargs)[source]
-
Создаёт график поверхности.
По умолчанию поверхность будет окрашена в оттенки одного цвета, но также поддерживается применение цветовой карты с помощью аргумента cmap.
Примечание
Именованные аргументы rcount и ccount, значения которых по умолчанию равны 50, задают максимальное количество отсчётов в каждом направлении. Если входные данные больше, они будут прорежены (с помощью срезов) до указанного количества точек.
Примечание
Чтобы максимально увеличить скорость отрисовки, задайте для rstride и cstride значения, являющиеся делителями количества строк минус 1 и количества столбцов минус 1 соответственно. Например, для 51 строки значением rstride может быть любой делитель числа 50.
Аналогично, при значениях rstride и cstride, равных 1 (или rcount и ccount, равных количеству строк и столбцов), можно использовать оптимизированный путь.
- Параметры:
-
- X, Y, Z2D-массивы
-
Значения данных.
- rcount, ccountint
-
Максимальное количество отсчётов в каждом направлении. Если входные данные больше, они будут прорежены (с помощью срезов) до указанного количества точек. По умолчанию — 50.
- rstride, cstrideint
-
Шаг прореживания в каждом направлении. Эти аргументы нельзя использовать вместе с rcount и ccount. Если задано только одно из значений rstride или cstride, для другого по умолчанию используется значение 10.
В режиме 'classic' используется значение по умолчанию
rstride = cstride = 10вместо нового значения по умолчаниюrcount = ccount = 50. - colorцвет
-
Цвет полигонов поверхности.
- cmapЦветовая карта, необязательный параметр
-
Цветовая карта полигонов поверхности.
- facecolorsсписок значений цвета
-
Цвета отдельных полигонов.
-
norm
Normalize, необязательный параметр -
Нормализация для цветовой карты.
- vmin, vmaxfloat, необязательный параметр
-
Границы нормализации.
- shadebool, по умолчанию: True
-
Определяет, следует ли затенять цвета граней. Если задан cmap, затенение всегда отключено.
-
lightsource
LightSource, необязательный параметр -
Источник света, используемый, если shade равен True.
- axlim_clipbool, по умолчанию: False
-
Определяет, следует ли скрывать полигоны, у которых вершина находится за пределами области отображения осей.
Добавлено в версии 3.10.
- **kwargs
-
Другие именованные аргументы передаются в
Poly3DCollection.
Примеры использования mpl_toolkits.mplot3d.axes3d.Axes3D.plot_surface
Пользовательское затенение рельефа на графике 3D-поверхности
© 2012–2026 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.plot_surface.html