matplotlib.pyplot.tricontourf
-
matplotlib.pyplot.tricontourf(*args, **kwargs)[source] -
Отображение областей контуров на неструктурированной треугольной сетке.
Треугольную сетку можно задать двумя способами; либо
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.pyplot.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.pyplot.tricontourf.html