contour

matplotlib.contour

Это классы для поддержки построения контуров и маркировки для класса Axes.

class matplotlib.contour.ClabelText(x=0, y=0, text='', color=None, verticalalignment='baseline', horizontalalignment='left', multialignment=None, fontproperties=None, rotation=None, linespacing=None, rotation_mode=None, usetex=None, wrap=False, **kwargs)

Базы: matplotlib.text.Text

В отличие от обычного текста, get_rotation возвращает обновленный угол в координатах пикселей, предполагая, что входной поворот — это угол в координатах данных (или любой установленной трансформации).

Создайте экземпляр Text в точке x, y со строкой text.

Допустимые значения kwargs:

Свойство	Описание
`agg_filter`	неизвестно
`alpha`	число с плавающей точкой (от 0.0 — прозрачный до 1.0 — непрозрачный)
`animated`	[True \| False]
`backgroundcolor`	любой цвет matplotlib
`bbox`	свойства FancyBboxPatch
`clip_box`	экземпляр `matplotlib.transforms.Bbox`
`clip_on`	[True \| False]
`clip_path`	[ (`Path`, `Transform`) \| `Patch` \| None ]
`color`	любой цвет matplotlib
`contains`	функция-вызов
`family` или fontfamily или fontname или name	[ШРИФТ \| ‘serif’ \| ‘sans-serif’ \| ‘cursive’ \| ‘fantasy’ \| ‘monospace’ ]
`figure`	экземпляр `matplotlib.figure.Figure`
`fontproperties` или font_properties	экземпляр `matplotlib.font_manager.FontProperties`
`gid`	строка идентификатора
`horizontalalignment` или ha	[ ‘center’ \| ‘right’ \| ‘left’ ]
`label`	строка или любой вывод с преобразованием ‘%s’
`linespacing`	число с плавающей точкой (кратное размеру шрифта)
`multialignment`	[‘left’ \| ‘right’ \| ‘center’ ]
`path_effects`	неизвестно
`picker`	[None\|число с плавающей точкой\|булево значение\|функция-вызов]
`position`	(x,y)
`rasterized`	[True \| False \| None]
`rotation`	[ угол в градусах \| ‘vertical’ \| ‘horizontal’ ]
`rotation_mode`	неизвестно
`size` или fontsize	[размер в пунктах \| ‘xx-small’ \| ‘x-small’ \| ‘small’ \| ‘medium’ \| ‘large’ \| ‘x-large’ \| ‘xx-large’ ]
`sketch_params`	неизвестно
`snap`	неизвестно
`stretch` или fontstretch	[числовое значение в диапазоне 0-1000 \| ‘ultra-condensed’ \| ‘extra-condensed’ \| ‘condensed’ \| ‘semi-condensed’ \| ‘normal’ \| ‘semi-expanded’ \| ‘expanded’ \| ‘extra-expanded’ \| ‘ultra-expanded’ ]
`style` или fontstyle	[ ‘normal’ \| ‘italic’ \| ‘oblique’]
`text`	строка или любой вывод с преобразованием ‘%s’
`transform`	экземпляр `Transform`
`url`	строка url
`usetex`	неизвестно
`variant` или fontvariant	[ ‘normal’ \| ‘small-caps’ ]
`verticalalignment` или ma или va	[ ‘center’ \| ‘top’ \| ‘bottom’ \| ‘baseline’ ]
`visible`	[True \| False]
`weight` или fontweight	[числовое значение в диапазоне 0-1000 \| ‘ultralight’ \| ‘light’ \| ‘normal’ \| ‘regular’ \| ‘book’ \| ‘medium’ \| ‘roman’ \| ‘semibold’ \| ‘demibold’ \| ‘demi’ \| ‘bold’ \| ‘heavy’ \| ‘extra bold’ \| ‘black’ ]
`wrap`	неизвестно
`x`	число с плавающей точкой
`y`	число с плавающей точкой
`zorder`	любое число

get_rotation()

class matplotlib.contour.ContourLabeler

Базы: object

Миксин для предоставления возможности маркировки ContourSet

add_label(x, y, rotation, lev, cvalue): Добавление метки контура с использованием класса Text.

add_label_clabeltext(x, y, rotation, lev, cvalue): Добавление метки контура с использованием класса ClabelText.

