matplotlib.axes.Axes.tricontourf
-
Axes.tricontourf(ax, *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)
Используйте ключевые аргументы для управления цветами, толщиной линии, началом координат, палитрой… см. ниже для получения дополнительной информации.
Параметры: -
triangulationTriangulation, optional -
Неупорядоченная треугольная сетка.
Если указано, то x, y, triangles и mask не принимаются.
-
x, yarray-like, optional -
Координаты значений в Z.
-
trianglesint array-like of shape (ntri, 3), optional -
Для каждого треугольника индексы трех точек, образующих треугольник, упорядоченные против часовой стрелки. Если не указано, вычисляется треугольная сетка Делоне.
-
maskbool array-like of shape (ntri), optional -
Какие треугольники скрыты.
-
Zarray-like(N, M) -
Значения высот, по которым отображается контур.
-
levelsint or array-like, optional -
Определяет количество и положение линий/областей контура.
Если целое число n, используется
MaxNLocator, который пытается автоматически выбрать не более n+1 «приятных» уровней контура между vmin и vmax.Если массив, рисует линии контура на заданных уровнях. Значения должны быть в порядке возрастания.
Возвращает: Другие параметры: -
colorscolor string or sequence of colors, optional -
Цвета уровней, то есть областей контура.
Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется.
В качестве сокращения можно использовать одиночные строковые значения цвета вместо одноэлементных списков, т.е.
'red'вместо['red']для окраски всех уровней одним цветом. Это сокращение работает только для строковых значений цвета, а не для других способов задания цвета.По умолчанию (значение None) используется цветовая карта, заданная параметром cmap.
-
alphafloat, default: 1 -
Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный).
-
cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis') -
Экземпляр
Colormapили зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровней с цветами.Если заданы как colors, так и cmap, возникает ошибка.
-
normNormalize, optional -
Если используется цветовая карта, экземпляр
Normalizeмасштабирует значения уровней до канонического диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не задано, используется линейное масштабирование по умолчанию. -
origin{None, 'upper', 'lower', 'image'}, default: None -
Определяет ориентацию и точное положение Z, указав положение
Z[0, 0]. Это актуально только если X, Y не заданы.-
None:
Z[0, 0]находится в левом нижнем углу при X=0, Y=0. - 'lower':
Z[0, 0]находится в левом нижнем углу при X=0.5, Y=0.5. - 'upper':
Z[0, 0]находится в левом верхнем углу при X=N+0.5, Y=0.5. - 'image': Используйте значение из
rcParams["image.origin"](по умолчанию:'upper').
-
None:
-
extent(x0, x1, y0, y1), optional -
Если origin не равно None, то extent интерпретируется как в
imshow: он задает внешние границы пикселей. В этом случае положение Z[0, 0] — центр пикселя, а не угол. Если origin равно None, то (x0, y0) — положение Z[0, 0], а (x1, y1) — положение Z[-1, -1].Этот аргумент игнорируется, если X и Y указаны в вызове contour.
-
locatorticker.Locator subclass, optional -
Локатор используется для определения уровней контура, если они не заданы явно через levels. По умолчанию
MaxNLocator. -
extend{'neither', 'both', 'min', 'max'}, default: 'neither' -
Определяет
tricontourfокраску значений, которые находятся за пределами диапазона levels.Если 'neither', значения вне диапазона levels не окрашиваются. Если 'min', 'max' или 'both', окрашиваются значения ниже, выше или ниже и выше диапазона levels.
Значения ниже
min(levels)и вышеmax(levels)отображаются на значения под/над цветовой картойColormap. Обратите внимание, что большинство цветовых карт по умолчанию не имеют выделенных цветов для этих значений, поэтому значения выше и ниже — крайние значения цветовой карты. Возможно, вам нужно явно установить эти значения, используяColormap.set_underиColormap.set_over.Примечание
Существующий
TriContourSetне уведомляется, если свойства его цветовой карты изменены. Поэтому необходимо явно вызватьContourSet.changed()после изменения цветовой карты. Явный вызов можно пропустить, если цветовая шкала назначенаTriContourSet, так как она в этом случае неявно вызываетContourSet.changed(). -
xunits, yunitsregistered units, optional -
Переопределение единиц осей путем указания экземпляра
matplotlib.units.ConversionInterface. -
antialiasedbool, default: True -
Использовать ли сглаживание?
Примечания
tricontourfзаполняет интервалы, которые закрыты сверху; то есть для границ z1 и z2 заполненная область:z1 < Z <= z2
за исключением самого нижнего интервала, который закрыт с обеих сторон (т.е. включает и наименьшее значение).
-
Примеры использования matplotlib.axes.Axes.tricontourf
END_OF_DOCUMENT_MARKER
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/_as_gen/matplotlib.axes.Axes.tricontourf.html