mpl_toolkits.mplot3d.axes3d.Axes3D.fill_between
- Axes3D.fill_between(x1, y1, z1, x2, y2, z2, *, where=None, mode='auto', facecolors=None, shade=None, axlim_clip=False, **kwargs)[исходный код]
-
Заполняет область между двумя трёхмерными кривыми.
Кривые задаются точками (x1, y1, z1) и (x2, y2, z2). Создаётся один или несколько четырёхугольных многоугольников с заливкой. Все точки должны иметь одинаковую длину N либо быть одним значением, используемым для всех точек.
- Параметры:
-
- x1, y1, z1float или одномерный массивоподобный объект
-
Координаты x, y и z вершин первой линии.
- x2, y2, z2float или одномерный массивоподобный объект
-
Координаты x, y и z вершин второй линии.
- whereмассив логических значений (длина N), необязательный
-
Определяет, где исключить некоторые области из заливки. Заполненные области задаются координатами
pts[where]для всех точек x, y и z. Точнее, заливка выполняется междуpts[i]иpts[i+1], еслиwhere[i] and where[i+1]. Обратите внимание: согласно этому определению, отдельное значение True между двумя значениями False в where не приведёт к заливке. Обе стороны позиции со значением True останутся незаполненными из-за соседних значений False. - mode{'quad', 'polygon', 'auto'}, по умолчанию: 'auto'
-
Режим заливки. Возможные варианты:
- 'quad': для каждой пары последовательных точек двух линий создаётся отдельный четырёхугольный многоугольник.
- 'polygon': две линии соединяются, образуя один многоугольник. Это быстрее и может обеспечить более качественный рендеринг простых фигур (например, при заливке между двумя линиями, лежащими в одной плоскости).
- 'auto': если все точки лежат в одной плоскости в 3D, используется 'polygon'. В противном случае используется 'quad'.
- facecolorsсписок цветов, по умолчанию: None
-
Цвета отдельных графических объектов или один цвет для всех объектов.
- shadebool, по умолчанию: None
-
Затенять ли цвета граней. Если None, по умолчанию используется True для режима 'quad' и False для режима 'polygon'.
- axlim_clipbool, по умолчанию: False
-
Скрывать ли данные, расположенные за пределами видимых границ осей.
Добавлено в версии 3.10.
- **kwargs
-
Все остальные именованные аргументы передаются в
Poly3DCollection.
- Возвращает:
-
Poly3DCollection-
Poly3DCollection, содержащий построенные многоугольники.
Примеры использования mpl_toolkits.mplot3d.axes3d.Axes3D.fill_between
© 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.fill_between.html