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, используется значение ширины по умолчанию в 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.tricontourf

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

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

Tricontour Гладкое пользовательское

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

Tricontour Гладкий Делоне