matplotlib.pyplot.contour

matplotlib.pyplot.contour(*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: float

Значение смешивания альфа-канала

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: [уровень0, уровень1, …, уровеньn]

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

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

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, заполненная область:

z1 < z <= z2

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