matplotlib.pyplot.tricontour

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

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

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

tricontour(triangulation, ...)

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

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

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

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

tricontour(..., Z)

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

tricontour(..., Z, levels)

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

tricontour(..., Z, levels)

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

tricontour(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{'ничего', 'оба', 'мин', 'макс'}, по умолчанию: 'ничего' Определяет tricontour окраску значений, которые находятся вне диапазона 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). linewidthsчисло или массив-подобный объект, по умолчанию: rcParams["contour.linewidth"] (по умолчанию: None) Ширина линий контура. Если число, все уровни будут нарисованы с этой шириной. Если последовательность, уровни в порядке возрастания будут нарисованы с шириной линий в указанном порядке. Если None, это ссылается на rcParams["lines.linewidth"] (по умолчанию: 1.5). linestyles{None, 'сплошная', 'штриховая', 'пунктирная', 'точечная'}, необязательно Если linestyles — None, значение по умолчанию — 'сплошная', если линии не монохромные. В этом случае отрицательные контуры примут стиль линии из rcParams["contour.negative_linestyle"] (по умолчанию: 'dashed'). linestyles также может быть итерируемым списком вышеуказанных строк, задающим набор стилей линий для использования. Если этот итерируемый список короче, чем количество уровней контура, он повторяется по мере необходимости.

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