matplotlib.pyplot.tricontourf

matplotlib.pyplot.tricontourf(*args, **kwargs)[source]

Отображение областей контуров на неструктурированной треугольной сетке.

Вызовы функций:

tricontourf(triangulation, z, [levels], ...)
tricontourf(x, y, z, [levels], *, [triangles=triangles], [mask=mask], ...)

Треугольную сетку можно указать, передав объект Triangulation в качестве первого параметра или передав точки x, y и, необязательно, triangles и mask. См. Triangulation для объяснения этих параметров. Если ни triangulation, ни triangles не заданы, триангуляция вычисляется на лету.

Можно передать triangles позиционно, т.е. tricontourf(x, y, triangles, z, ...). Однако это не рекомендуется. Для большей ясности передавайте triangles в качестве именованного аргумента.

Параметры:

triangulationTriangulation, необязательно

Уже созданная треугольная сетка.

x, y, triangles, mask

Параметры, определяющие треугольную сетку. См. Triangulation. Это взаимно исключающие параметры с указанием triangulation.

zподобный массиву

Значения высоты, по которым строится контур. Отображение цветов контролируется параметрами cmap, norm, vmin и vmax.

Примечание

Все значения в z должны быть конечными. Следовательно, значения nan и inf должны быть удалены или использовать set_mask.

levelsцелое число или подобный массиву, необязательно

Определяет количество и позиции линий/областей контура.

Если целое число n, используйте MaxNLocator, который пытается автоматически выбрать не более n+1 «хороших» уровней контура между минимальным и максимальным числовыми значениями Z.

Если подобный массиву, рисует линии контура на указанных уровнях. Значения должны быть отсортированы по возрастанию.

Возвращаемое значение:

TriContourSet

Дополнительные параметры:

colorsстрока цвета или последовательность цветов, необязательно

Цвета уровней, т.е. областей контура.

Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется.

В качестве сокращения можно использовать отдельные строки цвета вместо списков с одним элементом, т.е. 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строк цвета, а не для других способов задания цвета.

По умолчанию (значение None) используется цветовая карта, указанная в cmap.

alphaвещественное число, по умолчанию: 1

Значение смешивания альфа-канала, от 0 (прозрачный) до 1 (непрозрачный).

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Экземпляр цветовой карты или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.

Этот параметр игнорируется, если задан colors.

normстрока или Normalize, необязательно

Метод нормализации, используемый для масштабирования скалярных данных до диапазона [0, 1] перед отображением цветов с помощью cmap. По умолчанию используется линейное масштабирование, отображающее наименьшее значение в 0, а наибольшее в 1.

Если задано, может быть одним из следующих:

• Экземпляр Normalize или его подкласса (см. Нормализация цветовых карт).
• Имя масштаба, например, «линейный», «логарифмический», «симлогический», «логитический» и т.д. Список доступных масштабов можно получить, вызвав matplotlib.scale.get_scale_names(). В этом случае подходящий подкласс Normalize динамически генерируется и создается.

Этот параметр игнорируется, если задан colors.

vmin, vmaxвещественное число, необязательно

При использовании скалярных данных без явного norm, vmin и vmax определяют диапазон данных, который охватывает цветовая карта. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. Использование vmin/vmax с экземпляром norm недопустимо (но использование имени norm типа str вместе с vmin/vmax допустимо).

Если vmin или vmax не заданы, масштабирование цветов по умолчанию основано на levels.

Этот параметр игнорируется, если задан colors.

origin{None, 'upper', 'lower', 'image'}, по умолчанию: 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').

extent(x0, x1, y0, y1), необязательно

Если origin не None, то extent интерпретируется как в imshow: он задаёт внешние границы пикселей. В этом случае положение z[0, 0] находится в центре пикселя, а не в углу. Если origin равно None, то (x0, y0) – это положение z[0, 0], а (x1, y1) – положение z[-1, -1].

Этот аргумент игнорируется, если X и Y указаны в вызове contour.

locatorподкласс ticker.Locator, необязательно

Используется для определения уровней контура, если они не заданы явно через levels. По умолчанию MaxNLocator.

extend{'neither', 'both', 'min', 'max'}, по умолчанию: '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, yunitsзарегистрированные единицы, необязательно

Переопределить единицы осей, указав экземпляр matplotlib.units.ConversionInterface.

antialiasedbool, необязательно

Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию True. Для линейных контуров оно берется из rcParams["lines.antialiased"] (по умолчанию: True).

hatchesсписок[строка], необязательно

Список штрихов для использования на заполненных областях. Если None, штриховка не добавляется к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg.

Примечания

tricontourf заполняет интервалы, которые закрыты сверху; то есть, для границ z1 и z2, заполненная область:

z1 < Z <= z2

кроме самого нижнего интервала, который закрыт с обеих сторон (т.е. он включает минимальное значение).

Примеры использования matplotlib.pyplot.tricontourf

Контурный график неравномерно распределенных данных

Контурный график неравномерно распределенных данных

Демонстрация tricontour

Демонстрация tricontour

Tricontour плавный Делоне

Tricontour плавный Делоне

Tricontour плавный пользовательский

Tricontour плавный пользовательский

Демонстрация triinterp

Демонстрация triinterp