matplotlib.pyplot.tricontourf

matplotlib.pyplot.tricontourf(*args, **kwargs)[source]

Отображение областей контура на неструктурированной треугольной сетке.

Вызовы:

tricontourf(triangulation, z, [levels], ...)
tricontourf(x, y, z, [levels], *, [triangles=triangles], [mask=mask], ...)

Треугольную сетку можно указать, передав объект Triangulation в качестве первого параметра или передав точки x, y и необязательно triangles и mask. См. Triangulation для объяснения этих параметров. Если ни triangulation, ни triangles не заданы, триангуляция вычисляется динамически.

Возможна позиционная передача triangles, т.е. tricontourf(x, y, triangles, z, ...). Однако, это не рекомендуется. Для большей ясности передавайте triangles через ключевой аргумент.

Параметры:

triangulationTriangulation, необязательно

Уже созданная треугольная сетка.

x, y, triangles, mask

Параметры, определяющие треугольную сетку. См. Triangulation. Это взаимоисключающие параметры с triangulation.

zмассив-подобный объект

Значения высоты, по которым строится контур. Отображение цвета контролируется параметрами cmap, norm, vmin и vmax.

Примечание

Все значения в z должны быть конечными. Значения nan и inf должны быть либо удалены, либо использовать set_mask.

levelsцелое число или массив-подобный объект, необязательно

Определяет количество и положение линий/областей контура.

Если целое число n, используйте MaxNLocator, которое пытается автоматически выбрать не более n+1 "красивых" уровней контура между минимальным и максимальным числовым значениями Z.

Если массив-подобный объект, строятся линии контура на заданных уровнях. Значения должны быть в порядке возрастания.

Возвращаемое значение:

TriContourSet

Другие параметры:

colorsстрока цвета или последовательность цветов, необязательно

Цвета уровней, то есть областей контура.

Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется.

В качестве сокращения могут использоваться одиночные строковые значения цвета вместо списков с одним элементом, т.е. 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строковых значений цвета, а не для других способов задания цветов.

По умолчанию (значение None) используется цветовая карта, указанная в cmap.

alphaвещественное число, по умолчанию: 1

Значение прозрачности, от 0 (прозрачный) до 1 (непрозрачный).

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Объект цветовой карты или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.

Этот параметр игнорируется, если задан colors.

normстрока или Normalize, необязательно

Метод нормализации, используемый для масштабирования скалярных данных в диапазоне [0, 1] перед отображением с помощью cmap. По умолчанию используется линейное масштабирование, отображающее минимальное значение как 0, а максимальное как 1.

Если задан, это может быть одно из следующего:

Объект Normalize или один из его подклассов (см. Нормализация цветовой карты).
Имя шкалы, например, "линейное", "логарифмическое", "симлогирифмическое", "логит" и т.д. Список доступных шкал можно получить, вызвав matplotlib.scale.get_scale_names(). В этом случае динамически генерируется и создаётся соответствующий подкласс Normalize.

Этот параметр игнорируется, если задан colors.

vmin, vmaxвещественное число, необязательно

При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который покрывается цветовой картой. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. Использование vmin/vmax при заданном объекте norm является ошибкой (но использование строки norm вместе с vmin/vmax допустимо).

Если vmin или vmax не заданы, по умолчанию масштабирование цвета основано на levels.

Этот параметр игнорируется, если задан colors.

origin{None, 'верх', 'низ', 'изображение'}, по умолчанию: None

Определяет ориентацию и точное положение z, задавая положение z[0, 0]. Это актуально только если X, Y не заданы.

None: z[0, 0] находится в левом нижнем углу при X=0, Y=0.
'низ': z[0, 0] находится в левом нижнем углу при X=0.5, Y=0.5.
'верх': z[0, 0] находится в левом верхнем углу при X=N+0.5, Y=0.5.
'изображение': Используйте значение из rcParams["image.origin"] (по умолчанию: 'upper').

extent(x0, x1, y0, y1), необязательно

Если 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, необязательно

Локатор используется для определения уровней контура, если они не заданы явно через levels. По умолчанию MaxNLocator.

extend{'ничего', 'оба', 'мин', 'макс'}, по умолчанию: 'ничего'

Определяет tricontourf окраску значений, которые находятся вне диапазона levels.

Если 'ничего', значения вне диапазона levels не окрашиваются. Если 'мин', 'макс' или 'оба', окрашиваются значения ниже, выше или ниже и выше диапазона levels.

Значения ниже min(levels) и выше max(levels) сопоставляются с под/над значениями Colormap. Обратите внимание, что большинство цветовых карт по умолчанию не имеют выделенных цветов для этих значений, поэтому значения "сверху" и "снизу" являются крайними значениями цветовой карты. Вы можете явно задать эти значения, используя Colormap.set_under и Colormap.set_over.

Примечание

Существующий TriContourSet не получает уведомления об изменениях свойств его цветовой карты. Поэтому необходимо явное обращение к ContourSet.changed() после изменения цветовой карты. Явное обращение можно опустить, если цветовая панель присвоена TriContourSet, так как она внутренне вызывает ContourSet.changed().

xunits, yunitsзарегистрированные единицы, необязательно

Переопределить единицы осей, указав экземпляр matplotlib.units.ConversionInterface.

antialiasedбулево, необязательно

Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию True. Для линий контура оно берётся из rcParams["lines.antialiased"] (по умолчанию: True).

hatchesсписок[строка], необязательно

Список узоров штриховки для использования на заполненных областях. Если None, штриховка не будет добавлена к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

Примечания

tricontourf заполняет интервалы, которые закрыты сверху; то есть, для границ z1 и z2, заполненная область представляет собой:

z1 < Z <= z2

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

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

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

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

Триконтур Сглаженный Делоне

Триконтур Сглаженный Пользовательский

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

matplotlib.pyplot.tricontourf

Примечания

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

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