matplotlib.axes.Axes.contourf

Axes.contourf(self, *args, data=None, **kwargs) [source]

Построение контурных линий.

Вызов:

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

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

Параметры:	`X, Yarray-like, optional` Координаты значений в Z. X и Y должны быть оба 2-мерными с такой же формой, что и Z (например, созданные с помощью `numpy.meshgrid`), или они оба должны быть 1-мерными, так что `len(X) == M` является числом столбцов в Z, а `len(Y) == N` — числом строк в Z. Если они не указаны, предполагается, что они являются целочисленными индексами, т.е. `X = range(M)`, `Y = range(N)`. `Zarray-like(N, M)` Значения высот, по которым строится контур. `levelsint or array-like, optional` Определяет количество и положение контурных линий/областей. Если целое число n, используется `MaxNLocator`, который пытается автоматически выбрать не более n+1 "приятных" уровней контура между vmin и vmax. Если массив, строятся контурные линии на заданных уровнях. Значения должны быть в порядке возрастания.
Возвращаемое значение:	`QuadContourSet`
Дополнительные параметры:	`corner_maskbool, default: rcParams["contour.corner_mask"] (default: True)` Включить/выключить маскирование углов, что влияет только в том случае, если Z является массив-маской. Если `False`, любой четырехугольник, касающийся замаскированной точки, маскируется. Если `True`, маскируются только треугольные углы четырехугольников, наиболее близких к этим точкам, а другие треугольные углы, состоящие из трех незамаскированных точек, контурируются как обычно. `colorscolor string or sequence of colors, optional` Цвета уровней, т.е. линии для `contour` и области для `contourf`. Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения могут использоваться одиночные строковые цвета вместо одноэлементных списков, т.е. `'red'` вместо `['red']` для окраски всех уровней одним цветом. Это сокращение работает только для строковых цветов, а не для других способов указания цветов. По умолчанию (значение None) используется цветовая карта, указанная параметром cmap. `alphafloat, default: 1` Значение альфа-смешивания от 0 (прозрачный) до 1 (непрозрачный). `cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis')` Экземпляр `Colormap` или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровней с цветами. Если заданы и colors, и cmap, возникает ошибка. `normNormalize, optional` Если используется цветовая карта, экземпляр `Normalize` масштабирует значения уровней до канонического диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не указано, используется масштабирование по умолчанию — линейное. `vmin, vmaxfloat, optional` Если не None, одно или оба этих значения будут переданы экземпляру `Normalize`, переопределяя масштабирование цвета по умолчанию, основанное на levels. `origin{None, 'upper', 'lower', 'image'}, default: None` Определяет ориентацию и точное положение 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"]` (по умолчанию: `'upper'`). `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. `locatorticker.Locator subclass, optional` Локатор используется для определения уровней контура, если они не заданы явно через levels. По умолчанию `MaxNLocator`. `extend{'neither', 'both', 'min', 'max'}, default: 'neither'` Определяет `contourf`-окраску значений, которые находятся вне диапазона levels. Если 'neither', значения вне диапазона levels не окрашиваются. Если 'min', 'max' или 'both', окрашиваются значения ниже, выше или ниже и выше диапазона levels. Значения ниже `min(levels)` и выше `max(levels)` сопоставляются с значениями under/over цветовой карты `Colormap`. Обратите внимание, что большинство цветовых карт по умолчанию не имеют выделенных цветов для этих значений, поэтому значения over и under являются крайними значениями цветовой карты. Вы можете явно задать эти значения с помощью `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, yunitsregistered units, optional` Переопределение единиц осей путем указания экземпляра `matplotlib.units.ConversionInterface`. `antialiasedbool, optional` Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для контурных линий оно берётся из `rcParams["lines.antialiased"]` (по умолчанию: `True`). `nchunkint >= 0, optional` Если 0, нет разбиения области. Укажите положительное целое число, чтобы разбить область на поддомены размером nchunk на nchunk четырехугольников. Разбиение уменьшает максимальную длину полигонов, генерируемых алгоритмом контурирования, что снижает нагрузку на рендеринг, передаваемую бэкенду, и также требует немного меньше оперативной памяти. Однако в зависимости от бэкенда, флага antialiased и значения alpha оно может вводить артефакты рендеринга на границах блоков. `linewidthsfloat or array-like, default: rcParams["contour.linewidth"] (default: None)` Применимо только к `contour`. Толщина линий контура. Если число, все уровни будут отображаться с этой толщиной линии. Если последовательность, уровни в порядке возрастания будут отображаться с толщинами линий в указанном порядке. Если None, используется значение по умолчанию `rcParams["lines.linewidth"]` (по умолчанию: `1.5`). `linestyles{None, 'solid', 'dashed', 'dashdot', 'dotted'}, optional` Применимо только к `contour`. Если linestyles равно None, значение по умолчанию — 'solid', за исключением монохромных линий. В этом случае отрицательные контуры получат тип линии из `rcParams["contour.negative_linestyle"]` (значение по умолчанию: `'dashed'`). linestyles также может быть итерируемым объектом указанных выше строк, определяющим набор типов линий, которые будут использоваться. Если этот итерируемый объект короче, чем количество уровней контура, он будет повторяться по мере необходимости. `hatchesList[str], optional` Применимо только к `contourf`. Список шаблонов перекрестных штрихов, которые будут использоваться для заполненных областей. Если None, к контуру не будет добавлен штрих. Штрихи поддерживаются только в PostScript, PDF, SVG и Agg бэкендах.

Примечания

END_OF_DOCUMENT_MARKER

contourf отличается от версии MATLAB тем, что не рисует грани многоугольников. Чтобы нарисовать грани, добавьте линии контуров с вызовами contour.
contourf заполняет интервалы, которые закрыты сверху; то есть, для границ z1 и z2 заполненная область имеет вид:
```
z1 < Z <= z2
```
за исключением самого нижнего интервала, который закрыт с обеих сторон (то есть включает в себя самое низкое значение).