matplotlib.axes.Axes.tricontourf
-
Axes.tricontourf(ax, *args, **kwargs) -
Отображение контуров на неструктурированной треугольной сетке.
tricontourиtricontourfсоответственно рисуют линии контура и заполненные контуры. За исключением отмеченных случаев, сигнатуры функций и возвращаемые значения одинаковы для обоих версий.Треугольная сетка может быть задана двумя способами:
tricontour(triangulation, ...)
где triangulation — объект
matplotlib.tri.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, N)
контур до N+1 автоматически выбранных уровней контура (N интервалов).
tricontour(..., Z, V)
нарисовать линии контура в значениях, заданных последовательностью V, которая должна быть отсортирована по возрастанию.
tricontourf(..., Z, V)
заполнить (len(V)-1) областей между значениями в V, которые должны быть отсортированы по возрастанию.
tricontour(Z, **kwargs)
Используйте ключевые аргументы для управления цветами, шириной линий, началом, cmap и т. д. Более подробную информацию см. ниже.
tricontour(...)возвращает объектTriContourSet.Дополнительные ключевые аргументы:
colors: [ None | строка | (mpl_colors) ] Если None, используется цветовая карта, указанная в cmap.
Если строка, например, 'r' или 'red', все уровни будут нарисованы этим цветом.
Если кортеж аргументов цвета matplotlib (строка, число, rgb и т.д.), разные уровни будут нарисованы разными цветами в указанном порядке.
alpha: float Значение прозрачности
cmap: [ None | Colormap ] Экземпляр cm
Colormapили None. Если cmap равно None и colors равно None, используется цветовая карта по умолчанию.norm: [ None | Normalize ] Экземпляр
matplotlib.colors.Normalizeдля масштабирования значений данных до цветов. Если norm равно None и colors равно None, используется линейное масштабирование по умолчанию.levels [level0, level1, ..., leveln] Список чисел с плавающей точкой, указывающий кривые уровня для отрисовки, в порядке возрастания; например, для отрисовки только нулевого контура используйте
levels=[0]origin: [ None | 'верхний' | 'нижний' | 'изображение' ] Если None, первое значение Z будет соответствовать нижнему левому углу, позиции (0, 0). Если 'изображение', будет использовано значение rc для
image.origin.Этот ключевой аргумент неактивен, если X и Y указаны в вызове контура.
extent: [ None | (x0, x1, y0, y1) ]
Если origin не None, то extent интерпретируется так же, как в
matplotlib.pyplot.imshow(): он задает внешние границы пикселей. В этом случае положение Z[0, 0] — центр пикселя, а не угол. Если origin равно None, то (x0, y0) — положение Z[0, 0], а (x1, y1) — положение Z[-1,-1].Этот ключевой аргумент неактивен, если X и Y указаны в вызове контура.
locator: [ None | подкласс ticker.Locator ] Если locator равен None, используется по умолчанию
MaxNLocator. Локатор используется для определения уровней контура, если они не заданы явно аргументом V.extend: [ 'ничего' | 'все' | 'мин' | 'макс' ] Если это не 'ничего', уровни контура автоматически добавляются к одному или обоим концам диапазона, чтобы включить все данные. Эти добавленные диапазоны затем отображаются на специальные значения цветовой карты, которые по умолчанию находятся на концах диапазона цветовой карты, но могут быть установлены с помощью методов
matplotlib.colors.Colormap.set_under()иmatplotlib.colors.Colormap.set_over().xunits, yunits: [ None | зарегистрированные единицы ] Переопределяет единицы осей, задавая экземпляр
matplotlib.units.ConversionInterface.Только ключевые аргументы tricontour:
linewidths: [ None | число | кортеж чисел ] Если linewidths равно None, по умолчанию используется rc:
lines.linewidth.Если число, все уровни будут нарисованы с этой шириной линии.
Если кортеж, разные уровни будут нарисованы с разными ширинами линии в указанном порядке.
linestyles: [ None | 'сплошная' | 'штриховая' | 'пунктирная' | 'точечная' ] Если linestyles равно None, используется 'сплошная'.
linestyles также может быть итерируемым из вышеперечисленных строк, задающим набор стилей линий, которые будут использоваться. Если этот итерируемый короче, чем количество уровней контура, он будет повторяться по мере необходимости.
Если контур использует монохромную цветовую карту и уровень контура меньше 0, то будет использоваться стиль линии, указанный в
rcParams["contour.negative_linestyle"](по умолчанию: 'штриховая').Только ключевые аргументы tricontourf:
antialiased: bool включить сглаживаниеПримечание:
tricontourfзаполняет интервалы, которые закрыты сверху; то есть, для границ z1 и z2 заполненная область:z1 < Z <= z2
за исключением самого нижнего интервала, который закрыт с обеих сторон (т.е. он включает минимальное значение).
Примеры использования matplotlib.axes.Axes.tricontourf
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.2.2/api/_as_gen/matplotlib.axes.Axes.tricontourf.html