matplotlib.axes.Axes.tricontourf

Axes.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_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 ]

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

extend: [ ‘neither’ | ‘both’ | ‘min’ | ‘max’ ]

Если это не ‘neither’, уровни контура автоматически добавляются к одному или обоим концам диапазона, чтобы включить все данные. Эти добавленные диапазоны затем отображаются на специальные значения цветовой карты, которые по умолчанию соответствуют концам диапазона цветовой карты, но могут быть заданы методами 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 | ‘solid’ | ‘dashed’ | ‘dashdot’ | ‘dotted’ ]

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

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

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

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

antialiased: [ True | False ]

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

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

z1 < z <= z2

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