matplotlib.pyplot.contourf

matplotlib.pyplot.contourf(*args, **kwargs)

Строит контурные линии.

contour() и contourf() соответственно строят контурные линии и заполненные контурные области. За исключением отмеченных случаев, сигнатуры функций и возвращаемые значения одинаковы для обоих версий.

contourf() отличается от версии MATLAB тем, что не рисует края многоугольников. Для рисования краёв добавьте контурные линии с помощью вызова contour().

Подписи функций:

contour(Z)

рисует контурную диаграмму массива Z. Значения уровней выбираются автоматически.

contour(X,Y,Z)

X, Y задают координаты (x, y) поверхности

contour(Z,N)
contour(X,Y,Z,N)

строит контурную диаграмму до N автоматически выбранных уровней.

contour(Z,V)
contour(X,Y,Z,V)

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

contourf(..., V)

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

contour(Z, **kwargs)

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

X и Y должны быть обеих 2-мерными с той же формой, что и Z, или обе должны быть 1-мерными, так что len(X) является числом столбцов в Z, а len(Y) является числом строк в Z.

C = contour(...) возвращает объект QuadContourSet.

Дополнительные ключевые аргументы:

corner_mask: [ True | False | ‘legacy’ ]

Включить/выключить маскирование углов, что имеет эффект только если Z — это массив с пропусками. Если False, любой четырёхугольник, касающийся пропущенной точки, будет замаскирован. Если True, только треугольные углы четырёхугольников, ближайшие к пропущенным точкам, всегда замаскированы, другие треугольные углы, состоящие из трёх незамаскированных точек, контурируются как обычно. Если ‘legacy’, используется старый алгоритм контурирования, что эквивалентно False и устарело, оставаясь только пока новый алгоритм полностью протестирован.

Если не указано, используется значение по умолчанию из rcParams[‘contour.corner_mask’], которое равно True, если не было изменено.

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

vmin, vmax: [ None | число ]

Если не None, эти значения будут предоставлены объекту matplotlib.colors.Normalize, переопределяя масштабирование цвета по умолчанию на основе levels.

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.
antialiased: [ True | False ]: включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для контурных линий оно берется из rcParams[‘lines.antialiased’].
nchunk: [ 0 | целое число ]: Если 0, область не подразделяется. Укажите положительное целое число, чтобы разделить область на поддомены размером nchunk на nchunk четырёхугольников. Разбиение уменьшает максимальную длину многоугольников, генерируемых алгоритмом контурирования, что уменьшает нагрузку на отрисовку, передаваемую бэкенду, а также требует немного меньше памяти. Однако это может привести к артефактам отрисовки на границах разбиения в зависимости от бэкенда, флага antialiased и значения alpha.

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

linewidths: [ None | число | кортеж чисел ]

Если linewidths равно None, используется ширина по умолчанию в lines.linewidth в matplotlibrc.

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

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

linestyles: [ None | ‘сплошная’ | ‘штриховая’ | ‘пунктирная’ | ‘точковая’ ]

Если linestyles равно None, по умолчанию используется ‘сплошная’, если линии не монохромные. В противном случае, отрицательные контуры будут использовать стиль линии из matplotlibrc contour.negative_linestyle настройки.

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

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

hatches:: Список узоров штриховки для использования на заполненных областях. Если None, штриховка не будет добавлена к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

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