matplotlib.axes.Axes.tricontour

Axes.tricontour(*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)

рисование контура с 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: 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, используется ширина по умолчанию в 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, то это минимальное значение будет включено в самый нижний интервал.