matplotlib.axes.Axes.tricontourf
-
Axes.tricontourf(*args, **kwargs) -
Отображение областей контуров на неструктурированной треугольной сетке.
Треугольная сетка может быть задана двумя способами; либо
tricontourf(triangulation, ...)
где triangulation — объект
Triangulation, илиtricontourf(x, y, ...) tricontourf(x, y, triangles, ...) tricontourf(x, y, triangles=triangles, ...) tricontourf(x, y, mask=mask, ...) tricontourf(x, y, triangles, mask=mask, ...)
в этом случае будет создан объект
Triangulation. См. строку документации этого класса для объяснения этих случаев.Остальные аргументы могут быть:
tricontourf(..., Z)
где Z — массив значений для контура, по одному значению на точку в треугольной сетке. Значения уровней выбираются автоматически.
tricontourf(..., Z, levels)
контур до levels+1 автоматически выбранных уровней контура (levels интервалов).
tricontourf(..., Z, levels)
построение областей контура в значениях, указанных в последовательности levels, которая должна быть в возрастающем порядке.
tricontourf(Z, **kwargs)
Используйте ключевые аргументы для управления цветами, шириной линий, началом, cmap и т. д. — см. подробности ниже.
Параметры: -
triangulation
Triangulation, необязательно -
Неструктурированная треугольная сетка.
Если указано, то x, y, triangles и mask не принимаются.
- x, yмассив, необязательно
-
Координаты значений в Z.
- triangles(ntri, 3) массив целых чисел, необязательно
-
Для каждого треугольника индексы трёх точек, образующих треугольник, упорядоченные против часовой стрелки. Если не указано, вычисляется триангуляция Делоне.
- mask(ntri,) массив булевых значений, необязательно
-
Какие треугольники маскируются.
- Z2D массив
-
Значения высоты, по которым строится контур.
- levelsцелое число или массив, необязательно
-
Определяет количество и позиции линий/областей контура.
Если целое число n, используйте
MaxNLocator, который пытается автоматически выбрать не более n+1 «хороших» уровней контура между vmin и vmax.Если массив, строятся линии контура на заданных уровнях. Значения должны быть в возрастающем порядке.
Возвращает: Другие параметры: - colorsстрока цвета или последовательность цветов, необязательно
-
Цвета уровней, то есть областей контура.
Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем число уровней, она повторяется.
В качестве сокращения могут использоваться отдельные строки цвета вместо списков с одним элементом, например
'red'вместо['red']для раскраски всех уровней одним цветом. Это сокращение работает только для строк цвета, а не для других способов указания цветов.По умолчанию (значение None) используется цветовая карта, заданная cmap.
- alphaчисло, по умолчанию: 1
- Значение прозрачности смешивания альфа-канала, от 0 (прозрачный) до 1 (непрозрачный).
-
cmapстрока или
Colormap, по умолчанию:rcParams["image.cmap"](по умолчанию:'viridis') - Экземпляр
Colormapили зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровня цветам. -
norm
Normalize, необязательно - Если используется цветовая карта, экземпляр
Normalizeмасштабирует значения уровня до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не указано, используется стандартное линейное масштабирование. - vmin, vmaxчисло, необязательно
- Если не None, эти значения будут переданы экземпляру
Normalize, переопределяя стандартное масштабирование цвета, основанное на levels. - origin{None, 'upper', 'lower', 'image'}, по умолчанию: None
- Определяет ориентацию и точное положение Z, задавая положение
Z[0, 0]. Это актуально только если X, Y не заданы. - extent(x0, x1, y0, y1), необязательно
- Если origin не None, то extent интерпретируется как в
imshow: он задаёт внешние пиксельные границы. В этом случае положение Z[0, 0] — центр пикселя, а не угол. - locatorподкласс ticker.Locator, необязательно
- Locator используется для определения уровней контура, если они не заданы явно через levels. По умолчанию
MaxNLocator. - extend{'neither', 'both', 'min', 'max'}, по умолчанию: 'neither'
- Определяет окраску значений, которые находятся за пределами диапазона levels.
- xunits, yunitsзарегистрированные единицы, необязательно
- Переопределяет единицы осей, указывая экземпляр
matplotlib.units.ConversionInterface. - antialiasedbool, необязательно
- Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для контуров линий оно берется из
rcParams["lines.antialiased"](по умолчанию:True). - hatchesсписок[str], необязательно
- Список штриховых паттернов для использования на заполненных областях. Если None, к контуру не будет добавлено штриховки. Штриховка поддерживается только в PostScript, PDF, SVG и Agg backends.
Замечания
tricontourfзаполняет интервалы, которые закрыты сверху; то есть, для границ z1 и z2 заполненная область:z1 < Z <= z2
кроме нижнего интервала, который закрыт с обеих сторон (т. е. включает минимальное значение).
-
triangulation
Примеры использования matplotlib.axes.Axes.tricontourf
© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.3/api/_as_gen/matplotlib.axes.Axes.tricontourf.html