matplotlib.pyplot.tricontourf

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

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

tricontour и tricontourf соответственно рисуют линии контура и заполненные контуры. За исключением указанного, сигнатуры функций и возвращаемые значения одинаковы для обоих версий.

Треугольная сетка может быть задана двумя способами; либо

tricontour(triangulation, ...)

где triangulation — объект matplotlib.tri.Triangulation, или

tricontour(x, y, ...)
tricontour(x, y, triangles, ...)
tricontour(x, y, triangles=triangles, ...)
tricontour(x, y, mask=mask, ...)
tricontour(x, y, triangles, mask=mask, ...)

в этом случае будет создан объект Triangulation. См. строку документации этого класса для объяснения этих случаев.

Остальные аргументы могут быть:

tricontour(..., Z)

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

tricontour(..., Z, N)

построение до N+1 автоматически выбранных уровней контура (N интервалов).

tricontour(..., Z, V)

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

tricontourf(..., Z, V)

заполнение (len(V)-1) областей между значениями в V, которые должны быть упорядочены по возрастанию.

tricontour(Z, **kwargs)

Используйте ключевые аргументы для управления цветами, шириной линий, началом координат, cmap и т.д. — см. подробности ниже.

tricontour(...) возвращает объект TriContourSet.

Необязательные ключевые аргументы:

colors: [ None | строка | (mpl_colors) ] Если None, используется цветовая карта, заданная cmap.

Если строка, например, 'r' или 'red', все уровни будут нарисованы в этом цвете.

Если кортеж аргументов цвета matplotlib (строка, число с плавающей точкой, rgb и т.д.), разные уровни будут нарисованы в разных цветах в заданном порядке.

alpha: float Значение прозрачности

cmap: [ None | Colormap ] Экземпляр cm Colormap или None. Если cmap равно None, а colors равно None, используется цветовая карта по умолчанию.

norm: [ None | Normalize ] Экземпляр matplotlib.colors.Normalize для масштабирования значений данных к цветам. Если norm равно None, а colors равно None, используется линейное масштабирование по умолчанию.

levels [level0, level1, ..., leveln] Список чисел с плавающей точкой, указывающих кривые уровня, которые нужно нарисовать в порядке возрастания; например, чтобы нарисовать только нулевой контур, передайте levels=[0]

origin: [ None | 'upper' | 'lower' | 'image' ] Если None, первое значение Z будет соответствовать нижнему левому углу, координате (0,0). Если 'image', будет использоваться значение rc для image.origin.

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

extent: [ None | (x0,x1,y0,y1) ]

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

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

locator: [ None | ticker.Locator subclass ] Если locator равно None, используется по умолчанию MaxNLocator. Locator используется для определения уровней контура, если они не заданы явно через аргумент V.

extend: [ 'neither' | 'both' | 'min' | 'max' ] Если это не 'neither', к диапазону автоматически добавляются уровни контура на одном или обоих концах, чтобы все данные были включены. Эти добавленные диапазоны затем отображаются на специальные значения цветовой карты, которые по умолчанию соответствуют концам диапазона цветовой карты, но могут быть установлены с помощью методов matplotlib.colors.Colormap.set_under() и matplotlib.colors.Colormap.set_over().

xunits, yunits: [ None | registered units ] Переопределяет единицы осей, задавая экземпляр matplotlib.units.ConversionInterface.

Только для ключевых аргументов tricontour:

linewidths: [ None | число | кортеж чисел ] Если linewidths равно None, используется значение по умолчанию rc:lines.linewidth.

Если число, все уровни будут нарисованы с этой шириной линии.

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

linestyles: [ None | 'solid' | 'dashed' | 'dashdot' | 'dotted' ] Если linestyles равно None, используется 'solid'.

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

Если контур использует монохромную цветовую карту, а уровень контура меньше 0, то используется стиль линии, указанный в rcParams["contour.negative_linestyle"].

Только для ключевых аргументов tricontourf:

antialiased: bool включить сглаживание

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

z1 < Z <= z2

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

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

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

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

Tricontour Smooth Delaunay

Tricontour Smooth User

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