Spec-Zone.ru › Matplotlib 2.1

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

../../_images/sphx_glr_tricontour_vs_griddata_thumb.png

Tricontour Vs Griddata

../../_images/sphx_glr_tricontour_smooth_user_thumb.png

Tricontour Smooth User

../../_images/sphx_glr_tricontour_demo_thumb.png

Tricontour Demo

../../_images/sphx_glr_tricontour_smooth_delaunay_thumb.png

Tricontour Smooth Delaunay

../../_images/sphx_glr_tricontour_vs_griddata_thumb.png

Сравнение griddata и триконтур для неструктурированной треугольной сетки

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API