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. Документация этого класса содержит объяснение этих случаев.

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

tricontour(..., Z)

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

tricontour(..., Z, N)

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

tricontour(..., Z, V)

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

tricontourf(..., Z, V)

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

tricontour(Z, **kwargs)

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

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

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

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

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

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

z1 < Z <= z2

за исключением самого нижнего интервала, который закрыт с обеих сторон (то есть он включает наименьшее значение).

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

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

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

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

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