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 должны быть двумерными с такой же формой, что и 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 контурных линий. Значения уровней автоматически выбираются. Если массив, рисуются контурные линии на указанных уровнях. Значения должны быть в порядке возрастания.
Возвращает:	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"]. extent : (x0, x1, y0, y1), optional Если origin не None, то extent интерпретируется так же, как в 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, default: 'neither' Определяет contourf окраску значений, которые находятся вне диапазона levels. Если 'neither', значения вне диапазона levels не окрашиваются. Если 'min', 'max' или 'both', окрашиваются значения меньше, больше или меньше и больше диапазона levels. Значения ниже min(levels) и выше max(levels) отображаются на значения под/над цветовой картой Colormap. Обратите внимание, что большинство цветовых карт по умолчанию не имеют выделенных цветов для этих значений, поэтому значения сверх и под являются крайними значениями цветовой карты. Вы можете явно установить эти значения, используя Colormap.set_under и Colormap.set_over. Примечание Существующий QuadContourSet не уведомляется, если изменяются свойства его цветовой карты. Поэтому необходим явный вызов QuadContourSet.changed() после изменения цветовой карты. Явный вызов можно опустить, если цветовая шкала назначена QuadContourSet, так как она внутренне вызывает QuadContourSet.changed(). Пример: x = np.arange(1, 10) y = x.reshape(-1, 1) h = x * y cs = plt.contourf(h, levels=[10, 30, 50], colors=['#808080', '#A0A0A0', '#C0C0C0'], extend='both') cs.cmap.set_over('red') cs.cmap.set_under('blue') cs.changed() xunits, yunits : registered units, optional Переопределяет единицы осей, указывая экземпляр matplotlib.units.ConversionInterface. antialiased : bool, optional Включает антиалиасинг, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию 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
   

   кроме самого нижнего интервала, который закрыт с обеих сторон (т.е. включает самое низкое значение).

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

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

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

Штриховка контуров

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

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

pcolormesh

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