matplotlib.pyplot.tricontourf

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

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

Треугольная сетка может быть задана двумя способами;

tricontourf(triangulation, ...)

где triangulation — объект Triangulation, или

tricontourf(x, y, ...)
tricontourf(x, y, triangles, ...)
tricontourf(x, y, triangles=triangles, ...)
tricontourf(x, y, mask=mask, ...)
tricontourf(x, y, triangles, mask=mask, ...)

в этом случае будет создан объект Triangulation. Подробное описание этих случаев см. в документации этого класса.

Остальные аргументы могут быть:

tricontourf(..., Z)

где Z — массив значений для контура, по одному значению на точку в треугольной сетке. Значения уровней выбираются автоматически.

tricontourf(..., Z, levels)

контур до levels+1 автоматически выбранных уровней контура (levels интервалов).

tricontourf(..., Z, levels)

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

tricontourf(Z, **kwargs)

Используйте ключевые аргументы для управления цветами, шириной линии, началом координат, палитрой cmap… см. более подробные сведения ниже.

Параметры:	triangulationTriangulation, необязательно Неструктурированная треугольная сетка. Если задано, то x, y, triangles и mask не принимаются. x, yмассив, необязательно Координаты значений в Z. triangles(ntri, 3) массив целых чисел, необязательно Для каждого треугольника индексы трёх точек, образующих треугольник, упорядоченные против часовой стрелки. Если не задано, вычисляется триангуляция Делоне. mask(ntri,) массив булевых значений, необязательно Треугольники, которые будут замаскированы. Zдвумерный массив Значения высот, по которым строится контур. levelsцелое число или массив, необязательно Определяет количество и положение линий/областей контура. Если целое число n, используется MaxNLocator, который пытается автоматически выбрать не более n+1 «хороших» уровней контура между vmin и vmax. Если массив, рисуются линии контура по заданным уровням. Значения должны быть упорядочены по возрастанию.
Возвращаемое значение:	TriContourSet
Другие параметры:	colorsстрока цвета или последовательность цветов, необязательно Цвета уровней, то есть областей контура. Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения можно использовать строки одиночных цветов вместо списков с одним элементом, например 'red' вместо ['red'] для раскраски всех уровней одним цветом. Это сокращение работает только для строковых значений цвета, а не для других способов задания цветов. По умолчанию (значение None) используется цветовая карта, указанная в cmap. alphaчисло с плавающей точкой, по умолчанию: 1 Значение альфа-смешивания, между 0 (прозрачный) и 1 (непрозрачный). cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis') Объект Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровня с цветами. Если заданы как colors, так и cmap, возникает ошибка. normNormalize, необязательно Если используется цветовая карта, экземпляр Normalize масштабирует значения уровня до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не задано, используется линейное масштабирование по умолчанию. vmin, vmaxчисло с плавающей точкой, необязательно Если не None, одно или оба из этих значений будут переданы экземпляру Normalize, переопределяя масштабирование цвета по умолчанию, основанное на levels. 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, необязательно 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. antialiasedbool, необязательно Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для контуров линий оно берется из rcParams["lines.antialiased"] (значение по умолчанию: True). hatchesсписок[строка], необязательно Список шаблонов штриховки для заполненных областей. Если None, штриховка не будет добавлена к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg-бэкендах.

Замечания

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

z1 < Z <= z2

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

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