matplotlib.pyplot.tricontour

matplotlib.pyplot.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.

Примечание

Все значения в z должны быть конечными. Следовательно, значения nan и inf должны быть удалены или использована функция set_mask.

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

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

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

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

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

TriContourSet

Другие параметры:

colorsстрока цвета или последовательность цветов, необязательно

Цвета уровней, т.е. линий контура.

Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется.

В качестве сокращения могут использоваться одиночные строки цвета вместо списков из одного элемента, т.е. 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строк цвета, а не для других способов задания цветов.

По умолчанию (значение None) используется цветовая карта, указанная параметром cmap.

alphaчисло, по умолчанию: 1

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

Определяет окраску значений, которые находятся за пределами диапазона levels.

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

Значения ниже min(levels) и выше max(levels) сопоставляются с под/над значениями Colormap. Обратите внимание, что большинство цветовых карт по умолчанию не имеют выделенных цветов для этих значений, поэтому значения over и under — крайние значения цветовой карты. Вы можете явно установить эти значения, используя 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

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

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

Плавный триконтурный график Делоне

Плавный триконтурный график Делоне

Плавный триконтурный график пользователя

Плавный триконтурный график пользователя

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

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