matplotlib.pyplot.tricontourf

matplotlib.pyplot.tricontourf(*args, **kwargs)

Отрисовка контуров на неструктурированной треугольной сетке. 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 будет создан. См. Triangulation для объяснения этих возможностей.

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

tricontour(..., Z)

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

tricontour(..., Z, N)

определяет контур с автоматически выбранными уровнями.

tricontour(..., Z, V)

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

tricontourf(..., Z, V)

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

tricontour(Z, **kwargs)

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

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

Дополнительные ключевые аргументы:

colors: [ None | строка | (mpl_цвета) ]

Если 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 | ‘верх’ | ‘низ’ | ‘изображение’ ]

Если None, первое значение Z будет соответствовать левому нижнему углу, координате (0,0). Если ‘изображение’, будет использовано значение 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 ]

Если locator равно None, используется по умолчанию MaxNLocator. Локатор используется для определения уровней контура, если они не заданы явно через аргумент V.

extend: [ ‘ничего’ | ‘оба’ | ‘мин’ | ‘макс’ ]

Если это не ‘ничего’, к диапазону автоматически добавляются уровни контура с одной или обеих сторон, чтобы все данные были включены. Эти добавленные диапазоны затем отображаются на специальные значения цветовой карты, которые по умолчанию находятся на концах диапазона цветовой карты, но могут быть установлены с помощью методов matplotlib.colors.Colormap.set_under() и matplotlib.colors.Colormap.set_over().

xunits, yunits: [ None | зарегистрированные единицы ]

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

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

linewidths: [ None | число | кортеж чисел ]

Если linewidths равно None, используется ширина по умолчанию в lines.linewidth в matplotlibrc.

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

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

linestyles: [ None | ‘сплошная’ | ‘пунктирная’ | ‘штрихпунктирная’ | ‘точково-штриховая’ ]

Если linestyles равно None, используется ‘сплошная’.

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

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

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

antialiased: [ True | False ]

включить антиалиасинг

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

z1 < z <= z2

Есть одно исключение: если нижняя граница совпадает с минимальным значением массива z, то это минимальное значение будет включено в самый нижний интервал.

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

Сравнение tricontour и griddata

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

Гладкий триконтур пользователя

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

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