matplotlib.axes.Axes.tricontourf
-
Axes.tricontourf(*args, **kwargs)[source] -
Отображение контуров на неструктурированной треугольной сетке.
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. См.
Triangulationдля объяснения этих возможностей.Остальные аргументы могут быть:
tricontour(..., Z)
где Z — массив значений для контура, по одному значению на точку в треугольной сетке. Значения уровней выбираются автоматически.
tricontour(..., Z, N)
строит контур до N+1 автоматически выбранных уровней контура (N интервалов).
tricontour(..., Z, V)
рисует линии контура по заданным значениям в последовательности V, которая должна быть отсортирована по возрастанию.
tricontourf(..., Z, V)
закрашивает (len(V)-1) регионов между значениями в V, которые должны быть отсортированы по возрастанию.
tricontour(Z, **kwargs)
Используйте ключевые аргументы для управления цветами, шириной линий, началом координат, цветовой палитрой ... см. ниже для получения более подробной информации.
C = tricontour(...)возвращает объектTriContourSet.Необязательные ключевые аргументы:
colors: [ None | строка | (mpl_colors) ] Если None, используется цветовая палитра, указанная в cmap.
Если строка, например, 'r' или 'red', все уровни будут нарисованы этим цветом.
Если кортеж из аргументов цвета matplotlib (строка, число, RGB и т. д.), разные уровни будут нарисованы разными цветами в указанном порядке.
alpha: число Значение прозрачности смешивания
cmap: [ None | Colormap ] Экземпляр
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 указаны в вызове contour.
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 указаны в вызове contour.
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, используется ширина по умолчанию в
lines.linewidthвmatplotlibrc.Если число, все уровни будут нарисованы с этой шириной линии.
Если кортеж, разные уровни будут нарисованы с разной шириной линий в указанном порядке.
linestyles: [ None | 'сплошная' | 'штриховая' | 'штрихпунктирная' | 'пунктирная' ] Если linestyles равно None, используется 'сплошная'.
linestyles также может быть итерируемым списком вышеуказанных строк, определяющим набор стилей линий, которые будут использоваться. Если этот итерируемый список короче, чем количество уровней контура, он будет повторяться по мере необходимости.
Если контур использует монохромную цветовую палитру и уровень контура меньше 0, то будет использоваться стиль линии, указанный в
contour.negative_linestyleвmatplotlibrc.Ключевые аргументы только для tricontourf:
antialiased: bool включить сглаживаниеПримечание: tricontourf заполняет интервалы, которые закрыты сверху; то есть, для границ z1 и z2, заполненная область:
z1 < z <= z2
Есть одно исключение: если нижняя граница совпадает с минимальным значением массива z, то это минимальное значение будет включено в самый нижний интервал.
Примеры использования matplotlib.axes.Axes.tricontourf
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/_as_gen/matplotlib.axes.Axes.tricontourf.html