add_label_near(x, y, inline=True, inline_spacing=5, transform=None)

Добавление метки вблизи точки (x, y). Если transform равно None (по умолчанию), (x, y) находится в координатах данных; если transform равно False, (x, y) находится в координатах отображения; в противном случае, указанное преобразование будет использовано для перевода (x, y) в координаты отображения.

inline:: управляет удалением базового контура или нет. По умолчанию — True.
inline_spacing:: пробел в пикселях, оставляемый по обеим сторонам метки при размещении в строке. По умолчанию 5. Этот интервал будет точным для меток в местах, где контур прямой, и менее точным для меток на кривых контурах.

calc_label_rot_and_inline(slc, ind, lw, lc=None, spacing=5)

Эта функция вычисляет подходящее вращение метки, учитывая координаты линии контура в единицах экрана, индекс местоположения метки и ширину метки.

Она также разделит контур и вычислит выравнивание, если lc не пустое (lc по умолчанию — пустой список, если None). spacing — это расстояние вокруг метки в пикселях, которое следует оставить пустым.

Выполнение обеих задач одновременно, чтобы избежать многократного вызова mlab.path_length, что относительно дорого.

Здесь используется метод, включающий вычисление длины пути по контуру в пиксельных координатах, а затем приблизительное определение расстояния label width / 2 от центральной точки для определения поворота и, в случае необходимости, разделения контура.

clabel(*args, **kwargs)

Маркировка графика контуров.

Вызов:

clabel(cs, **kwargs)

Добавляет метки к линиям контуров в cs, где cs — объект ContourSet, возвращаемый функцией contour.

clabel(cs, v, **kwargs)

метят только контуры, перечисленные в v.

Необязательные ключевые параметры:

fontsize:

размер в пунктах или относительный размер, например, ‘smaller’, ‘x-large’

colors:

если None, цвет каждой метки соответствует цвету соответствующего контура
если одна строка цвета, например, colors = ‘r’ или colors = ‘red’, все метки будут нарисованы этим цветом
если кортеж из аргументов цвета matplotlib (строка, число, rgb и т. д.), разные метки будут нарисованы разными цветами в указанном порядке

inline:

управляет удалением базового контура или нет. По умолчанию — True.

inline_spacing:

пробел в пикселях, оставляемый по обеим сторонам метки при размещении в строке. По умолчанию 5. Этот интервал будет точным для меток в местах, где контур прямой, и менее точным для меток на кривых контурах.

fmt:

строковый формат для метки. По умолчанию — ‘%1.3f’. Также может быть словарем, сопоставляющим уровни контура произвольным строкам для каждого уровня контура (т. е., fmt[level]=string), или любым вызываемым объектом, например, экземпляром Formatter, который возвращает строку при вызове с числовым уровнем контура.

manual:

если True, метки контуров будут размещены вручную с помощью щелчков мыши. Щелкните левой кнопкой мыши вблизи контура, чтобы добавить метку, щелкните правой кнопкой мыши (или, возможно, обеими кнопками мыши одновременно), чтобы закончить добавление меток. Третья кнопка может использоваться для удаления последней добавленной метки, но только если метки не находятся в строке. В качестве альтернативы, можно использовать клавиатуру для выбора расположения меток (ввод для завершения размещения меток, удаление или Backspace действуют как третья кнопка мыши, а любая другая клавиша выберет местоположение метки).

manual может быть итерируемым объектом кортежей x,y. Метки контуров будут созданы так, как будто мышь щелкает в каждой позиции x,y.

rightside_up:

если True (по умолчанию), повороты меток всегда будут плюс или минус 90 градусов от уровня.

use_clabeltext:

если True (по умолчанию False), используется класс ClabelText (вместо matplotlib.Text) для создания меток. ClabelText пересчитывает углы поворота текстов во время рисования, поэтому это может быть полезно, если вид оси изменится.

get_label_coords(distances, XX, YY, ysize, lw)

Возвращает x, y и индекс местоположения метки.

Метки отображаются в позиции с наименьшим отклонением контура от прямой линии, если рядом нет другой метки, в этом случае выбирается следующее лучшее место на контуре. Если все такие кандидаты отклонены, выбирается начало контура.

