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)

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

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

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

linestyles: [ None | 'сплошная' | 'штриховая' | 'штрихпунктирная' | 'пунктирная' ] Если linestyles равен None, используется 'сплошная'.

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

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

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

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

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

z1 < z <= z2

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

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

Контурная диаграмма неравномерно распределенных данных

Tricontour Сглаживание Делоне

Tricontour Сглаживание Пользовательский

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