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 Значение смешивания alpha

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"] (по умолчанию: 'dashed').

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

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

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

z1 < Z <= z2

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

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

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

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

Tricontour Smooth Delaunay

Tricontour Smooth User

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