get_label_width(lev, fmt, fsize): Возвращает ширину метки в пунктах.

get_real_label_width(lev, fmt, fsize)

Вычисляет фактическую ширину метки на экране. Это использует некоторую магию, чтобы определить видимый размер метки, которая не была нарисована. Эта магия может быть не очень надежной.

Этот метод не используется и может быть изменён или удалён.

get_text(lev, fmt): Получить текст метки

labels(inline, inline_spacing)

locate_label(linecontour, labelwidth): Находит хорошее место для размещения метки (относительно плоская часть контура).

pop_label(index=-1): По умолчанию удаляется последняя метка, но можно указать любой индекс

print_label(linecontour, labelwidth): Возвращает False, если контуры слишком короткие для метки.

set_label_props(label, text, color): установить свойства метки — цвет, размер шрифта, текст

too_close(x, y, lw): Возвращает True, если метка уже находится вблизи этого местоположения.

class matplotlib.contour.ContourSet(ax, *args, **kwargs)

Основы: matplotlib.cm.ScalarMappable, matplotlib.contour.ContourLabeler

Хранение набора контурных линий или заполненных областей.

Метод, вызываемый пользователем: clabel

Полезные атрибуты:

ax:: Объект осей, на котором отображаются контуры
collections:: список LineCollections или PolyCollections
levels:: уровни контуров
layers:: то же, что и уровни для линий контуров; половина пути между уровнями для заполненных контуров. См. _process_colors().

Отображение контурных линий или заполненных областей в зависимости от того, является ли ключевое слово ‘filled’ False (по умолчанию) или True.

Первые три аргумента должны быть:

ax: объект осей.

levels: [level0, level1, …, leveln]

Список чисел с плавающей запятой, указывающий уровни контуров.

allsegs: [level0segs, level1segs, …]

Список всех сегментов многоугольников для всех levels. Для контурных линий len(allsegs) == len(levels), а для заполненных контурных областей len(allsegs) = len(levels)-1.

level0segs = [polygon0, polygon1, …]

polygon0 = массив [[x0,y0], [x1,y1], …]

allkinds: None или [level0kinds, level1kinds, …]

Необязательный список всех типов вершин многоугольников (коды типов), как описано и используется в Path. Это используется для разрешения многосвязных путей, таких как отверстия внутри заполненных многоугольников. Если не None, len(allkinds) == len(allsegs).

level0kinds = [polygon0kinds, …]

polygon0kinds = [vertexcode0, vertexcode1, …]

Если allkinds не None, обычно все многоугольники для определенного уровня контура группируются вместе, так что

level0segs = [polygon0] и level0kinds = [polygon0kinds].

Ключевые аргументы описаны в matplotlib.contour.QuadContourSet.contour_doc.

changed()

find_nearest_contour(x, y, indices=None, pixel=True)

Находит контур, наиболее близкий к точке. По умолчанию измеряет расстояние в пикселях (пространство экрана - полезно для ручного маркирования контуров), но это можно контролировать с помощью ключевого аргумента.

Возвращает кортеж, содержащий контур, сегмент, индекс сегмента, x и y точки сегмента и расстояние до минимальной точки.

Необязательные ключевые аргументы:

indices:: Индексы уровней контуров, которые следует учитывать при поиске ближайшей точки. По умолчанию используются все уровни.
pixel:: Если True, измеряет расстояние в пространстве пикселей, в противном случае - в пространстве осей. По умолчанию True.

get_alpha(): возвращает альфа-значение, которое будет применено ко всем элементам ContourSet

get_transform(): Возвращает экземпляр Transform, используемый этим ContourSet.

legend_elements(variable_name='x', str_format=<class 'str'>)

Возвращает список элементов художников и меток, подходящих для передачи в plt.legend(), которые представляют этот ContourSet.

Аргументы:

variable_name: строка, используемая внутри неравенства, используемого: на метках

str_format: функция, используемая для форматирования чисел в метках

set_alpha(alpha): устанавливает альфа-значение для всех элементов ContourSet

vmax

vmin

class matplotlib.contour.QuadContourSet(ax, *args, **kwargs)

Основы: matplotlib.contour.ContourSet

Создаёт и хранит набор контурных линий или заполненных областей.

Метод, вызываемый пользователем: clabel()