matplotlib.pyplot.tricontourf

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

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

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

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

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

z1 < z <= z2

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

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

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

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

Tricontour Сглаженный Делоне

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

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