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

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

tricontour(..., Z)

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

tricontour(..., Z, N)

рисует до N+1 автоматически выбранных уровней контуров (N интервалов).

tricontour(..., Z, V)

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

tricontourf(..., Z, V)

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

tricontour(Z, **kwargs)

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

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 | 'верх' | 'низ' | 'изображение' ] Если 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. Locator используется для определения уровней контура, если они не заданы явно через аргумент 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: bool включить сглаживание

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

z1 < z <= z2

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

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

Контурный график неравномерно расположенных данных

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

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

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