matplotlib.pyplot.contourf

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

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

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

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

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

Параметры:	X, Y : array-like, optional Координаты значений в Z. X и Y должны быть оба 2-мерными с такой же формой, что и Z (например, созданные с помощью numpy.meshgrid()), или они оба должны быть 1-мерными, так что 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 контурных линий. Значения уровней автоматически выбираются. Если массив, рисуйте контурные линии по заданным уровням. Значения должны быть отсортированы по возрастанию.
Возвращаемые значения:	c : 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

Штриховка contourf

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

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

pcolormesh

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