matplotlib.axes.Axes.tricontour
-
Axes.tricontour(ax, *args, **kwargs) -
Отображение линий контура на неструктурированной треугольной сетке.
Треугольная сетка может быть задана двумя способами; либо
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)
Используйте ключевые аргументы для управления цветами, шириной линий, началом координат, палитрой ... см. более подробные сведения ниже.
Параметры: -
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.Если массив, рисует линии контура на заданных уровнях. Значения должны быть в порядке возрастания.
Возвращает: Другие параметры: -
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').
-
None:
-
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' -
Определяет
tricontour-окраску значений, которые находятся вне диапазона levels.Если 'neither', значения вне диапазона levels не окрашиваются. Если 'min', 'max' или 'both', окрашиваются значения меньше, больше или меньше и больше диапазона levels.
Значения ниже
min(levels)и вышеmax(levels)отображаются на значения 'under'/'over' цветовой картыColormap. Обратите внимание, что большинство цветовых карт по умолчанию не имеют выделенных цветов для этих значений, поэтому значения over и under — это крайние значения цветовой карты. Вы можете явно задать эти значения с помощью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.axes.Axes.tricontour
END_OF_DOCUMENT_MARKER
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/_as_gen/matplotlib.axes.Axes.tricontour.html