matplotlib.axes.Axes.contourf

Axes.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.axes.Axes.contourf

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

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

Контурf с штриховкой

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

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

pcolormesh

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