matplotlib.axes.Axes.tricontour

Axes.tricontour(*args, **kwargs)[source]

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

Возможные подписи:

tricontour(triangulation, Z, [levels], ...)
tricontour(x, y, Z, [levels], *, [triangles=triangles], [mask=mask], ...)

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

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

Параметры:

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

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

x, y, triangles, mask

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

Zподобный массиву

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

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

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

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

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

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

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{'ничего', 'оба', 'мин', 'макс'}, по умолчанию: 'ничего'

Определяет 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.axes.Axes.tricontour`

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

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

Tricontour Smooth Delaunay

Tricontour Smooth User

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

Трехмерный контурный график треугольников

tricontour(x, y, z)

matplotlib.axes.Axes.tricontour

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

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