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, optional Неструктурированная треугольная сетка. Если указан, то x, y, triangles и mask не принимаются. x, yarray-like, optional Координаты значений в Z. trianglesint array-like of shape (ntri, 3), optional Для каждого треугольника индексы трех точек, образующих треугольник, упорядоченные против часовой стрелки. Если не указаны, вычисляется треугольная сетка Делоне. maskbool array-like of shape (ntri), optional Треугольники, которые нужно замаскировать. Zarray-like(N, M) Значения высот, по которым строится контур. levelsint or array-like, optional Определяет количество и расположение линий/областей контура. Если целое число n, используется MaxNLocator, который пытается автоматически выбрать не более n+1 "красивых" уровней контура между vmin и vmax. Если массив-подобный объект, строятся линии контура по заданным уровням. Значения должны быть упорядочены по возрастанию.
Возвращает:	TriContourSet
Другие параметры:	colorscolor string or sequence of colors, optional Цвета уровней, то есть линий контура. Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения можно использовать строковые представления цветов вместо списков, например '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] для отображения в цвета. Если не задан, используется линейное масштабирование по умолчанию. 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' Определяет способ окраски значений, которые лежат вне диапазона levels. Если 'neither', значения вне диапазона levels не окрашиваются. Если 'min', 'max' или 'both', окрашиваются значения меньше, больше или меньше и больше диапазона levels соответственно. Значения ниже min(levels) и выше max(levels) отображаются с использованием под/над значениями Colormap. Обратите внимание, что большинство цветовых карт по умолчанию не имеют специальных цветов для этих значений, поэтому значения над и под — крайние значения цветовой карты. Возможно, вам нужно явно задать эти значения, используя Colormap.set_under и Colormap.set_over. Примечание Существующий TriContourSet не получает уведомлений о том, если свойства цветовой карты изменены. Поэтому после изменения цветовой карты требуется явный вызов ContourSet.changed(). Явный вызов можно опустить, если цветовая шкала назначена TriContourSet, так как он внутренне вызывает ContourSet.changed(). xunits, yunitsregistered units, optional Переопределение единиц осей путём указания экземпляра matplotlib.units.ConversionInterface. linewidthsfloat or array-like, default: rcParams["contour.linewidth"] (default: None) Толщина линий контура. Если число, все уровни будут нарисованы с этой толщиной. Если последовательность, уровни в порядке возрастания будут нарисованы с толщинами в указанном порядке. Если None, используется значение по умолчанию rcParams["lines.linewidth"] (по умолчанию: 1.5). linestyles{None, 'solid', 'dashed', 'dashdot', 'dotted'}, optional Если linestyles равно None, по умолчанию используется 'solid', если линии не монохромные. В противном случае отрицательные контуры получат стиль линии из rcParams["contour.negative_linestyle"] (по умолчанию: 'dashed'). linestyles также может быть итерируемым объектом с вышеуказанными строками, определяющими набор стилей линий, которые будут использоваться. Если этот итерируемый объект короче, чем количество уровней контура, он будет повторяться по мере необходимости.

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

Построение контура для неравномерно распределённых данных

Гладкий триконтур Делоне

Гладкий триконтур Пользовательский

Демонстрация трилинейного градиента