matplotlib.pyplot.contourf

matplotlib.pyplot.contourf(*args, **kwargs) [source]

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

Вызов функции:

contour([X, Y,] Z, [levels], **kwargs)

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

Параметры:	X, Y : array-like, optional Координаты значений в Z. X и Y должны быть двумерными массивами с такой же формой, как и Z (например, созданными с помощью numpy.meshgrid()), или они должны быть одномерными, так что len(X) == M — это число столбцов в Z, а len(Y) == N — число строк в Z. Если не указаны, они предполагаются целочисленными индексами, т.е. X = range(M), Y = range(N). Z : array-like(N, M) Значения высот, по которым строится контур. levels : int or array-like, optional Определяет количество и позиции контурных линий/областей. Если целое число n, используйте n интервалов данных; т.е. нарисуйте n+1 контурных линий. Значения уровней выбираются автоматически. Если массив, рисуйте контурные линии по заданным уровням. Значения должны быть в возрастающем порядке.
Возвращаемое значение:	:class:`~matplotlib.contour.QuadContourSet`
Другие параметры:	corner_mask : bool, optional Включить/отключить маскирование углов, что имеет эффект только если Z является массивом с пропускаемыми значениями. Если False, любой четырехугольник, касающийся точки с пропускаемым значением, маскируется. Если True, только треугольные углы четырехугольников, ближайшие к этим точкам, всегда маскируются, а другие треугольные углы, состоящие из трех точек без пропускаемых значений, контурируются как обычно. По умолчанию rcParams['contour.corner_mask'], который по умолчанию True. colors : color string or sequence of colors, optional Цвета уровней, т.е. линии для contour и области для contourf. Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения могут использоваться одиночные строковые цвета вместо списков с одним элементом, например, 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строковых цветов, а не для других способов задания цветов. По умолчанию (значение None) используется цветовая карта, заданная cmap. alpha : float, optional Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). cmap : str or Colormap, optional Объект Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровня с цветами. По умолчанию rcParams["image.cmap"]. Если задано, colors имеют приоритет над cmap. norm : Normalize, optional Если используется цветовая карта, объект Normalize масштабирует значения уровня до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не задано, используется линейное масштабирование по умолчанию. vmin, vmax : float, optional Если не None, эти значения будут переданы объекту Normalize, переопределяя масштабирование цветов по умолчанию, основанное на levels. origin : {None, 'upper', 'lower', 'image'}, optional Определяет ориентацию и точное положение Z, задавая положение Z[0, 0]. Это актуально только если X, Y не заданы. None: Z[0, 0] находится в левом нижнем углу при X=0, Y=0. 'lower': Z[0, 0] находится в левом нижнем углу при X=0.5, Y=0.5. 'upper': Z[0, 0] находится в левом верхнем углу при X=N+0.5, Y=0.5. 'image': Используйте значение из rcParams["image.origin"]. Примечание: значение None в параметре rcParam в настоящее время обрабатывается как 'lower'. extent : (x0, x1, y0, y1), optional Если 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 : ticker.Locator subclass, optional Локатор используется для определения контурных уровней, если они не заданы явно через levels. По умолчанию MaxNLocator. extend : {'neither', 'both', 'min', 'max'}, optional За исключением случая 'neither', контурные уровни автоматически добавляются к одному или обоим концам диапазона, чтобы включить все данные. Эти добавленные диапазоны затем сопоставляются со специальными значениями цветовой карты, которые по умолчанию соответствуют концам диапазона цветовой карты, но могут быть заданы методами matplotlib.colors.Colormap.set_under() и matplotlib.colors.Colormap.set_over(). xunits, yunits : registered units, optional Переопределяет единицы осей, указав экземпляр matplotlib.units.ConversionInterface. antialiased : bool, optinal Включает/отключает сглаживание, переопределяя настройки по умолчанию. Для заполненных контуров значение по умолчанию — True. Для контурных линий оно берется из rcParams["lines.antialiased"]. Nchunk : int >= 0, optional Если 0, нет подразделения области. Укажите положительное целое число, чтобы разделить область на поддомены nchunk на nchunk четырехугольников. Разбиение уменьшает максимальную длину полигонов, генерируемых алгоритмом контурирования, что уменьшает нагрузку отрисовки, передаваемую бэкенду, и требует немного меньше оперативной памяти. Однако в зависимости от бэкенда, флага antialiased и значения alpha это может привести к артефактам отрисовки на границах разбиения. linewidths : float or sequence of float, optional Применимо только к contour. Ширина линии контурных линий. Если число, все уровни будут нарисованы с этой шириной линии. Если последовательность, уровни в порядке возрастания будут нарисованы с шириной линий в указанном порядке. По умолчанию rcParams["lines.linewidth"]. linestyles : {None, 'solid', 'dashed', 'dashdot', 'dotted'}, optional Применимо только к contour. Если linestyles — None, значение по умолчанию — 'solid', за исключением монохромных линий. В этом случае отрицательные контуры будут использовать стиль линии из rcParams["contour.negative_linestyle"] настройки. linestyles также может быть итерируемым набором вышеперечисленных строк, определяющих набор стилей линий, которые будут использоваться. Если этот итерируемый набор короче, чем количество контурных уровней, он будет повторяться по мере необходимости. hatches : List[str], optional Применимо только к contourf. Список типов штриховки, используемых для заполненных областей. Если None, к контуру не будет добавлена штриховка. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

Примечания

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

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

   z1 < Z <= z2
   

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

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

Маска углов контура

Раскрашенный контур с штриховкой

Contourf и логарифмическая шкала цветов

pcolormesh

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

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

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