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 должны быть двумерными с одинаковой формой, что и 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.axes.Axes.contourf

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

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

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

pcolormesh

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

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

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