matplotlib.pyplot.tricontour
-
matplotlib.pyplot.tricontour(*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 будет создан. См.
Triangulationдля объяснения этих возможностей.Остальные аргументы могут быть:
tricontour(..., Z)
где Z — массив значений для контуров, по одному на точку в треугольной сетке. Значения уровня выбираются автоматически.
tricontour(..., Z, N)
контур 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 ]
- Экземпляр 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 указаны в вызове 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: [ True | False ]
- Включить сглаживание
Примечание: tricontourf заполняет интервалы, закрытые сверху; то есть для границ z1 и z2 заполненная область имеет вид:
z1 < z <= z2
Есть одно исключение: если нижняя граница совпадает с минимальным значением массива z, то это минимальное значение будет включено в нижний интервал.
Примеры использования matplotlib.pyplot.tricontour
© 2012–2017 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/2.1.0/api/_as_gen/matplotlib.pyplot.tricontour.html