matplotlib.pyplot.tricontour

matplotlib.pyplot.tricontour(*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: число Значение прозрачности.

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. Локатор используется для определения уровней контура, если они не заданы явно через аргумент 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.tricontour

График контуров нерегулярно расположенных данных

Триконтур Сглаженный Делоне

Триконтур Сглаженный Пользовательский

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