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

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

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

Определяет окраску значений, которые находятся вне диапазона 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 также может быть итерируемым объектом из вышеперечисленных строк, определяющим набор стилей линий, которые будут использоваться. Если этот итерируемый объект короче, чем число уровней контура, он будет повторяться по мере необходимости.